第 2 周:Agent Loop、Tool Use 与协议边界

Day 12 · 错误恢复:重试、降级、人工介入

核心指数 稳定性 5/5

关键逻辑释义

真实环境一定失败,优秀 harness 会区分网络、权限、格式、语义和安全失败。

今日关键术语释义

每个当天会被提问或用于练习的术语,先给通俗释义,再给专业释义,避免题目超出当天知识点。

错误恢复:重试、降级、人工介入

通俗释义:把“错误恢复:重试、降级、人工介入”先理解成今天要掌握的一种工程判断:它帮助你决定系统该如何稳定完成任务。

专业释义:错误恢复:重试、降级、人工介入 是 Agent Harness 课程中的专项能力点,需要从定义、输入输出、工程边界、失败模式、指标与验证方式六个角度掌握。

当天检查:能用自己的话解释 错误恢复:重试、降级、人工介入,并把它映射到 AI Digest / Hermes / 学习平台中的一个真实环节。

参考脉络:课程内置知识点;当天需结合 AI Digest 或真实系统案例验证

Retry / Fallback

通俗释义:失败后有上限地重试;还不行就降级或找人。

专业释义:按错误类型选择 bounded retry、exponential backoff、fallback model/tool、partial result 或 human escalation,避免沉默失败和无限循环。

当天检查:能把网络、权限、格式、语义失败分别处理。

参考脉络:Production reliability / OpenAI guardrails

HITL

通俗释义:高风险动作先停下来让人确认。

专业释义:Human-in-the-loop 在删除、发布、支付、外发、高权限写入等副作用前引入人工审批、可解释 diff 和审计记录。

当天检查:能列出当前系统 5 个必须人工确认的动作。

参考脉络:OpenAI guardrails / 12-factor agents

概念定义

通俗释义:把“概念定义”先理解成今天要掌握的一种工程判断:它帮助你决定系统该如何稳定完成任务。

专业释义:概念定义 是 Agent Harness 课程中的专项能力点,需要从定义、输入输出、工程边界、失败模式、指标与验证方式六个角度掌握。

当天检查:能用自己的话解释 概念定义,并把它映射到 AI Digest / Hermes / 学习平台中的一个真实环节。

参考脉络:课程内置知识点;当天需结合 AI Digest 或真实系统案例验证

工程实现

通俗释义:把“工程实现”先理解成今天要掌握的一种工程判断:它帮助你决定系统该如何稳定完成任务。

专业释义:工程实现 是 Agent Harness 课程中的专项能力点,需要从定义、输入输出、工程边界、失败模式、指标与验证方式六个角度掌握。

当天检查:能用自己的话解释 工程实现,并把它映射到 AI Digest / Hermes / 学习平台中的一个真实环节。

参考脉络:课程内置知识点;当天需结合 AI Digest 或真实系统案例验证

失败模式

通俗释义:把“失败模式”先理解成今天要掌握的一种工程判断:它帮助你决定系统该如何稳定完成任务。

专业释义:失败模式 是 Agent Harness 课程中的专项能力点,需要从定义、输入输出、工程边界、失败模式、指标与验证方式六个角度掌握。

当天检查:能用自己的话解释 失败模式,并把它映射到 AI Digest / Hermes / 学习平台中的一个真实环节。

参考脉络:课程内置知识点;当天需结合 AI Digest 或真实系统案例验证

理解表达

通俗释义:把“理解表达”先理解成今天要掌握的一种工程判断:它帮助你决定系统该如何稳定完成任务。

专业释义:理解表达 是 Agent Harness 课程中的专项能力点,需要从定义、输入输出、工程边界、失败模式、指标与验证方式六个角度掌握。

当天检查:能用自己的话解释 理解表达,并把它映射到 AI Digest / Hermes / 学习平台中的一个真实环节。

参考脉络:课程内置知识点;当天需结合 AI Digest 或真实系统案例验证

核心知识展开

1. 是什么

真实环境一定失败,优秀 harness 会区分网络、权限、格式、语义和安全失败。

2. 工程位置

它在 Agent Harness 中连接“目标/约束、上下文、工具、状态、验证、运营指标”这些层。学习时要问:这一层负责限制什么风险?它把哪类不确定性变成了可观察、可恢复、可评估的工程对象?

3. 必须掌握

  • 概念定义
  • 工程实现
  • 失败模式
  • 理解表达

4. 设计流程

检测 → 归因 → 有上限重试 → 降级 → 人工确认

5. 工程注意事项

  • 把该主题绑定到一个真实系统,不只记概念。
  • 每个练习都要产出可展示 artifact 或可执行验收标准。

6. 常见失败模式

  • 只会解释“错误恢复”的概念,但说不出它在真实系统中的输入、输出和边界。
  • 把模型输出当成验证结果,没有使用工具、测试、引用或状态记录做外部确认。
  • 只追求功能跑通,没有留下 trace、指标、失败原因和下一步改进证据。

7. 学习笔记

今天围绕“错误恢复:重试、降级、人工介入”建立一个可复用的工程判断:先能定义它解决什么问题,再能指出它在 Agent Harness 中位于哪一层,最后能用一个真实系统环节验证它是否有效。真实环境一定失败,优秀 harness 会区分网络、权限、格式、语义和安全失败。 学习时不要只记名词,要把它和状态、工具、上下文、评估、成本或安全边界中的至少一项连接起来。

知识对应点

  • retry
  • fallback
  • HITL

必须掌握

  • 概念定义
  • 工程实现
  • 失败模式
  • 理解表达

工程注意事项

  • 把该主题绑定到一个真实系统,不只记概念。
  • 每个练习都要产出可展示 artifact 或可执行验收标准。

理解表达

我能围绕 错误恢复:重试、降级、人工介入 讲清楚工程目标、实现方式、指标和失败处理。

流程

检测 → 归因 → 有上限重试 → 降级 → 人工确认

练习

给工具调用失败设计三层 fallback。

完成标准:失败不沉默、不无限循环。

配套图示

多角色协作只有在边界清晰、可评估、可回归时才值得引入。

💬AI Chat