智能体记忆维护(管理端)
给谁看:平台管理员(管理端 智能体记忆维护)。
来源 help/admin-ops/agent-memory-maintain.md
给谁看:平台管理员(管理端 智能体记忆维护)。
表述:夜里或手动整理各用户智能体的 个人记忆(去重、过期日笔记等)。与 记忆锻造(扫描对话 → 改进帮助/工作区知识叠加层)不是同一功能。
在管理端做什么
- 登录管理端 → 概览 → 打开记忆维护(路由
/agent-memory-maintain)。 - 查看配置摘要:是否开启自动整理、夜里定点钟点、时区、下次计划时间。
- 点 立刻整理一次:对运行时目录下有记忆的智能体跑一轮(不等待夜里窗口)。
- 在 执行历史 中点开某次运行,查看 本次改变了什么(删除类型、智能体、路径、原因)。
用户也可在各自智能体 记忆 页查看 本助手 的整理记录,并手动「整理我的记忆」。见 智能体记忆。
与记忆锻造的区别
| | 智能体记忆维护 | 记忆锻造 | |--|-------------------|--------------| | 服务对象 | 单个智能体的个人记忆 | 帮助 / 工作区知识叠加层与技能 | | 典型动作 | 删除重复、过期日笔记 | 扫描归档 → 提案 → 人工采纳新建补充 | | 管理端入口 | /agent-memory-maintain | /memoryforge | | 是否改正本知识 | 否 | 否(只写叠加层) |
何时自动跑
须同时满足:
schedule.enabled为 trueagent_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(知识反哺,非个人记忆清理)