Récupérez des enregistrements de mémoire
Vous pouvez récupérer des souvenirs extraits à l'aide de l'RetrieveMemoryRecordsAPI. Cette opération vous permet de rechercher des enregistrements de mémoire extraits sur la base de requêtes sémantiques, ce qui facilite la recherche d'informations pertinentes dans la mémoire de votre agent.
Paramètres requis
L'RetrieveMemoryRecordsopération nécessite les paramètres clés suivants :
- ID de mémoire
-
Identifiant de la ressource mémoire contenant les enregistrements que vous souhaitez récupérer.
- espace de nom
-
L'espace de noms exact dans lequel les enregistrements de mémoire sont stockés. L'opération renvoie des enregistrements de mémoire paginés dans des espaces de noms qui correspondent à l'espace de noms fourni.
- NameSpacePath
-
Le chemin de l'espace de noms dans lequel les enregistrements de mémoire sont stockés. L'opération renvoie des enregistrements de mémoire paginés sous la hiérarchie des espaces de noms fournie qui commencent par le chemin fourni.
- Critères de recherche
-
Structure contenant les paramètres de recherche :
-
SearchQuery : texte de requête sémantique utilisé pour trouver des souvenirs pertinents (jusqu'à 10 000 caractères).
-
mémoire StrategyId (facultatif) - Limite la recherche aux souvenirs créés par une stratégie spécifique.
-
TopK - Le nombre maximum de résultats les plus pertinents à renvoyer (par défaut : 10, maximum : 100).
-
Format de la réponse
L'opération renvoie une liste de résumés d'enregistrements de mémoire correspondant à vos critères de recherche. Chaque résumé inclut un score de pertinence, qui est dérivé de la similitude en cosinus des vecteurs d'intégration. Ce score ne représente pas un pourcentage de correspondance, mais mesure le degré d'alignement de deux vecteurs dans un espace de grande dimension. Des scores plus élevés indiquent une plus grande pertinence de l'enregistrement en mémoire par rapport à la requête de recherche. Les résultats sont paginés, avec un maximum de 100 résultats par page par défaut. Vous pouvez utiliser le nextToken paramètre pour récupérer des pages de résultats supplémentaires.
Bonnes pratiques
Lorsque vous récupérez des souvenirs, tenez compte des meilleures pratiques suivantes :
-
Créez des requêtes de recherche spécifiques qui décrivent clairement les informations que vous recherchez.
-
Utilisez le
topKparamètre pour contrôler le nombre de résultats en fonction des besoins de votre application. -
Lorsque vous travaillez avec de grandes mémoires, implémentez la pagination pour traiter efficacement tous les résultats pertinents.
-
Envisagez de filtrer en
memoryStrategyIdfonction des moments où vous avez besoin de souvenirs issus d'une stratégie d'extraction spécifique.
Une fois récupérés, ces enregistrements de mémoire peuvent être intégrés au contexte de votre agent, permettant ainsi des réponses plus personnalisées et adaptées au contexte.
