Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Recuperar registros de memoria
Puede recuperar las memorias extraídas mediante la RetrieveMemoryRecords API. Esta operación le permite buscar registros de memoria extraídos en función de consultas semánticas, lo que facilita la búsqueda de información relevante en la memoria de su agente.
Parámetros necesarios
La RetrieveMemoryRecords operación requiere los siguientes parámetros clave:
- ID de memoria
-
El identificador del recurso de memoria que contiene los registros que desea recuperar.
- namespace
-
El espacio de nombres exacto en el que se almacenan los registros de memoria. La operación devuelve registros de memoria paginados en espacios de nombres que coinciden con el espacio de nombres proporcionado.
- NamespacePath
-
La ruta del espacio de nombres donde se almacenan los registros de memoria. La operación devuelve registros de memoria paginados en la jerarquía de espacios de nombres proporcionada que comienzan por la ruta proporcionada.
- Criterios de búsqueda
-
Una estructura que contiene los parámetros de búsqueda:
-
SearchQuery: el texto de la consulta semántica que se utiliza para encontrar recuerdos relevantes (hasta 10 000 caracteres).
-
memoria StrategyId (opcional): limita la búsqueda a los recuerdos creados mediante una estrategia específica.
-
TopK: el número máximo de resultados más relevantes que se pueden devolver (predeterminado: 10, máximo: 100).
-
Formato de las respuestas
La operación devuelve una lista de resúmenes de registros de memoria que coinciden con los criterios de búsqueda. Cada resumen incluye una puntuación de relevancia, que se deriva de la similitud entre cosenos de los vectores de incrustación. Esta puntuación no representa una coincidencia porcentual, sino que mide qué tan cerca se alinean dos vectores en un espacio de alta dimensión. Las puntuaciones más altas indican una mayor relevancia del registro de memoria para la consulta de búsqueda. Los resultados están paginados, con un máximo predeterminado de 100 resultados por página. Puede usar el nextToken parámetro para recuperar páginas adicionales de resultados.
Prácticas recomendadas
Al recuperar recuerdos, tenga en cuenta las siguientes prácticas recomendadas:
-
Crea consultas de búsqueda específicas que describan claramente la información que estás buscando.
-
Usa el
topKparámetro para controlar la cantidad de resultados en función de las necesidades de tu aplicación. -
Cuando trabaje con memorias de gran tamaño, implemente la paginación para procesar de manera eficiente todos los resultados relevantes.
-
Considera la posibilidad de filtrar por
memoryStrategyIdcuándo necesites recuerdos de una estrategia de extracción específica.
Una vez recuperados, estos registros de memoria se pueden incorporar al contexto de su agente, lo que permite obtener respuestas más personalizadas y sensibles al contexto.
