管理 Agent 记忆

妥善保存稳定的操作偏好,使其在对话轮次增长或客户端断开连接后依然可用。在依赖历史决策之前,应先从原始数据源中检索验证。记忆属于客观证据与辅助上下文,不能替代当下的明确指令,也不能替代工作项的实时状态。

前置条件

选定要更新记忆的目标 Agent。使用运行时返回的真实 Agent Home 路径;下文的 agent_home 为逻辑描述名,切勿直接在终端中硬编码复制。项目特有的约定请保存在项目仓库中。

1. 明确信息归属位置

信息类别保存位置
稳定的操作者偏好(如默认回复语言、命名前缀)该 Agent 的 memory/operator.md
关于该 Agent 自身角色或长期运行的稳定事实该 Agent 的 memory/self.md
常驻职责、权限边界与升级触发规则该 Agent 的 AGENTS.md
特定代码仓库的构建命令与本地贡献规范项目工作区的 AGENTS.md
正在进行的工作目标、执行计划与待办事项运行时工作项(WorkItem)

2. 更新精选记忆文件

打开该 Agent 的 memory/operator.md,记录稳定的偏好项:

# 操作者偏好

- 默认使用中文进行回复。
- 在提交 PR 前,必须在本地完整运行并确认测试通过。

打开 memory/self.md,记录关于该 Agent 自身的持久事实:

# 自身事实

- 本 Agent 负责文档翻译与润色工作流。
- 遵循先英文润色、后中文翻译、再中文润色的标准工序。

系统会自动将这两个文件的紧凑切片载入上下文;超出预算的部分依然可以通过搜索工具检索到。

3. 检索与核验历史记忆

当需要确认过去的决策原由时,引导 Agent 使用检索工具定位证据:

# 在终端中也可以通过 CLI 查看 Agent 的记忆记录
holon agent get reviewer --detail full

在模型调用层面,Agent 会调用 MemorySearch 查找关键字,再调用 MemoryGet 获取受限的证据详情。切勿单凭模糊的历史摘录就认定某项高风险操作已获批准。

另见