企业级 Agent 工程指南

Harness Agent:企业级 Agent 运行底座与治理体系

连接模型、企业上下文、系统工具与治理机制,让 Agent 安全、可控地进入真实经营流程

企业真正要建设的,不是一个会调用模型的 Demo,而是一项能够进入业务流程、连接可信上下文、调用真实系统,并在权限、成本和质量边界内持续运行的 AI 能力。Harness 就是承载这项能力的运行与治理底座。

本书以开源 agent harness earendil-works/pi(pi)为贯穿全书的参考实现,并以 Agno 展示完整应用落地。我们从单个 Agent 的最小闭环出发,一路走到生产架构、多 Agent 编排、评估治理与持续运营。

全书核心判断 业务流程决定 Agent 要完成什么,Harness 决定它如何安全、可观测、可控制地持续运行。

从经营问题到可运行能力

一项完整的 AI 业务能力,需要把经营目标、业务状态和技术执行串成闭环。下面六层不是六套独立系统,而是 Harness 设计时必须同时回答的六组问题。

01
经营结果与业务触发

为什么做、由什么事件触发、如何判断结果。

02
目标流程与任务状态

哪些步骤由 AI 完成,哪些异常交回给人。

03
企业上下文与业务规则

连接必要的数据、知识、权限、历史与约束。

04
Agent Runtime 与编排

管理循环、状态、记忆、协作、重试和停止。

05
系统工具与执行接口

安全调用 ERP、CRM、OMS、浏览器与外部服务。

06
治理、评估与持续运营

观测质量、风险、成本与经营结果,并持续优化。

这不是框架文档,而是一份 Agent 系统设计与生产落地指南。每章遵循「先讲问题 → 再讲模式 → 用参考实现验证 → 与其他框架对比」。

目标读者

业务与产品负责人

理解业务能力如何进入流程,以及结果、边界和验收如何定义。

推荐:2 → 9 → 23 → 25 → 27 → 附录 D
Agent 开发者

从执行循环、工具和上下文开始,逐步构建可运行的 Agent。

推荐:1—16 → 23—28 → 35—43
平台与架构负责人

设计运行时、编排、观测、安全、多租户与发布体系。

推荐:5 → 8—12 → 16—29
治理与运营负责人

建立人机边界、评测基线、成本护栏和持续复盘机制。

推荐:25—29 → 附录 D → 附录 E

与《企业 Agent 落地指南》的关系

《企业 Agent 落地指南》回答“围绕什么经营问题建设 Agent,以及如何交付最小完整闭环”。
《Harness Agent》回答“如何把 Agent 建成稳定、可控、可治理的生产能力”。

内容结构

第一次系统学习,建议先读 前言,再按 Part 顺序推进;有明确职责或问题时,也可以直接使用上面的角色路线。

Part 1 · Agent 基础

Agent 的本质与最小闭环

Part 2 · 工具与扩展

让 Agent 拥有能力:工具、协议、结构化输出、技能、事件

Part 3 · 上下文与记忆

有限窗口下的上下文、记忆与知识库

Part 4 · 单 Agent 模式

让单个 Agent 更聪明:规划、反思、思维链

Part 5 · 多 Agent 编排

从单体到协作:编排、DAG、Swarm、Handoff

Part 6 · 高级推理

更强的推理范式:树搜索、辩论、研究—综合

Part 7 · 生产架构

把 Agent 送上生产:远程驱动、可观测性

Part 8 · 企业级特性

预算、治理、安全、多租户

附录