根据 Anthropic 的经验,成功的 Agent 系统遵循三个核心原则。
**保持简单**。从最简单的方案开始,只在确实必要时才增加复杂度。直接的 API 调用优于复杂的框架,清晰的代码优于聪明的抽象。因为每多一层抽象都会成为以后调试时新的盲区。
**保持透明**。明确显示 Agent 的规划步骤、执行日志和决策轨迹------这不只是为了调试方便,也是让用户建立信任的前提。因为黑箱里的错误一旦发生,外部观察者既无法定位也无法纠正。
**设计好工具接口(ACI,Agent-Computer Interface)**。ACI 强调的是从 Agent 视角设计接口(让 Agent 容易理解和使用),而非传统 API 从程序员视角设计接口。工具的命名和参数要直观,容易误用的地方要主动防呆,从设计上让错误无法发生------比如 USB 接口只能从一个方向插入,就避免了用户插反的错误。这种"用设计消除错误"的思路在制造业里有一个专门的术语,叫**防呆**(Poka-yoke),源自丰田生产体系。设计不好的工具会让再强的模型也频繁出错------因为模型与工具之间唯一的沟通通道就是接口本身,模糊的接口会被模型放大成系统性的错误。
以下三节展开 Harness 工程中三个独立但重要的主题:模型选型、编排模式、护栏与安全性。它们都不属于 Harness 五要素本身,但是工程实践中绕不开的决策。