Agent架构三层拆解:Harness、Loop、Graph一次讲透
2026/7/28 19:23:15 网站建设 项目流程

同一个模型,为什么有的团队能跑生产,有的团队还在 demo 里打转?答案藏在三层架构里。

一、先说结论:三层不是同义词

很多人把 Harness Engineering、Loop Engineering、Graph Engineering 当成同一件事的三个叫法。它们确实都围着同一个模型转,都影响可靠性,也都可能包含"循环"。但它们描述的是三种不同的工程决策

这个区分,在 Agent 离开 demo notebook、开始碰文件、调 API、服务客户、跑生产代码的那一刻,就变得至关重要。

30 秒答案:

Harness Engineering(线束工程):构建模型外围的机器——工具、记忆、沙箱、权限、可观测性

Loop Engineering(循环工程):设计反复的"工作-反馈"周期——验证循环、事件循环、改进循环

Graph Engineering(图谱工程):把工作流拓扑显式化——节点、分支、汇合、状态转移、受控循环

最干净的心智模型是:环境 → 反馈 → 流。

三层各管一层,缺一不可。


二、为什么这三个词突然重要了

一个裸语言模型什么都干不了——它不能创建项目状态、不能跑测试、不能看浏览器、不能执行审批规则、不能重启失败任务。这些能力来自它所处的环境

随着 Agent 软件成熟,一套标准工程栈正在成形:

底层是Agent Harness——真正运行模型的代码

中间是Loops——处理重复执行和质量检查

上层是Graphs——映射引导整个流程的结构化路径

标签还没完全标准化。"Agent harness"在当前框架里开始有了相对具体的定义;"Loop engineering"是 2026 年实践者中兴起的新词;"Graph engineering"应被理解为实践方法,而非学术领域——它就是把 Agent 工作流做成显式有向图或状态机。

这个实践区分很有用,因为它能防止一个流行词掩盖真正的设计问题。


三、Harness Engineering:模型之外的一切

LangChain 的定义很直接:Agent = 模型 + Harness。Harness 是模型之外的代码、配置和执行逻辑。

实践中,这包括:系统提示、工具定义、记忆、文件系统、沙箱、模型路由、交接、中间件钩子、上下文压缩、权限、日志、验证接口。

OpenAI 的 Agents SDK 从运行时视角描述同一个核心:Runner 调用模型、执行工具、处理交接、携带状态,直到运行到达真正的终止条件。

"Harness"这个词为什么有用?

因为它把注意力从"模型崇拜"上移开。两个团队用同一个基座模型,结果可能天差地别——一个给模型干净的工具、稳定的工作区、受限的权限、可观测的状态;另一个给个模糊提示和不可靠的 API 包装。智能可能差不多,工作条件天差地别

一个严肃的 Harness 通常包含:

上下文注入:指令、检索到的事实、对话状态、技能、任务策略

动作面:API、浏览器、Shell、代码解释器、数据库、MCP 兼容工具

持久化:文件、检查点、会话、进度日志、git 历史、长期记忆

执行控制:超时、重试、预算、模型路由、子 Agent 生成、审批门

安全治理:权限、隔离、白名单、密钥处理、人工授权

可观测性:trace、工具输入输出、状态转移、成本、延迟、评估结果

一个简单的判断方法

:把模型从架构图里拿掉。剩下的所有东西——工具、数据访问、状态存储、沙箱、中间件、评估器、重试策略、UI——大概率都属于 Harness。

Harness 工程在哪里真正值钱?

长任务。Anthropic 在多会话编码中发现,单纯靠上下文压缩不够。他们做的是一套更好的工作系统:初始化器、进度文件、git 历史、增量工作纪律——让每个新上下文都能理解"发生了什么、还剩什么"。这不是更好的提示词,而是更好的工作条件。

当 Agent 缺能力、丢状态、访问过多、无法审计、在不同环境表现不一致时——修 Harness


四、Loop Engineering:把一次性指令变成受管过程

每个用工具的 Agent 都内嵌一个小循环:

  1. 调模型

  2. 看结果

  3. 跑工具

  4. 把观察喂回模型

  5. 重复,直到返回最终答案

当构建者有意识地在这个行为之上搭建或堆叠新周期时,Loop Engineering 就开始了。

