Gerenciar a memória do agente

O recurso Memory for Agents está na versão prévia do Amazon Bedrock e está sujeito a alterações.

Depois de habilitar a memória para seu agente, você pode visualizar as sessões armazenadas na memória ou excluir todas as sessões da memória.

Exibir sessões de memória

O agente armazena a memória de cada sessão em relação ao identificador de memória exclusivo (memoryId) fornecido para cada usuário quando você invoca o agente. Na próxima vez que você invocar o agente com o mesmomemoryId, toda a memória será carregada na sessão. Depois que você encerra a sessão, o agente gera uma versão resumida da sessão e armazena o resumo da sessão.

nota

Após o término da sessão, os resumos da sessão podem levar alguns minutos para que apareçam no console ou na resposta da API.

Para saber como visualizar os resumos das sessões, selecione a guia correspondente ao seu método de escolha e siga as etapas.

Console

Para ver os resumos das sessões,

1. Faça login na função AWS Management Console usando uma função do IAM com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em https://console.aws.amazon.com/bedrock/.

2. Selecione Agentes no painel de navegação esquerdo. Em seguida, escolha um agente na seção Agentes.

3. Na janela Teste, escolha o ícone de expansão e escolha a guia Memória.

   Se você estiver na página Agent Builder, na seção Memória, escolha Exibir memória.

4. Você também pode visualizar as sessões de memória ao testar seu agente. Para visualizar as sessões armazenadas na memória durante o teste,

   1. Na janela de teste, escolha Mostrar rastreamento e, em seguida, escolha a guia Memória.

      nota

      Se você estiver visualizando sessões de memória ao testar seu agente, poderá visualizar o resumo da sessão somente após o término da última sessão. Se você tentar visualizar as sessões de memória quando a sessão atual estiver em andamento, você será informado de que o resumo da sessão está sendo gerado e levará algum tempo para gerar as sessões. Você pode forçar o encerramento da sessão atual escolhendo o ícone da vassoura.

API

Para visualizar as sessões de memória do seu agente, envie uma GetAgentMemorysolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock.

Os campos a seguir são obrigatórios:

Campo	Descrição breve
agentId	O identificador do agente
agentAliasId	O identificador do alias do agente
ID de memória	O identificador da memória que contém os resumos da sessão
Tipo de memória	O tipo de memória. Valor válido: SESSION_SUMMARY

nota

Se você estiver visualizando sessões de memória ao testar seu agente, poderá visualizar o resumo da sessão somente após o término da última sessão. Se você tentar visualizar as sessões de memória quando a sessão atual estiver em andamento, você será informado de que o resumo da sessão está sendo gerado e levará algum tempo para gerar as sessões. Você pode forçar o encerramento da sessão atual enviando uma InvokeAgentsolicitação e especificando Y o endSession campo.

Excluir resumos da sessão do alias

Para saber como excluir os resumos da sessão, selecione a guia correspondente ao seu método de escolha e siga as etapas.

Console

Para excluir resumos da sessão,

1. Faça login na função AWS Management Console usando uma função do IAM com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em https://console.aws.amazon.com/bedrock/.

2. Selecione Agentes no painel de navegação esquerdo. Em seguida, escolha um agente na seção Agentes.

3. Escolha Editar no Agent Builder

4. Na seção Memória, escolha Exibir memória e escolha a guia Memória.

5. Para escolher os resumos da sessão que você deseja excluir,

   1. Em Localizar sessões de memória, selecione o filtro que você deseja usar para pesquisar os resumos das sessões que você deseja excluir.

   2. Especifique os critérios do filtro.

6. Escolha Excluir memória de alias e, em seguida, escolha Excluir.

API

Para excluir resumos da sessão, envie uma DeleteAgentMemorysolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock.

Os campos a seguir são obrigatórios:

Campo	Descrição breve
agentId	O identificador do agente.
agentAliasId	O identificador do alias do agente.

O campo a seguir é opcional.

Campo	Descrição breve
ID de memória	O identificador da memória que contém os resumos da sessão

Desative a memória do seu agente Amazon Bedrock

Você pode desativar a memória do seu agente a qualquer momento. Você não pode acessar as sessões de memória depois de desativar a memória do seu agente.

nota

Se você ativar a memória para o agente e não especificar memoryId quando invocar o agente, o agente não armazenará esse turno específico na memória.

Para saber como desativar a memória, selecione a guia correspondente ao seu método preferido e siga as etapas.

Console

Para desativar a memória do seu agente,

1. Faça login na função AWS Management Console usando uma função do IAM com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em https://console.aws.amazon.com/bedrock/.

2. Selecione Agentes no painel de navegação esquerdo. Em seguida, escolha um agente na seção Agentes.

3. Escolha Editar no Agent Builder

4. Na seção Memória, escolha Desativar.

API

Para desativar a memória, envie uma UpdateAgentsolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock. Envie a solicitação sem especificar a memoryConfiguration estrutura. Isso desassociará a memória do agente.