Harness 架构 中级

Harness 是什么:模型与智能体之间的脚手架

理解 Agent Harness 的定义——把只会预测文本的模型包装成能持续干活的智能体的那层工程结构。

定义:模型之外的全部工程

Harness(马具/脚手架)是 Agent 领域的行话:指围绕大模型构建的那层"驾驶舱"——它向模型提供工具、管理上下文、执行动作、兜住错误,把"只会预测下一个词"的模型变成"能持续干活的智能体"。

ChatModel(模型)  :大脑,只会根据输入续写文本
+ Harness(脚手架):工具循环 / 上下文管理 / 权限沙箱 / 错误恢复
= Agent(智能体)  :能感知、决策、行动、持续工作的系统

用实例建立直觉

  • Claude Code 的价值一半在模型、一半在其 Harness(读改文件、跑命令、测试反馈的闭环);
  • OpenClaw 就是一个消息渠道场景的 Harness(Gateway + 工具 + Skills + 定时任务);
  • 本站的 AI 助手也是一个微型 Harness(意图路由 → 工具 → 生成 + 轨迹可观察)。

Harness 的五个职责

  1. 工具供给:把能力(文件、终端、检索)暴露成模型可调用的工具;
  2. 循环执行:模型输出"要调用工具"→ Harness 执行 → 结果喂回 → 直到任务完成;
  3. 上下文管理:决定什么信息进入模型有限的窗口;
  4. 安全边界:限制模型能对真实世界做什么;
  5. 可观察与恢复:全程 trace,出错能重试或降级。

关键认知

同一个模型换上不同的 Harness,表现天差地别 —— "模型决定上限,Harness 决定下限"。这也是为什么开源模型 + 好的 Harness 常能打败闭源模型 + 烂的包装。

📝 课后练习

quiz-1 "Agent Harness"指的是?