OpenAI 把它叫做"循环的堆叠",不是一条魔法 while 语句。三种典型循环:

验证循环:Agent 产出制品 → 跑确定性检查或评分器 → 收到明确反馈 → 仅在有证据错误时重复

事件驱动循环:调度、webhook、新文档到达时唤醒 Agent

改进循环:分析 trace 和失败 → 修改指令/工具 → 测试新版本是否更好

LangChain 2026 年的框架把它们称为循环栈

一个工程化循环的解剖:

触发器:什么启动下一轮——用户请求、调度、测试失败、新数据、评估反馈

目标:要到达的具体状态,不是"继续改进"这种模糊指令

状态与记忆:下一轮需要知道什么,而不必重放全部

动作策略:Agent 可以改什么、调什么、委托什么、花多少

证据:测试、schema 校验、引用、diff、指标、人工审查

反馈:关于"证据为什么失败"的紧凑、可操作的描述

停止规则:成功、预算耗尽、超时、不可恢复错误、人工升级

关键原则:不要循环置信度,循环证据。

"Agent 说它做完了"不是停止条件;"测试通过、链接可达、schema 校验通过、审查者批准"才是。

为什么 Loop Engineering 不是 Prompt Engineering?

提示告诉模型调用期间做什么。循环指定系统调用之后做什么:如何观察结果、选择反馈、决定是否继续、持久化进度、终止。

提示质量仍然重要,但循环把一次性指令转换成了受管过程。主要权衡是成本和延迟——每个评分器、审查者、重试都多一次模型调用或工具运行。Anthropic 的建议是:优先用能跑通的最简架构,只在性能提升证明值得时才加 Agent 复杂度。循环同理:在失败成本高于验证成本的地方加循环。


五、Graph Engineering:让控制流显式且可检查

Graph Engineering 问的是另一个问题:不只是 Agent 做什么,而是接下来允许哪个组件运行

步骤用节点表示,允许的步骤用边表示。这些边可以表示顺序、条件分支、并行扇出、汇合、循环、人工中断。状态在图上遍历,拓扑让期望的控制流可以被检查。

LangGraph 是面向长运行、有状态 Agent 的低层编排基础设施,支持持久化执行、状态、人在环控制,显式聚焦于对 Agent 的控制,而非对工作流的抽象

Microsoft AutoGen 的文档更直白:当你需要精确控制 Agent 顺序、不同结果走不同下一步、确定性分支、带循环的复杂多步流程时——用图。

图谱工程师实际决定的:

节点边界:哪些工作属于确定性函数、LLM 调用、专家 Agent、人工审查

状态 schema:每个节点可读/可写什么,并行更新如何合并

路由条件:什么证据让工作前进、后退、旁路、升级

并发:什么能并行、什么必须汇合、什么共享资源需要协调

循环与出口:哪里允许重试、允许几次、什么让循环安全

持久化:检查点在哪里、中断后如何恢复

重要区分

:这里的"图谱工程"是工程化基于图的执行,不是知识图谱工程(图中表示数据里的实体和关系)。工作流图表示的是控制和状态转移

什么时候值得用图的"仪式感"?

当流程有有意义的分支、并行工作、审批、恢复路径、多个专家 Agent 时,图有价值。当任务只是"给一个 Agent 三个工具让它干活"时,图用处不大。

图能改善调试,但也可能过早冻结假设。如果模型必须动态发明计划,强行把每条可能路径画进图里,反而会让系统更脆弱。


六、三层如何在一个真实系统里协作

考虑一个"研究并发布"Agent,负责产出一份事实性行业简报。

注意这里的嵌套关系

Graph 运行在 Harness 内

一个或多个 Loop 生活在 Graph 内

Harness 为这些 Loop 提供 state、tools、evaluators

类别有重叠,因为软件层有重叠。但每一层都给团队一个不同的杠杆——当系统失败时,你知道该拉哪一个。

按失败诊断选工程层:

Agent 无法安全访问正确的数据/工具 →Harness(工具契约、权限、沙箱、上下文注入)

Agent 跨会话忘记进度 →Harness(持久状态、检查点、进度制品、压缩)

第一次尝试通常接近但不可靠 →Loop(外部评分器、确定性测试、反馈、有界重试)

