Agent

如何给长任务 Agent 写运行日志

长任务不能只靠聊天上下文。用 run log 记录阶段、决策、失败、验证和下一步,防止 Agent 跑偏。

实战 · 52 分钟
如何给长任务 Agent 写运行日志 配图
学习摘要

长任务不能只靠聊天上下文。用 run log 记录阶段、决策、失败、验证和下一步,防止 Agent 跑偏。

难度
实战
预计耗时
52 分钟
路径
Agent
难度实战
预计耗时52 分钟
学习路径Agent

你会获得

  • 创建 run log 模板
  • 记录阶段门禁
  • 复盘失败原因

教程目标

长任务不能只靠聊天上下文。用 run log 记录阶段、决策、失败、验证和下一步,防止 Agent 跑偏。

如何给长任务 Agent 写运行日志 流程图

为什么需要

长任务可能持续几十分钟甚至几小时,中途会读取大量文件和做很多判断。没有运行日志就无法复盘。

操作步骤

1. 开始前写任务目标和阶段。
2. 每阶段记录输入、输出、命令和结论。
3. 遇到失败写 failure_tag 和恢复动作。
4. 关键门禁等待人工确认。
5. 结束时写验证结果和后续建议。

可复制模板

任务:
阶段:
当前状态:
已做动作:
证据:
失败标签:
恢复动作:
下一步:

验收清单

  • 是否能看懂 Agent 做了什么
  • 是否记录失败
  • 是否有证据
  • 是否有下一步
  • 是否能从中断处继续
如何给长任务 Agent 写运行日志 检查清单

如何沉淀成能力

学完后,把这套流程写入 Skill、SOP 或后台检查清单。HTKU 的目标不是收藏资料,而是把资料变成能重复执行的能力。

如何给长任务 Agent 写运行日志 能力产出