Skip to main content

快速开始

3 步体验记忆的写入、查看和检索

用默认记忆库,3 步跑通记忆的写入、查看和检索。如需自定义记忆规则,参见创建记忆库。

前提条件

  • 首次使用需开通记忆库服务:进入百炼控制台记忆库页面,点击立即开通
  • 已获取 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'。
在运行示例的终端中显式设置 API Key;先替换占位值,不要将真实密钥提交到仓库:
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx"
Python 示例使用同一终端中设置的 DASHSCOPE_API_KEY 和 MEMORY_SERVICE_ENDPOINT。启动 Python 前将服务地址中的 {WorkspaceId} 替换为实际业务空间 ID;未设置地址时,SDK 不会自动选择该业务空间的记忆服务地址。下方三步始终使用同一 user_id="user_001"。 本页使用独立 Memory 服务,与 Managed Agents 的 Memory Store 分开管理。

步骤一:写入记忆

调用 AddMemory 接口,将对话传入记忆库。系统自动从对话中提取事实记忆。
curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/memory/add \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "messages": [
      {"role": "user", "content": "每天上午9点提醒我喝水"},
      {"role": "assistant", "content": "好的,已记录"},
      {"role": "user", "content": "明天10点提醒我整理会议纪要。"}
    ],
    "user_id": "user_001"
  }'

步骤二:查看记忆

在百炼控制台进入默认记忆库的记忆详情标签页,输入记忆实体 ID user_001,点击查看,即可看到系统自动提取的事实记忆。 也可通过 API 列出记忆:
curl -X GET "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/memory/memory_nodes?user_id=user_001&page_size=10&page_num=1" \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json"

步骤三:检索记忆

在控制台切换到记忆检索标签页,输入记忆实体 ID user_001,在输入框输入"我需要做什么?",点击运行查看相关记忆。 通过 API 检索:
curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/memory/memory_nodes/search \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "messages": [{"role": "user", "content": "我需要做什么?"}],
    "top_k": 10,
    "min_score": 0.3,
    "plan_version": "Lite"
  }'
到这里你已经完成了记忆的写入、查看和检索。核对 user_001 的列表与检索结果中的事实是否对应写入的对话。示例记录和检索提醒相关的事实,并不会自动创建定时提醒任务。将检索结果注入 Prompt 即可实现个性化回答。
体验完核心流程后,继续创建记忆库配置自定义记忆规则。