Recupera i record di memoria
È possibile recuperare le memorie estratte utilizzando l'API. RetrieveMemoryRecords Questa operazione consente di cercare i record di memoria estratti sulla base di interrogazioni semantiche, facilitando la ricerca di informazioni pertinenti dalla memoria dell'agente.
Parametri obbligatori
L'RetrieveMemoryRecordsoperazione richiede i seguenti parametri chiave:
- ID di memoria
-
L'identificatore della risorsa di memoria contenente i record che si desidera recuperare.
- spazio dei nomi
-
Lo spazio dei nomi esatto in cui sono archiviati i record di memoria. L'operazione restituisce record di memoria impaginati in namespace che corrispondono allo spazio dei nomi fornito.
- NamespacePath
-
Il percorso dello spazio dei nomi in cui sono archiviati i record di memoria. L'operazione restituisce record di memoria impaginati nella gerarchia dei namespace fornita che iniziano con il percorso fornito.
- Criteri di ricerca
-
Una struttura contenente i parametri di ricerca:
-
SearchQuery: il testo della query semantica utilizzato per trovare le memorie pertinenti (fino a 10.000 caratteri).
-
memory StrategyId (opzionale): limita la ricerca ai ricordi creati da una strategia specifica.
-
topK: il numero massimo di risultati più pertinenti da restituire (impostazione predefinita: 10, massimo: 100).
-
Formato della risposta
L'operazione restituisce un elenco di riepiloghi dei record di memoria che corrispondono ai criteri di ricerca. Ogni riepilogo include un punteggio di pertinenza, che deriva dalla somiglianza coseno dei vettori di incorporamento. Questo punteggio non rappresenta una corrispondenza percentuale, ma misura invece quanto strettamente due vettori si allineano in uno spazio ad alta dimensione. I punteggi più alti indicano una maggiore rilevanza del record di memoria per la query di ricerca. I risultati sono suddivisi in pagine, con un massimo predefinito di 100 risultati per pagina. È possibile utilizzare il nextToken parametro per recuperare pagine aggiuntive di risultati.
Best practice
Quando recuperate le memorie, prendete in considerazione le seguenti best practice:
-
Crea query di ricerca specifiche che descrivano chiaramente le informazioni che stai cercando.
-
Utilizza il
topKparametro per controllare il numero di risultati in base alle esigenze dell'applicazione. -
Quando lavori con memorie di grandi dimensioni, implementa l'impaginazione per elaborare in modo efficiente tutti i risultati pertinenti.
-
Valuta la possibilità di filtrare in base a
memoryStrategyIdquando hai bisogno di memorie provenienti da una strategia di estrazione specifica.
Una volta recuperati, questi record di memoria possono essere incorporati nel contesto dell'agente, consentendo risposte più personalizzate e contestualmente consapevoli.
