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