3 步体验记忆的写入、查看和检索
用默认记忆库,3 步跑通记忆的写入、查看和检索。如需自定义记忆规则,参见创建记忆库。
在运行示例的终端中显式设置 API Key;先替换占位值,不要将真实密钥提交到仓库:
Python 示例使用同一终端中设置的
调用
在百炼控制台进入默认记忆库的记忆详情标签页,输入记忆实体 ID
在控制台切换到记忆检索标签页,输入记忆实体 ID
前提条件
- 首次使用需开通记忆库服务:进入百炼控制台记忆库页面,点击立即开通
- 已获取
DASHSCOPE_API_KEY,获取方式见获取 API Key - 已获取业务空间 ID,并将下文请求地址中的
{WorkspaceId}替换为该 ID。API Key 须属于同一业务空间 - 如使用 Python SDK,先安装:
pip install agentscope-runtime,并设置服务地址:export MEMORY_SERVICE_ENDPOINT="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/memory"注意:agentscope-runtime 依赖mcp.server.fastmcp,该模块在 mcp 2.x 中已移除;若环境中 mcp 为 2.x 版本,需一并约束:pip install agentscope-runtime "mcp<2",否则 import 时会报No module named 'mcp.server.fastmcp'。
DASHSCOPE_API_KEY 和 MEMORY_SERVICE_ENDPOINT。启动 Python 前将服务地址中的 {WorkspaceId} 替换为实际业务空间 ID;未设置地址时,SDK 不会自动选择该业务空间的记忆服务地址。下方三步始终使用同一 user_id="user_001"。
本页使用独立 Memory 服务,与 Managed Agents 的 Memory Store 分开管理。
步骤一:写入记忆
调用 AddMemory 接口,将对话传入记忆库。系统自动从对话中提取事实记忆。
步骤二:查看记忆
在百炼控制台进入默认记忆库的记忆详情标签页,输入记忆实体 ID user_001,点击查看,即可看到系统自动提取的事实记忆。
也可通过 API 列出记忆:
步骤三:检索记忆
在控制台切换到记忆检索标签页,输入记忆实体 ID user_001,在输入框输入"我需要做什么?",点击运行查看相关记忆。
通过 API 检索:
到这里你已经完成了记忆的写入、查看和检索。核对
user_001 的列表与检索结果中的事实是否对应写入的对话。示例记录和检索提醒相关的事实,并不会自动创建定时提醒任务。将检索结果注入 Prompt 即可实现个性化回答。