AI Agent 基础架构解析:从 LLM 到 ReAct 循环与 Harness 工程的工程化路径

发布时间:2026/8/31 5:22:42

AI Agent 基础架构解析:从 LLM 到 ReAct 循环与 Harness 工程的工程化路径
AI Agent 基础架构解析从 LLM 到 ReAct 循环与 Harness 工程的工程化路径本文基于开源技术书《深入理解 AI Agent》第一章系统梳理 AI Agent 的核心架构组件、运行机制和工程设计原则。该章从多个真实 Agent 产品出发建立了对 Agent 的工程化理解框架涵盖核心公式、ReAct 循环、Harness 工程以及从工作流到自主 Agent 的编排模式。Agent 的工程公式LLM 上下文 工具现代 Agent 的最小工程实现可以用一个公式表达Agent LLM 上下文 工具。这三个组件不是抽象的理论概念而是具体的工程组件LLM 是大脑决策内核其能力来自预训练积累的世界知识与后训练固化的决策策略。上下文是眼睛Agent 在每个决策点收到并保留的信息表示包括环境观察、用户记忆、领域知识和任务进展。工具是手脚Agent 用来感知或改变外部世界的接口。在强化学习视角下Agent 与 Environment 是闭环交互的两方。环境不断返回观察Agent 根据上下文选择行动行动改变环境状态新状态产生下一次观察。这个闭环是理解所有 Agent 交互的最小结构。图1-1 给出了两个抽象层次。外层是 Agent 与 Environment 的交互关系内层是 Agent 的 Model-Harness 结构Model 负责策略决策Harness 是环绕模型的运行与治理层负责构造上下文、暴露工具接口、维护循环和状态并实施权限、验证与纠正。观察空间与动作空间能力扩展的核心杠杆该章提出了一个关键的工程判断在底层模型固定时提升 Agent 任务表现最主要的系统工程手段往往就是重新定义或扩展观察空间与动作空间。许多看似需要更聪明模型的问题实际上只是接口问题——把任务所需的数据纳入上下文或把完成任务所需的操作封装成工具原本不可解的任务就可能变得可解。以 Manus 和 OpenClaw 为例两者的演进本质上都是观察空间和动作空间的扩展。Manus 把深度调研、代码生成和电脑操控三条原本独立的路线合并到同一个 Agent 中OpenClaw 则通过 WhatsApp、Telegram 等消息渠道和本地 Gateway把接口延伸到用户的整个数字生活。五类工具体系工具按 Agent 与外界互动的方向分为五类感知工具让 Agent 访问信息搜索引擎、文件系统、API执行工具让 Agent 改变世界代码执行、文件操作、系统命令协作工具让 Agent 与其他 Agent 分工合作委托子 Agent、请求人类确认事件触发工具外部输入驱动 Agent 开始执行新邮件、定时器、Webhook用户沟通工具Agent 主动与用户传递信息文字消息、语音通话、邮件工具调用Tool Calling的流程分四步在上下文声明工具可用性、模型自主决定调用、框架执行工具、结果追加到上下文。开发者只需定义工具和执行工具调用模型自主完成要不要调用、调哪个、传什么参数的决策。ReAct 循环Agent 的核心运行机制Agent 执行任务的核心模式是 ReActReasoning Acting包含三个环节模型先思考当前该做什么然后调用工具行动再观察工具返回的结果并继续思考。这个想-做-看的循环不断重复直到任务完成。每次调用 LLM 时的完整上下文由两部分组成静态前缀系统提示词 工具定义和轨迹动态消息历史包括用户消息、模型回复和工具执行结果。这揭示了一个关键事实Agent 的上下文 静态前缀 轨迹。![外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传](https://img-home.csdnimg.cn/images/20230724024159.png?origin_urlimages%2Ffig1-4.pngpos_idimg-6ezs6U8J-1787973744736以一个多币种收入汇总任务为例Agent 的执行过程展现了完整的 ReAct 轨迹用户提出需求后模型先思考需要将不同货币转换为统一单位然后并行调用三次货币转换工具获得结果后继续思考并调用代码解释器进行汇总计算最后生成最终答案。整个过程只用了 3 次迭代、4 次工具调用。消融实验上下文组件的贡献差异该章通过实验 1-1 的消融实验Ablation Study系统验证了上下文各组件的作用。实验从五个上下文组件中选取四个进行测试结果揭示了一个重要洞察各组件并不等价衡量的标准是它承载的信息能否从别处重建。工具定义是行动能力的基础缺失它 Agent 无法调用工具——但模型仍会给出格式工整的答案数据却来自参数记忆工具执行结果是闭环控制的关键缺失会让 Agent盲目执行反复重试直到耗尽迭代预算思考过程记录为什么这么做可以从工具结果重建时丢弃几乎无代价历史消息防止冗余操作避免重复犯错这个实验的核心洞察是上下文决定了 Agent 能看到什么而 Agent 只能基于它看到的信息做决策。更值得警惕的是“给出了回答不等于完成了任务”——上下文残缺时典型的失败不是报错退出而是一个看上去毫无破绽的错误答案。Harness 工程模型之外的竞争力从 Harness 工程视角看可以把 LLM 抽象为核心组件 Model把 Agent 边界内负责支撑模型运行的代码、配置和服务统称为 Harness。生产形态下的完整组成是Agent Model HarnessHarness 上下文管理 工具接口 约束 验证 纠正最小 Demo 只需 Model 和能构造上下文、暴露工具的 Harness生产系统还要在同一边界内加入约束、验证和纠正。五个功能构成一个闭环上下文与工具让 Agent能做事约束预防错误验证发现偏差纠正使闭环得以形成三者共同让 Agent不做错事。以 Claude Code 为例其 Harness 中绝大部分代码都是约束、验证和纠正而非上下文与工具。这些机制包括流程状态管理、多层上下文压缩、权限分类、熔断器和错误恢复机制。行业正在从能做事向可靠地做事转变Harness 工程因此成为 Agent 系统的核心竞争力。工程范式的演进该章梳理了 AI 应用工程的演进弧线提示工程优化输入指令提升输出质量上下文工程系统管理模型能看到的所有信息Harness 工程扩展到 Agent 如何组织模型运行并与环境交互Loop 工程从单次运行扩展到跨轮次持续自主运转Graph 工程把 Agent 循环组织成显式的执行图这五个阶段是层层包含关系每一层都在前一层基础上扩展了工程师的关注范围。构建有效 Agent 的三个原则根据 Anthropic 的经验成功的 Agent 系统遵循三个核心原则保持简单从最简单的方案开始只在确实必要时才增加复杂度保持透明明确显示 Agent 的规划步骤、执行日志和决策轨迹设计好工具接口ACI从 Agent 视角设计接口采用防呆Poka-yoke思路让错误无法发生编排模式工作流与自主 Agent该章区分了两种编排模式。工作流通过预定义的代码路径编排 LLM 和工具执行路径是确定性的。其优势在于严格的流程控制和安全性——提示注入最多只能影响当前节点无法让 Agent 跳到不该执行的分支。局限是缺乏变通性。自主 Agent的执行路径不是预先定义的而是根据环境反馈实时决定。它本质上是在一个循环中使用工具的 LLM通过持续获取环境反馈推进任务。实践中两者常常混合使用关键且需严格合规的流程用工作流需要灵活决策的部分切换到自主模式。选择编排模式的关键不是框架本身的复杂度而在于它能否用尽可能少的抽象层让你专注于业务逻辑。护栏与安全性该章建立了全书统一的分层安全骨架。护栏按被绕过的难度分为三层上下文层管模型能看到什么在内容进入上下文前拦截相关性分类器、安全分类器、内容审核、规则保护执行层管模型能做什么在动作生效前验证工具风险评级、沙盒隔离、人在回路、输出检查数据层管世界最终能被改成什么样由稳定的、经过人类审查的机制强制执行数据库行级安全、约束与校验器一个结构性判断是处在同一个上下文里的 Agent很难判断自己是否已经被注入。因此上下文层只能降低攻击成功率给不出保证——这正是必须有下面两层的原因。五个贯穿全书的设计模式该章命名了五个将在后续章节反复使用的设计模式提议者-审核者产出与评判由两个不共享上下文的角色分别承担成立前提是自审不可靠渐进式披露先给可检索目录再按需加载细节同时优化上下文预算与选择精度只增不改状态以追加方式演进换来可缓存、可重放、可审计边界集 保留集任何修改都要在应改变和不应影响两组样本上验证最小 diff 可回滚每次修改尽量小、带来源、可单独回滚小结第一章建立了理解和构建 AI Agent 的基础框架。其核心要点包括Agent 的最小工程实现是 LLM 上下文 工具扩展观察空间和动作空间是模型固定时最有效的工程杠杆ReAct 循环是串联三大组件的核心机制Harness 工程约束、验证、纠正是模型能力商品化后的核心竞争力从工作流到自主 Agent 的编排选择应遵循从简单到复杂的原则。这些框架为后续章节的具体技术展开提供了统一的概念参照坐标。本文内容整理自开源技术书《深入理解 AI Agent》(bojieli/ai-agent-book)采用 Apache 2.0 许可证

相关新闻

基于YOLO26输电线异物检测系统1:输电线异物检测数据集说明(含下载链接)

基于YOLO26输电线异物检测系统1:输电线异物检测数据集说明(含下载链接)

2026/8/31 5:22:42

一. 前言 本篇博客是《基于YOLO26输电线异物实时检测系统》系列文章之《纸板缺陷检测数据集说明(含下载链接)》,网上有很多输电线异物检测数据集的数据,百度一下,一搜一大堆,但质量参差不齐,很多不能用,即…

翁恺c语言 10.0

翁恺c语言 10.0

2026/8/31 5:22:42

第一个是目的,第二个是源。

字节跳动后端面试全流程复盘:三轮技术面+HR面,附高频考点与学习资料

字节跳动后端面试全流程复盘:三轮技术面+HR面,附高频考点与学习资料

2026/8/31 5:22:42

有人问我字节的面试到底难不难,我可以很负责任地说:难,但不是难在题目本身,而是难在它考察的维度太立体了。我刚拿到字节跳动后端开发工程师的offer,一路走完三轮技术面加一轮HR面,整个人像被扒了一层皮&am…

深度强化学习德州扑克AI:NFSP自博弈与不完全信息博弈实战

深度强化学习德州扑克AI:NFSP自博弈与不完全信息博弈实战

2026/8/31 6:22:44

简介:本资源是一套面向计算机、人工智能及相关专业本科生与初学者的深度强化学习实践项目,聚焦德州扑克这一经典不完全信息博弈场景,提供从环境建模、策略网络设计到训练评估的完整AI算法优化方案,适用于毕业设计、课程大作业及算…

途虎养车2023秋招Java笔试题A卷全解析与备考指南

途虎养车2023秋招Java笔试题A卷全解析与备考指南

2026/8/31 6:22:44

途虎养车2023秋招Java笔试试卷A,这套名字在校招群里被转了不少次。作为一个从2019年就开始带校招、自己也刷过无数套笔试题的老开发,我拿到这套卷子的第一反应是:出题人确实懂业务。整套卷子没有偏题怪题,但想拿高分真不容易&…

阿里达摩院开源AI选股框架:本地部署与量化策略回测实战

阿里达摩院开源AI选股框架:本地部署与量化策略回测实战

2026/8/31 6:22:44

这次我们来看一个来自阿里达摩院的AI选股工具。它不是那种需要付费订阅的量化平台,而是一套可以本地运行的Python源码。核心价值在于,它提供了一个基于机器学习的选股框架,你可以用它来测试自己的策略,或者作为学习量化投资的起点…

网约车一口价订单乘客迟到?司机无责取消实操指南

网约车一口价订单乘客迟到?司机无责取消实操指南

2026/8/31 6:22:44

遇到一口价订单乘客迟到,很多司机的第一反应是“再等等吧,都到楼下了”。可实际跑过网约车的人都知道,一口价订单本身单价就低,乘客如果还踩着点出门、迟到三五分钟,这单基本上就是贴着成本在跑,甚至可能倒…

2025款马自达EZ-6澳洲全面测试:传统车企的电动化答卷

2025款马自达EZ-6澳洲全面测试:传统车企的电动化答卷

2026/8/31 6:22:44

2025款马自达EZ-6澳洲全面测试:这匹“电动马”到底能不能打? 如果你的选车清单里同时出现过“马自达”和“新能源”,那你大概率经历过一段纠结期:马自达的燃油车操控口碑一直在线,但电动化产品却迟迟没有真正进入主流…

Simulink与Simscape的区别:从信号流到物理网络建模

Simulink与Simscape的区别:从信号流到物理网络建模

2026/8/31 6:12:44

收到,这篇我们直接切入正题。Simulink 是大部分 MATLAB 用户接触仿真最先打开的模块,拖几个正弦波、增益、示波器,一个信号流模型就跑起来了。但当你开始做机电系统、液压系统、电力电子、多体动力学仿真时,会发现 Simulink 里搭微…

备战数据库管理工程师校招:索引、事务、备份恢复核心考点解析

备战数据库管理工程师校招:索引、事务、备份恢复核心考点解析

2026/8/31 1:38:25

每年校招季我都会接触不少准备数据库方向笔试的同学,看到最多的状态就是:简历上写着“熟悉 MySQL”“了解索引优化”,一碰到数据库管理工程师的笔试卷,却在索引、事务、锁、备份恢复这些题目上翻车。网易这套 2018 校园招聘数据库…

数字电路时序基石:深入理解建立时间与保持时间

数字电路时序基石:深入理解建立时间与保持时间

2026/8/30 0:01:07

1. 这不是“背公式”的事:时间参数到底在约束什么你翻过数字电路教材,一定见过这两个词:建立时间(Setup Time)和保持时间(Hold Time)。它们常被并列写在触发器(Flip-Flop&#xff09…

蓝桥杯国赛超声波测距机:从单片机原理到嵌入式系统实战

蓝桥杯国赛超声波测距机:从单片机原理到嵌入式系统实战

2026/8/30 0:01:07

1. 项目缘起:从赛题到超声波测距机的诞生第八届蓝桥杯单片机设计与开发国赛的题目,我至今记忆犹新。它没有直接给出一个花哨的名字,而是用“超声波测距机”这个朴实无华的功能描述,精准地勾勒出了考核的核心。对于当时备赛的我而言…

MCU无DAC如何用定时器+DMA 2D输出高保真任意波形

MCU无DAC如何用定时器+DMA 2D输出高保真任意波形

2026/8/31 0:02:27

接到一个仪表类项目,要在 LAT1189 上输出几种不同波形:正弦、三角、带可调死区的脉冲,频率和幅度都得能实时改。板子上没有 DAC,就一个定时器加几个 DMA 通道。我一开始觉得在定时器中断里改比较寄存器也能应付,后来把…

Cortex-M3 Flash下载失败?从编程错误标志到供电瞬态排查

Cortex-M3 Flash下载失败?从编程错误标志到供电瞬态排查

2026/8/31 0:02:27

前两周调试一块带着Cortex-M3内核的板子,IDE里下载固件时突然弹出一行刺眼的错误: error: flash download failed - cortex-m3 。这种报错在嵌入式开发里太常见了,常见到很多人第一反应就是换根数据线、重插一下调试器,但重启三…

STM32 TouchGFX屏幕切换Transition优化:原理、配置与排障实战

STM32 TouchGFX屏幕切换Transition优化:原理、配置与排障实战

2026/8/31 0:02:27

做STM32 GUI开发的朋友应该都有体会——界面搭得再漂亮,一旦屏幕切换卡成PPT,整个产品的档次瞬间就没了。早期我在LAT1212这个基于STM32的GUI工程上用TouchGFX做二次开发,最头疼的不是画界面,而是怎么让切换动画既流畅又自然。Tou…

摆脱论文困扰!盘点2026年全网爆红的的AI论文写作工具

摆脱论文困扰!盘点2026年全网爆红的的AI论文写作工具

2026/8/28 7:35:26

一天写完毕业论文在2026年已不再是天方夜谭。2026年最炸裂、实测能大幅提速的AI论文写作工具,覆盖选题构思、文献整理、内容生成、格式排版等核心场景,真正帮你高效搞定论文难题。 一、全流程王者:一站式搞定论文全链路(一天定稿首…

导师推荐!2026最新AI论文工具测评与实用推荐

导师推荐!2026最新AI论文工具测评与实用推荐

2026/8/28 7:34:51

2026年真正好用的AI论文工具,核心看生成的论文质量、低AI味、格式正确、学术适配四大指标。综合实测,千笔AI、ThouPen、豆包、DeepSeek、Grammarly 是当前最值得推荐的梯队,覆盖从免费到付费、从中文到英文、从文科到理工的全场景需求。 一、…

告别游戏崩溃:XCOM 2模组管理器的智能革命

告别游戏崩溃:XCOM 2模组管理器的智能革命

2026/8/28 7:34:35

告别游戏崩溃:XCOM 2模组管理器的智能革命 【免费下载链接】xcom2-launcher The Alternative Mod Launcher (AML) is a replacement for the default game launchers from XCOM 2 and XCOM Chimera Squad. 项目地址: https://gitcode.com/gh_mirrors/xc/xcom2-lau…