Agent 在成功后继续工作或在证明前停止 →Loop(基于证据的终止状态、预算感知停止规则)

多个专家必须按受控顺序运行 →Graph(显式节点、边、路由条件、汇合)

多步流程中失败难以定位 →Graph + Harness(与图节点和转移对齐的有状态 trace)

工作流变得太频繁,固定图跟不上 →更简单的 Harness(保持控制模型驱动,延迟图的形式化)


七、弱 Agent 架构背后的昂贵错误

错误一:还没理解工作就开始画图

团队有时在观察一个强 Agent 实际如何解决问题之前,就把业务流程翻译成几十个节点。先从更简单的 Harness 拿到 trace,再形式化稳定路径。

错误二:让同一个模型既写又评,没有防护

自评有用,但容易被共享盲点击穿。优先用确定性检查、分离审查者上下文、对高影响动作要求人工批准。

错误三:用"继续试"当循环规格

无界重试循环是成本漏洞。每个循环都需要:可测量的目标、新鲜证据、最大尝试次数、命名的升级路径。

错误四:把 Harness 当垃圾场

更多工具和记忆不自动等于更好。拥挤的工具集抬高选择错误,嘈杂的上下文抬高混乱,宽泛的权限抬高风险。

错误五:把编排失败归咎于模型

模型无法可靠补偿:过期状态、模糊工具 schema、坏掉的 API、缺失的退出条件。改进拥有失败的那一层。


八、生产级设计清单

Harness:工具是否窄、文档化、可观测?状态是否持久?权限是否最小特权?运维能否暂停、检查、恢复一次运行?

Loop:什么证据证明成功?失败时返回什么反馈?允许多少次重试?预算耗尽时怎么办?

Graph:哪些路径必须确定性?哪里可以并行?哪些状态共享?人工门和恢复路径在哪里?

评估:团队能否重放真实 trace、对比版本、把改进归因到具体改动而非直觉?

运维:生产中是否监控成本、延迟、失败率、干预率、任务级成功率?


九、写在最后

Harness Engineering 让模型能运作。Loop Engineering 让方法可迭代、可验证、可恢复。Graph Engineering 让复杂执行路径显式且可控。

三者互不替代。

Harness 丢了状态,图画得再漂亮也没用。Harness 再好,没有证据和停止规则,就是在烧钱。Loop 再精巧,分支、并行、审批都塞在 ad-hoc 代码里,照样难运维。

当这三层被联合设计,并且团队清楚每一层要解决什么问题时,可靠的 Agent 系统才会真正长出来。

环境给模型工作条件,反馈让方法可迭代,流让复杂路径可控。
三层各司其职,缺一不可。

学AI大模型的正确顺序,千万不要搞错了

🤔2026年AI风口已来!各行各业的AI渗透肉眼可见,超多公司要么转型做AI相关产品,要么高薪挖AI技术人才,机遇直接摆在眼前!

有往AI方向发展,或者本身有后端编程基础的朋友,直接冲AI大模型应用开发转岗超合适!

就算暂时不打算转岗,了解大模型、RAG、Prompt、Agent这些热门概念,能上手做简单项目,也绝对是求职加分王🔋

📝给大家整理了超全最新的AI大模型应用开发学习清单和资料,手把手帮你快速入门!👇👇

学习路线:

✅大模型基础认知—大模型核心原理、发展历程、主流模型(GPT、文心一言等)特点解析
✅核心技术模块—RAG检索增强生成、Prompt工程实战、Agent智能体开发逻辑
✅开发基础能力—Python进阶、API接口调用、大模型开发框架(LangChain等)实操
✅应用场景开发—智能问答系统、企业知识库、AIGC内容生成工具、行业定制化大模型应用
✅项目落地流程—需求拆解、技术选型、模型调优、测试上线、运维迭代
✅面试求职冲刺—岗位JD解析、简历AI项目包装、高频面试题汇总、模拟面经

以上6大模块,看似清晰好上手,实则每个部分都有扎实的核心内容需要吃透!

我把大模型的学习全流程已经整理📚好了!抓住AI时代风口,轻松解锁职业新可能,希望大家都能把握机遇,实现薪资/职业跃迁~

这份完整版的大模型 AI 学习资料已经上传CSDN,朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询