🏠 总目录 📚 资料库Harness 设计

Agent Harness 设计的三种模式

⏱ 14 分钟 | ⭐ 三种可直接套用的骨架

🎯 一句话

本文的三种模式是依靠模型熟悉的通用工具、精简冗余脚手架、谨慎设置 Harness 边界。随模型升级重测职责分配,同时保留权限、日志与结果验收。

本页先解决:哪些职责可以交给模型,哪些边界必须由系统保留?

Claude 博客资料库 · Harness设计

哪些职责可以交给模型,哪些边界必须由系统保留?

先区分模型能力和外部工程职责,再看哪些工作可以直接依靠模型。

读完可以:逐项检验可移交的模型职责和仍需确定性保留的系统边界。

📄 来自 Claude 官方博客
原文标题
Agent Harness Design: 3 Patterns for Harnessing Claude's Intelligence(Agent Harness 设计的三种模式)
原文链接
https://claude.com/blog/harnessing-claudes-intelligence
作者
Lance Martin(Claude Platform 团队)
发布日期
2026-04-02
⚠️ 本页是原文的中文结构化整理笔记(保留架构、数据、案例、结论),并非逐字翻译。版本、参数与案例数字属于原文所示条件,不是本资料库的实测结果;产品状态与接口以实施时官方文档为准。
📑 本页目录

随着 Claude 能力的演进,围绕模型的软件脚手架(agent harness)也必须随之调整。开发者应当持续重新评估:哪些功能应该留在 harness 里,哪些 Claude 已经能独立胜任,并在智能收益与延迟、成本之间取得平衡。

先区分模型能力和外部工程职责,再看哪些工作可以直接依靠模型。

什么是 Agent Harness

Agent harness 指把原始模型智能转化为可用 Agent 的那一整套东西:循环(loop)、工具、上下文管理和护栏(guardrails)。Harness 设计是一门持续的实践——随着模型进步,不断判断哪些脚手架仍然必要。


模式一:依靠模型,而非 Harness(Lean on the Model, Not the Harness)

核心思想: 用 Claude 已经深度掌握的工具来构建应用。

给 harness 做减法与保留系统边界同时成立;减少限制不是撤销授权。

模式二:给 Harness 做减法(Strip Down Agent Harnesses)

核心思想: 持续追问哪些 harness 功能 Claude 现在已经可以自己管理。

2A. 让 Claude 编排自己的动作

2B. 让 Claude 管理自己的上下文

2C. 让 Claude 持久化自己的上下文

宝可梦游戏案例: Sonnet 3.5 玩了 14,000 步后把记忆当成流水账(31 个文件,还停留在第 2 个镇子);Opus 4.6 则把战术笔记组织成 10 个有条理的文件,拿到 3 个道馆徽章,并从失败中总结经验——体现了模型在信息取舍上的判断力进步。

模式三:谨慎设置 Harness 的边界(Set Boundaries Carefully)

3A. 设计上下文以最大化缓存命中

Prompt caching 可以把缓存 token 的成本降到输入 token 的 10%。优化原则:

3B. 用声明式工具服务于 UX、可观测性与安全


技术概念和基准数据帮助理解取舍,但原条件仍是判断能否迁移的前提。

关键技术概念

概念 说明
上下文窗口管理 Claude 无法自带对话历史,harness 每轮都要重新打包上下文,因此缓存至关重要
Breakpoints 提示词内的缓存检查点;新请求与已缓存内容前缀匹配时命中缓存
Compaction Claude 摘要历史上下文,在长交互中保持任务连续性
Tool Search 动态工具发现机制,以追加方式工作,不破坏缓存
Subagents 独立的 Claude 实例,用全新上下文窗口处理隔离任务

基准数据一览

结论与建议

  1. 持续重估: 随模型能力提升,定期检验关于其局限的假设。例如 Sonnet 4.5 需要的「上下文焦虑重置」到 Opus 4.5 就不再需要——变成了 harness 里的「死重」。
  2. 大胆修剪: 常问「我可以停止做什么?」,移除拖累性能的过时脚手架。
  3. 通用工具的复利: 编码基准上的强表现会迁移为通用 Agent 能力,因为代码是通用的编排语言。
  4. 渐进式披露原则: 不要预加载全部上下文,让 Claude 通过文件工具和 skills 按需获取信息。
  5. 资源效率: 善用缓存、context editing 和输出过滤,在保持性能的同时降低 token 消耗。

Harness 设计不是一次成型的,而是一门随模型智能演进而不断调整脚手架的持续学科——永远在问:这项职责应该归 harness 还是归模型?


✅ 检查点

  1. 本文三种 Harness 设计模式是什么?
  2. 给 Harness 做减法时,可以移走哪些职责?
  3. 做减法后仍需保留哪些边界?
👀 答案
  1. 依靠模型熟悉的通用工具;移除模型已能承担的冗余脚手架;谨慎设置 Harness 的边界。它们讨论职责分配,不是 ReAct、计划执行和反思三种循环。
  2. 可以试验把工具编排、输出过滤、上下文筛选与持久化交给模型,但要在同一组任务上比较质量、成本和恢复能力后再删去旧组件。
  3. 保留权限、可观测性、准确的工具契约与必要的人工控制;同时维护缓存前缀和上下文接口。分类器的判断不能替代执行环境的硬边界。

本节回顾

先记住这几件事

  • 三种模式是依靠模型、精简脚手架、谨慎设边界。
  • 每个组件都对应一个能力假设,用任务评测判断是否仍需要。
  • 移交编排职责时仍保留权限、日志、恢复和验收。