Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Recupera i record di memoria
È possibile recuperare le memorie estratte utilizzando l'API. RetrieveMemoryRecords Questa operazione consente di cercare i record di memoria estratti in base a query semantiche, semplificando 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 i 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).
-
memoria StrategyId (opzionale): limita la ricerca ai ricordi creati da una strategia specifica.
-
TopK: il numero massimo di risultati più pertinenti da restituire (predefinito: 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, derivato dalla somiglianza del coseno dei vettori incorporati. Questo punteggio non rappresenta una corrispondenza percentuale, ma misura invece il grado di allineamento di due vettori in uno spazio ad alta dimensione. I punteggi più alti indicano una maggiore pertinenza del record di memoria rispetto alla 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 recuperi i ricordi, considera le seguenti best practice:
-
Crea query di ricerca specifiche che descrivano chiaramente le informazioni che stai cercando.
-
Usa il
topKparametro per controllare il numero di risultati in base alle esigenze della tua applicazione. -
Quando lavorate con memorie di grandi dimensioni, implementate l'impaginazione per elaborare in modo efficiente tutti i risultati pertinenti.
-
Valuta la possibilità di filtrare in base a
memoryStrategyIdquando ti servono le memorie di 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.
