Speicherdatensätze abrufen
Sie können extrahierte Erinnerungen mithilfe der RetrieveMemoryRecordsAPI abrufen. Mit diesem Vorgang können Sie extrahierte Speicherdatensätze auf der Grundlage semantischer Abfragen durchsuchen, sodass Sie auf einfache Weise relevante Informationen aus dem Speicher Ihres Agenten finden können.
Erforderliche Parameter
Für den RetrieveMemoryRecords Vorgang sind die folgenden Schlüsselparameter erforderlich:
- Memory-ID
-
Der Bezeichner der Speicherressource, die die Datensätze enthält, die Sie abrufen möchten.
- Namespace
-
Der genaue Namespace, in dem die Speicherdatensätze gespeichert sind. Die Operation gibt paginierte Speicherdatensätze in Namespaces zurück, die dem angegebenen Namespace entsprechen.
- NamespacePath
-
Der Namespace-Pfad, in dem die Speicherdatensätze gespeichert sind. Der Vorgang gibt paginierte Speicherdatensätze unter der angegebenen Namespace-Hierarchie zurück, die mit dem angegebenen Pfad beginnen.
- Suchkriterien
-
Eine Struktur, die Suchparameter enthält:
-
searchQuery — Der semantische Abfragetext, der verwendet wird, um relevante Erinnerungen zu finden (bis zu 10.000 Zeichen).
-
memory StrategyId (optional) — Beschränkt die Suche auf Erinnerungen, die durch eine bestimmte Strategie erstellt wurden.
-
TopK — Die maximale Anzahl der relevantesten Ergebnisse, die zurückgegeben werden sollen (Standard: 10, Maximum: 100).
-
Reaktionsformat
Der Vorgang gibt eine Liste von Zusammenfassungen von Speicherdatensätzen zurück, die Ihren Suchkriterien entsprechen. Jede Zusammenfassung enthält einen Relevanzwert, der aus der Kosinusähnlichkeit von Einbettungsvektoren abgeleitet wird. Dieser Wert stellt keine prozentuale Übereinstimmung dar, sondern misst stattdessen, wie eng zwei Vektoren in einem hochdimensionalen Raum aufeinander abgestimmt sind. Höhere Werte weisen auf eine größere Relevanz des Speicherdatensatzes für die Suchabfrage hin. Die Ergebnisse sind paginiert, wobei standardmäßig maximal 100 Ergebnisse pro Seite angezeigt werden. Sie können den nextToken Parameter verwenden, um weitere Ergebnisseiten abzurufen.
Bewährte Methoden
Beachten Sie beim Abrufen von Erinnerungen die folgenden bewährten Methoden:
-
Formulieren Sie spezifische Suchanfragen, die die Informationen, nach denen Sie suchen, klar beschreiben.
-
Verwenden Sie den
topKParameter, um die Anzahl der Ergebnisse entsprechend den Anforderungen Ihrer Anwendung zu steuern. -
Wenn Sie mit großen Speichern arbeiten, sollten Sie die Paginierung implementieren, um alle relevanten Ergebnisse effizient zu verarbeiten.
-
Erwägen Sie, danach zu filtern
memoryStrategyId, wann Sie Speicher aus einer bestimmten Extraktionsstrategie benötigen.
Nach dem Abrufen können diese Speicherdatensätze in den Kontext Ihres Agenten integriert werden, sodass personalisiertere und kontextsensivere Antworten möglich sind.
