Recuperar registros de memoria
Puede recuperar las memorias extraídas mediante la RetrieveMemoryRecordsAPI. 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 los registros de memoria paginados en espacios de nombres que coinciden con el espacio de nombres proporcionado.
- Ruta del espacio de nombres
-
La ruta del espacio de nombres donde se almacenan los registros de memoria. La operación devuelve los registros de memoria paginados según la jerarquía de espacios de nombres proporcionada que comienzan con la ruta proporcionada.
- Criterios de búsqueda
-
Estructura que contiene los parámetros de búsqueda:
-
SearchQuery: el texto de 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 los cosenos de los vectores de incrustación. Esta puntuación no representa un porcentaje de coincidencia, 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 utilizar 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:
-
Elabora consultas de búsqueda específicas que describan claramente la información que estás buscando.
-
Utilice el
topKparámetro para controlar la cantidad de resultados en función de las necesidades de su aplicación. -
Cuando trabaje con memorias de gran tamaño, implemente la paginación para procesar de manera eficiente todos los resultados relevantes.
-
Considere la posibilidad de filtrar por
memoryStrategyIdcuando necesite 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.
