Skip to main content
开始使用

快速开始

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

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

前提条件

  • 已获取 DASHSCOPE_API_KEY，获取方式见获取 API Key
  • 如使用 Python SDK，先安装：pip install agentscope-runtime

步骤一：写入记忆

调用 AddMemory 接口，将对话传入记忆库。系统自动从对话中提取记忆片段。 
curl -X POST https://dashscope.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://dashscope.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://dashscope.aliyuncs.com/api/v2/apps/memory/search \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "query": "我需要做什么？"
  }'
到这里你已经完成了记忆的写入、查看和检索。将检索结果注入 Prompt 即可实现个性化回答。
体验完核心流程后，继续创建记忆库配置自定义记忆规则。
开始使用
操作指南
参考
更新日志
快速开始 - Agent Studio