L03-07 三层超时：一个都不能少

全局中心内容：单层超时兜不住 Agent——工具、单轮、整体三层各有职责。 全局讲解主线：挂死的场景 → 三层模型 → 每层怎么设 → 超时的处理动作 → 审批超时的例外 → 编码。

P1 · 产出页

中心内容：工具级 / 单轮级 / 任务级三层超时配置与兜底动作。

中心内容：工具超时（秒级）→ 单轮超时（十秒级）→ 任务超时（分钟级）。

页面内容：三层结构图与量级建议
讲解技巧
- 给明确的量级：工具 10~30s，单轮 60s，任务 5~10min。
- 讲清为什么都要有：只有任务超时的话，卡死的工具会把线程池耗尽，整个服务不可用。
时长：6min

中心内容：每个工具单独设，慢工具（如代码分析）可以长一些。

讲解技巧
- 强调按工具特性设，不要一刀切：查库 5s 够，调外部 API 可能要 30s。
- 提醒 HTTP 客户端的 connect/read 超时都要设。
时长：5min

中心内容：包含模型调用 + 工具执行的总时间。

中心内容：用户视角的总等待上限。

中心内容：不是简单报错，要给出已完成的部分。

页面内容：超时处理流程（记录状态 → 生成部分结论 → 通知）
讲解技巧
- 重点讲「生成部分结论」：用户拿到「已完成 3/5 步，卡在第 4 步」比拿到一个错误有用得多。
- 提醒：超时后要确保后台线程真的被中断，否则资源仍被占用。
时长：5min

中心内容：等待人审批的时间不能算进任务超时。

中心内容：CompletableFuture.orTimeout + 独立线程池。