# Recupera i record di memoria
<a name="long-term-retrieve-records"></a>

È possibile recuperare le memorie estratte utilizzando l'API. [RetrieveMemoryRecords](https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_RetrieveMemoryRecords.html) 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
<a name="retrieve-records-parameters"></a>

L'`RetrieveMemoryRecords`operazione 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
<a name="retrieve-records-response"></a>

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
<a name="retrieve-records-best-practices"></a>

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 `topK` parametro 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 `memoryStrategyId` quando 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.