# 检索内存记录
<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**   
包含要检索的记录的内存资源的标识符。

 **命名空间**   
存储内存记录的确切命名空间。该操作返回命名空间中与提供的命名空间匹配的分页内存记录。

 **命名空间路径**   
存储内存记录的命名空间路径。该操作返回提供的命名空间层次结构下的分页内存记录，这些记录以提供的路径开头。

 **搜索标准**   
包含搜索参数的结构：  
+  *SearchQuery*-用于查找相关记忆的语义查询文本（最多 10,000 个字符）。
+  *内存 StrategyId*（可选）-将搜索范围限制为由特定策略创建的内存。
+  *TopK*-要返回的最大相关结果数（默认值：10，最大值：100）。

## 响应格式
<a name="retrieve-records-response"></a>

该操作会返回与您的搜索条件相匹配的内存记录摘要列表。每个摘要都包含一个*相关性分数*，该分数源自嵌入向量的余弦相似度。该分数**不**代表百分比匹配，而是衡量两个向量在高维空间中的对齐程度。分数越高表示记忆记录与搜索查询的相关性越大。结果是分页的，默认每页最多显示 100 个结果。您可以使用`nextToken`参数来检索其他页面的结果。

## 最佳实践
<a name="retrieve-records-best-practices"></a>

检索记忆时，请考虑以下最佳实践：
+ 制作特定的搜索查询，清楚地描述您要查找的信息。
+ 使用`topK`参数根据应用程序的需求控制结果数量。
+ 处理大内存时，请实现分页以高效处理所有相关结果。
+ 考虑按`memoryStrategyId`何时需要特定提取策略中的记忆进行筛选。

一旦检索，这些记忆记录就可以整合到您的代理的上下文中，从而实现更具个性化和情境感知能力的响应。