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 都内嵌一个小循环调模型看结果跑工具把观察喂回模型重复直到返回最终答案当构建者有意识地在这个行为之上搭建或堆叠新周期时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%免费】