全部文档

智能体记忆维护(管理端)

给谁看:平台管理员(管理端 智能体记忆维护)。

来源 help/admin-ops/agent-memory-maintain.md

给谁看:平台管理员(管理端 智能体记忆维护)。

表述:夜里或手动整理各用户智能体的 个人记忆(去重、过期日笔记等)。与 记忆锻造(扫描对话 → 改进帮助/工作区知识叠加层)不是同一功能。

在管理端做什么

  1. 登录管理端 → 概览 → 打开记忆维护(路由 /agent-memory-maintain)。
  2. 查看配置摘要:是否开启自动整理、夜里定点钟点、时区、下次计划时间。
  3. 立刻整理一次:对运行时目录下有记忆的智能体跑一轮(不等待夜里窗口)。
  4. 执行历史 中点开某次运行,查看 本次改变了什么(删除类型、智能体、路径、原因)。

用户也可在各自智能体 记忆 页查看 本助手 的整理记录,并手动「整理我的记忆」。见 智能体记忆

与记忆锻造的区别

| | 智能体记忆维护 | 记忆锻造 | |--|-------------------|--------------| | 服务对象 | 单个智能体的个人记忆 | 帮助 / 工作区知识叠加层与技能 | | 典型动作 | 删除重复、过期日笔记 | 扫描归档 → 提案 → 人工采纳新建补充 | | 管理端入口 | /agent-memory-maintain | /memoryforge | | 是否改正本知识 | 否 | 否(只写叠加层) |

何时自动跑

须同时满足:

  • schedule.enabled 为 true
  • agent_memory_maintain.enabled 为 true

触发时间:按 RuntimeTimezone(或 MINDLINK_RUNTIME_TIMEZONE,默认 Asia/Shanghai)的 本地夜里daily_local_hour(默认 2)起约 2 小时窗口内每日一次。

配置(mindlink.json

"agent_memory_maintain": {
  "enabled": true,
  "daily_local_hour": 2,
  "daily_note_retain_days": 14,
  "stale_review_days": 90,
  "min_entries_for_llm": 5,
  "max_agents_per_run": 30,
  "max_deletes_per_agent": 8,
  "use_llm": true
}

字段说明见 服务端配置说明 § agent_memory_maintain

相关 API(管理端)

方法路径说明
GET/api/v1/admin/agent-memory-maintain/status配置摘要 + 最近一次结果
GET/api/v1/admin/agent-memory-maintain/history执行历史(新→旧)
POST/api/v1/admin/agent-memory-maintain/run立刻整理一轮

落盘位置(运维对照)

路径内容
{runtime_dir}/.memory_maintain_status.json最近一次全局状态
{runtime_dir}/.memory_maintain_history.jsonl全局执行历史
{runtime_dir}/{智能体ID}/memory/.maintain/log.jsonl该智能体相关变更历史

相关文档

  • 用户帮助:智能体记忆
  • 机制说明:docs/core-mechanisms/智能体记忆.md
  • 记忆锻造:管理端 /memoryforge(知识反哺,非个人记忆清理)