Recuperar registros de memória
Você pode recuperar as memórias extraídas usando a RetrieveMemoryRecordsAPI. 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 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 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
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
topKparâ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
memoryStrategyIdquando 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.
