本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
检索内存记录
您可以使用 RetrieveMemoryRecords API 检索提取的内存。此操作允许您根据语义查询搜索提取的内存记录，从而可以轻松地从代理的内存中找到相关信息。
必填参数
该RetrieveMemoryRecords操作需要以下关键参数：
- 记忆ID
-
包含要检索的记录的内存资源的标识符。
- 命名空间
-
存储内存记录的确切命名空间。该操作返回命名空间中与提供的命名空间匹配的分页内存记录。
- 命名空间路径
-
存储内存记录的命名空间路径。该操作返回提供的命名空间层次结构下的分页内存记录，这些记录以提供的路径开头。
- 搜索标准
-
包含搜索参数的结构：
-
SearchQuery -用于查找相关记忆（最多 10,000 个字符）的语义查询文本。
-
内存 StrategyId（可选）-将搜索范围限制为由特定策略创建的内存。
-
topK -要返回的最大相关结果数（默认值：10，最大值：100）。
-
响应格式
该操作会返回与您的搜索条件相匹配的内存记录摘要列表。每个摘要都包含相关性分数，该分数源自嵌入向量的余弦相似度。该分数不代表百分比匹配，而是衡量两个向量在高维空间中的对齐程度。分数越高表示内存记录与搜索查询的相关性越大。结果是分页的，默认每页最多 100 个结果。您可以使用nextToken参数来检索其他页面的结果。
最佳实践
检索内存时，请考虑以下最佳做法：
-
精心设计特定的搜索查询，清楚地描述你正在寻找的信息。
-
根据应用程序的需求，使用
topK参数控制结果的数量。 -
处理大型内存时，实现分页以有效处理所有相关结果。
-
考虑按
memoryStrategyId何时需要特定提取策略中的存储器进行过滤。
检索到这些记忆记录后，可以整合到代理的上下文中，从而实现更加个性化和情境感知的响应。
