第 6 周:Sandbox、Runtime、产品化与项目沉淀

Day 42 · 系统设计练习:设计 Agent Harness

核心指数 讲解 5/5

关键逻辑释义

用主题语言回答:如何设计一个能在浏览器和代码仓库中长期执行任务的 Agent Harness。

今日关键术语释义

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

Agent Harness

通俗释义:把大模型变成可控助手的“运行外壳”:负责给目标、喂上下文、调工具、记状态、验结果和控成本。

专业释义:围绕 LLM 的运行时工程层,组合 context builder、tool runtime、state machine、policy/guardrail、eval/trace 与成本延迟控制,使模型能力可产品化。

当天检查:能指出一个 Agent 功能中哪些属于模型层,哪些属于 Harness 层。

参考脉络:OpenAI Agents guide / Anthropic effective agents / 12-factor agents

scenario design

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

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

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

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

system design

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

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

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

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

Product Judgment

通俗释义:先判断该不该做、怎么做才稳,而不是堆名词。

专业释义:围绕用户任务、稳定性、DX、权限、成本和可维护性进行架构取舍,决定 workflow、agent、human review 的边界。

当天检查:能指出至少 3 个不该 Agent 化的环节。

参考脉络:Anthropic effective agents / product engineering

概念定义

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

专业释义:概念定义 是 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. 是什么

用主题语言回答:如何设计一个能在浏览器和代码仓库中长期执行任务的 Agent Harness。

2. 工程位置

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

3. 必须掌握

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

4. 设计流程

需求澄清 → 架构 → 数据流 → 失败模式 → 指标 → 安全

5. 工程注意事项

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

6. 常见失败模式

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

7. 学习笔记

今天围绕“系统设计练习:设计 Agent Harness”建立一个可复用的工程判断:先能定义它解决什么问题,再能指出它在 Agent Harness 中位于哪一层,最后能用一个真实系统环节验证它是否有效。用主题语言回答:如何设计一个能在浏览器和代码仓库中长期执行任务的 Agent Harness。 学习时不要只记名词,要把它和状态、工具、上下文、评估、成本或安全边界中的至少一项连接起来。

知识对应点

  • scenario design
  • system design
  • tradeoff

必须掌握

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

工程注意事项

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

理解表达

我能围绕 系统设计练习:设计 Agent Harness 讲清楚工程目标、实现方式、指标和失败处理。

流程

需求澄清 → 架构 → 数据流 → 失败模式 → 指标 → 安全

练习

做一次 20 分钟系统设计自问自答。

完成标准:能讲清取舍而不是罗列名词。

配套图示

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

💬AI Chat