# Recuperar registros de memória
<a name="long-term-retrieve-records"></a>

Você pode recuperar as memórias extraídas usando a [RetrieveMemoryRecords](https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_RetrieveMemoryRecords.html)API. Essa operação permite pesquisar registros de memória extraídos com base em consultas semânticas, facilitando a localização de informações relevantes na memória do seu agente.

## Parâmetros necessários
<a name="retrieve-records-parameters"></a>

A `RetrieveMemoryRecords` operação requer os seguintes parâmetros principais:

 **ID de memória**   
O identificador do recurso de memória que contém os registros que você deseja recuperar.

 **namespace**   
O namespace exato em que os registros de memória são armazenados. A operação retorna registros de memória paginados em namespaces que coincidem com o namespace fornecido.

 **Caminho do namespace**   
O caminho do namespace de onde os registros de memória são armazenados. A operação retorna registros de memória paginados na hierarquia de namespaces fornecida que começam com o caminho fornecido.

 **Critérios de pesquisa**   
Uma estrutura contendo parâmetros de pesquisa:  
+  *SearchQuery* - O texto da consulta semântica usado para encontrar memórias relevantes (até 10.000 caracteres).
+  *memória StrategyId* (opcional) - Limita a pesquisa às memórias criadas por uma estratégia específica.
+  *TopK* - O número máximo dos resultados mais relevantes a serem retornados (padrão: 10, máximo: 100).

## Formato de resposta
<a name="retrieve-records-response"></a>

A operação retorna uma lista de resumos de registros de memória que correspondem aos seus critérios de pesquisa. Cada resumo inclui uma *pontuação de relevância*, que é derivada da similaridade do cosseno dos vetores de incorporação. Essa pontuação **não** representa uma correspondência percentual, mas mede o quão próximos dois vetores se alinham em um espaço de alta dimensão. Pontuações mais altas indicam maior relevância do registro de memória para a consulta de pesquisa. Os resultados são paginados, com um máximo padrão de 100 resultados por página. Você pode usar o `nextToken` parâmetro para recuperar páginas adicionais de resultados.

## Práticas recomendadas
<a name="retrieve-records-best-practices"></a>

Ao recuperar memórias, considere as seguintes práticas recomendadas:
+ Crie consultas de pesquisa específicas que descrevam claramente as informações que você está procurando.
+ Use o `topK` parâmetro para controlar o número de resultados com base nas necessidades do seu aplicativo.
+ Ao trabalhar com memórias grandes, implemente a paginação para processar com eficiência todos os resultados relevantes.
+ Considere filtrar por `memoryStrategyId` quando precisar de memórias de uma estratégia de extração específica.

Depois de recuperados, esses registros de memória podem ser incorporados ao contexto do seu agente, permitindo respostas mais personalizadas e contextualmente conscientes.