Skip to main content
操作指南

管理记忆

查看、检索调试、更新和删除记忆

记忆写入后，可在控制台查看和检索，或通过 API 进行列表、更新和删除操作。建议使用元数据（meta_data）对记忆分类管理，便于后续精确检索。

查看记忆详情

在记忆库详情页的记忆详情标签页，顶部展示记忆库基本信息和统计数据。下方展示记忆实体列表，支持通过记忆实体 ID（user_id）筛选。点击操作列的查看可查看记忆详情。 通过 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_id—
记忆片段规则选择指定规则进行检索—
最大召回数量每次检索返回的记忆条数（1~100）按需设置
意图判别召回系统判断当前对话是否需要召回记忆，避免无关检索开启
改写对用户查询优化改写，提升语义检索准确率口语化提问时开启
排序对检索结果重排，提升相关性需要高相关性时开启
相似度阈值0.0~1.0，过滤低相关性结果0.5~0.7
排序目前仅支持 gte-rerank-v2 模型。相似度过高可能漏召相关记忆，过低可能引入噪声。
通过 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": "我需要做什么？",
    "max_results": 10,
    "rewrite": true,
    "rerank": true,
    "similarity_threshold": 0.6
  }'

更新和删除记忆

# 更新记忆
curl -X PATCH "https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/{memory_node_id}" \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "custom_content": "还要提醒我上午10点吃药。"
  }'

# 删除记忆
curl -X DELETE "https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/{memory_node_id}" \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json"
接口参数详情参见 API 参考，计费和限流参见计费与限流。
开始使用
操作指南
参考
更新日志