一份能交接的 Agent 运行记录,应让接班人无需重读全部对话,就能知道任务目标、已完成成果、仍未确认的操作和下一步入口。记录的重点是可核对的状态,而不是每一步思考过程。
先给接班人一个准确的当前结论
例如“十二份报告中九份已保存并读回,两份转换中,一份输入缺失”,比“主要工作已完成”更有用。摘要中的每个数量都应能落到逐项清单,并区分已计划、已提交、已完成和已验证。没有结果的项目不能因为执行过就算完成。
对于文档任务,还要说明本次使用的输入资料、统计周期和模板版本。接班人若不知道产物依据什么生成,即使拿到文件,也无法判断是否需要继续处理。输入发生变化时,应说明这是续跑原批次,还是进入新的修订。
成果清单连接到实际对象
| 记录内容 | 交接价值 |
|---|---|
| 文档、附件和任务 ID | 直接定位真实成果 |
| 输入与产物版本 | 核对内容对应关系 |
| 操作键和最后状态 | 避免重复执行 |
| 验收证据 | 判断哪些结论已有依据 |
| 未完成项与恢复入口 | 明确下一步从哪里开始 |
MCP 工具结果支持结构化内容与资源链接,可以成为交接记录的数据来源。但一段模型生成的总结不能替代真实回执。文档是否存在、文件是否可读、任务是否完成,都应来自实际查询或验收结果。
把不确定状态单独列出来
若保存请求超时,记录目标对象、原操作身份和最后查询时间,明确结果尚未确认。不要写成“保存失败,重新执行即可”。如果远端转换仍在运行,保存任务查询入口和建议检查时间,接班人就能继续等待原任务,而不是重新提交一份。
进度通知也不应当作完成证明。MCP 的进度机制用于报告处理进展,最终成果仍需核验。记录可以保留最近阶段作为线索,但应让“进度显示完成”与“产物读回通过”在状态上有所区分。
留下足够上下文,避免堆满原始日志
正文记录用户目标、约束、关键决定和当前状态,详细日志放到独立文件并链接。需要保留的是影响后续行动的理由,例如为何跳过某份缺数据文档、为何没有自动重试未知请求。重复的工具输出不必全部塞进交接摘要。
交接包还应避免携带凭据或不必要的原始私密内容。用稳定对象标识和受控证据路径定位资料即可。若某条链接会过期,记录获取新链接的方法与真实对象 ID,不要把临时下载地址当成永久索引。
最后用一次接班演练验收:让另一位执行者只读交接记录,找到一份已完成文件,并恢复一项未完成工作。如果仍然必须翻遍旧对话猜状态,记录就还不够。可交接意味着别人能依据证据继续,而不只是看懂一段总结。
在企业文档中验证
如果要把本文方法用于企业文档,可预约演示,结合实际资料核对协作、权限与集成方式。
需要在自己的环境中验证时,可先了解私有化部署方案,再确定试用范围与验收要求。