# メモリレコードを取得する
<a name="long-term-retrieve-records"></a>

抽出されたメモリは、[RetrieveMemoryRecords](https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_RetrieveMemoryRecords.html) API を使用して取得できます。このオペレーションでは、セマンティッククエリに基づいて抽出されたメモリレコードを検索できるため、エージェントのメモリから関連情報を簡単に見つけることができます。

## 必須パラメータ
<a name="retrieve-records-parameters"></a>

`RetrieveMemoryRecords` オペレーションには、次のキーパラメータが必要です。

 **memoryId**   
取得するレコードを含むメモリリソースの識別子。

 **名前空間**   
メモリレコードが保存される正確な名前空間。オペレーションは、指定された名前空間に一致する名前空間にページ分割されたメモリレコードを返します。

 **namespacePath**   
メモリレコードが保存される の名前空間パス。オペレーションは、指定されたパスで始まる指定された名前空間階層の下にページ分割されたメモリレコードを返します。

 **searchCriteria**   
検索パラメータを含む構造:  
+  *searchQuery* - 関連する記憶を見つけるために使用されるセマンティッククエリテキスト (最大 10,000 文字）。
+  *memoryStrategyId* (オプション) - 検索を特定の戦略によって作成された思い出に制限します。
+  *topK* - 返される最も関連性の高い結果の最大数 (デフォルト: 10、最大: 100)。

## レスポンスの形式
<a name="retrieve-records-response"></a>

オペレーションは、検索条件に一致するメモリレコードの概要のリストを返します。各概要には関連性*スコア* が含まれており、これは埋め込みベクトルのコサイン類似度から算出されます。このスコアは一致率を表す**のではなく**、代わりに 2 つのベクトルが高次元空間でどの程度近いかを測定します。スコアが高いほど、メモリレコードと検索クエリの関連性が高いことを示します。結果はページ分割され、デフォルトの最大結果はページあたり 100 件です。`nextToken` パラメータを使用して、結果の追加ページを取得できます。

## ベストプラクティス
<a name="retrieve-records-best-practices"></a>

記憶を取得するときは、次のベストプラクティスを考慮してください。
+ 探している情報を明確に説明する特定の検索クエリを作成します。
+ `topK` パラメータを使用して、アプリケーションのニーズに基づいて結果の数を制御します。
+ 大きな記憶を操作するときは、ページ分割を実装して、関連するすべての結果を効率的に処理します。
+ 特定の抽出戦略からの記憶が必要な場合は、 によるフィルタリングを検討`memoryStrategyId`してください。

取得されると、これらのメモリレコードをエージェントのコンテキストに組み込むことができ、よりパーソナライズされたコンテキスト対応レスポンスが可能になります。