Skip to main content

管理记忆

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

建议使用元数据（meta_data）对记忆分类管理，便于后续精确检索。查看会话关联的记忆变更参见记忆观测，追溯自动抽取及手动操作的变更记录参见记忆审计。

查看记忆详情

在记忆库卡片上点击查看详情，进入记忆详情标签页。顶部展示事实记忆数、用户画像数、技能记忆数和记忆实体数；下方为实体列表，支持通过实体 ID（user_id）模糊搜索。点击操作列的查看，按记忆规则查看该实体的事实记忆、用户画像和技能记忆。 通过 API 列出记忆（调用时请将 {WorkspaceId} 替换为真实的业务空间 ID，Python SDK 的服务地址配置见概览）： 
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_id—
事实记忆规则选择指定规则进行检索—
最大召回数量每次检索返回的记忆条数（1~100）按需设置
意图判别召回系统判断当前对话是否需要召回记忆，避免无关检索开启
改写对用户查询优化改写，提升语义检索准确率口语化提问时开启
排序对检索结果重排，提升相关性需要高相关性时开启
相似度阈值0.0~1.0，过滤低相关性结果0.5~0.7
排序目前仅支持 gte-rerank-v2 模型。相似度过高可能漏召相关记忆，过低可能引入噪声。
通过 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": "pro"
  }'

更新和删除记忆

编辑事实记忆

  1. 在记忆库的记忆详情标签页找到实体并点击查看。
  2. 在事实记忆规则下选择对应规则，找到目标记忆卡片，点击详情图标进入事实记忆详情。
  3. 点击编辑修改记忆内容，再点击保存或保存并关闭弹窗。
保存后，在记忆详情中确认新内容；需要比较修改前后的内容时，进入记忆审计查看更新快照。

停用和重新启用事实记忆

在事实记忆详情中关闭启用开关，记忆显示为未启用；重新开启后显示为已启用。审计中分别记录为软删除与恢复。

删除事实记忆

确认删除后记忆无法恢复。若只需暂时停用，使用启用开关，不要执行删除。
在目标记忆卡片上点击删除图标，再在确认框中点击删除。删除成功后，检查记忆列表；在记忆审计中可查询删除记录及变更前的内容。

通过 API 更新和删除

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

# 删除记忆
curl -X DELETE "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v2/apps/memory/memory_nodes/{memory_node_id}" \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json"
接口参数详情参见 API 参考，计费和限流参见计费与限流。