本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 检索内存记录
<a name="long-term-retrieve-records"></a>

您可以使用 [ RetrieveMemoryRecords ](https://docs.amazonaws.cn/bedrock-agentcore/latest/APIReference/API_RetrieveMemoryRecords.html) API 检索提取的内存。此操作允许您根据语义查询搜索提取的内存记录，从而可以轻松地从代理的内存中找到相关信息。

## 必填参数
<a name="retrieve-records-parameters"></a>

该`RetrieveMemoryRecords`操作需要以下关键参数：

 **记忆ID **   
包含要检索的记录的内存资源的标识符。

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

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

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

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

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

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

检索内存时，请考虑以下最佳做法：
+ 精心设计特定的搜索查询，清楚地描述你正在寻找的信息。
+ 根据应用程序的需求，使用`topK`参数控制结果的数量。
+ 处理大型内存时，实现分页以有效处理所有相关结果。
+ 考虑按`memoryStrategyId`何时需要特定提取策略中的存储器进行过滤。

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