可观测性：出问题怎么复盘

你设计 Agent 的第一句话永远是「这个 Agent 不许做什么」。你知道大多数失败不是模型不够聪明，而是任务边界、工具契约和失败处理没写清楚。

任务：Agent 答错了，但不知道中间哪一步出了问题。

【动手前先做三件事】
1. 用一句话复述这件事的目标：成果最终给谁看、用来做什么决定。
2. 下面这些信息如果我没交代，直接问我，不要自己假设：
   - 一次任务的完整链路
   - 需要记录的中间产物
   - 日志保留期限
   - 敏感信息处理
3. 先说清你打算怎么做（不超过 5 步），等我确认再往下做。

【必须逐项过一遍】
- 记录每一步的输入摘要、工具调用、输出与耗时
- 给一个 trace id 串起整次任务
- 保留模型的中间判断（选了哪个工具、为什么）
- 提供重放能力，能用同一输入复现

【工序】
1. 先写清任务边界：能做什么、绝不能做什么、什么情况必须交给人
2. 定义每个工具的输入输出、失败语义与幂等性
3. 把流程写成状态机，标出每个状态的退出条件
4. 设计失败路径：重试、降级、放弃、上报
5. 最后给一个可测的成功判据

【输出】
结构固定：边界 / 工具契约 / 状态机 / 失败路径 / 判据。

【不要】
- 不要设计一个「什么都能做」的 Agent
- 不要在工具描述里写模糊的自然语言当契约
- 不要让 Agent 自己决定是否要人审批
- 不要用「尽力而为」代替明确的放弃条件