As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Habilitar a memória do agente
<a name="agents-configure-memory"></a>

Para configurar a memória do agente, você deve primeiro habilitar a memória e, opcionalmente, especificar o período de retenção da memória. É possível habilitar a memória para o agente ao [criar](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html) ou [atualizar](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit) o agente. 

**nota**  
Você pode habilitar a memória para agentes em todos os modelos, *exceto* nos seguintes:   
Amazon Titan Text Premier
Anthropic Claude Instant
Verifique se o modelo que está pretendendo usar está disponível na sua região. Para obter mais informações, consulte [Suporte de modelo por Região da AWS.](https://docs.aws.amazon.com//bedrock/latest/userguide/models-supported.html)

Para saber como configurar a memória do agente, selecione a guia correspondente ao método de sua escolha e siga as etapas.

------
#### [ Console ]

**Como configurar a memória do agente**

1. Se você ainda não estiver no Construtor de agentes, faça o seguinte:

   1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

   1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.

   1. Escolha **Editar no Construtor de agentes**

1. Na seção “Detalhes do agente”, escolha **Selecionar modelo**.

1. Na seção **Memória**, faça o seguinte:

   1. Em **Ativar resumo da sessão**, selecione **Habilitado**.

   1. (Opcional) Em **Duração da memória**, insira um número de 1 a 365 para especificar a duração da memória do agente. Por padrão, o agente retém o contexto conversacional por trinta dias. 

   1. Em **Número máximo de sessões recentes**, selecione um número para o número máximo de sessões recentes a serem armazenadas como memória.

   1. (Opcional) Se quiser, você pode fazer alterações no prompt de resumo da sessão. Para fazer alterações, no **prompt de resumo da sessão**, escolha **Visualizar e editar**.

1. Primeiro clique em **Salvar** e em **Preparar** para aplicar as alterações feitas no agente antes de testá-lo. 

------
#### [ API ]

Para habilitar e configurar a memória para seu agente, envie uma [UpdateAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgent.html)solicitação [CreateAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgent.html)ou com um endpoint de tempo de [construção do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

Na API do Amazon Bedrock, você especifica `memoryConfiguration` quando envia uma [UpdateAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgent.html)solicitação [CreateAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgent.html)ou. 

Veja o formato geral da `memoryConfiguration`: 

```
"memoryConfiguration": {
"enabledMemoryTypes": [ "SESSION_SUMMARY" ],
"storageDays":{{30}},
"sessionSummaryConfiguration": {
    "maxRecentSessions": {{5}}
    }
}
```

Opcionalmente, é possível configurar o período de retenção de memória atribuindo um número entre 1 e 365 dias a `storageDays`.

**nota**  
Se você habilitar a memória do agente e não especificar o `memoryId` ao invocar o agente, o agente não armazenará esse turno específico na memória.

------