ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Agentic Collaboration架构设计与落地:从单Agent到多智能体协作

Agentic Collaboration架构设计与落地:从单Agent到多智能体协作 1. 为什么单Agent总在玩具demo和勉强能用之间反复横跳上个月和一个做企业交付的朋友聊起Agent落地他吐槽了一句话让我印象很深单Agent写周报、做总结、查资料都很好使但只要一接到需要跨部门流转的真实业务流程立刻变回人工智障。这句话基本概括了当前企业AI落地最真实的痛点单Agent的能力上限摆在那里不是模型不够聪明而是职责边界、上下文、工具权限全都搅在一起。你可以让一个Agent帮我把本周所有项目的风险汇总成报告它大概率能写得像模像样但你让它帮我走完从需求确认、排期评估、资源协调到风险上报的完整流程它就会开始一本正经地编造资源数据或者卡在某个中间步骤反复重试把整个链路拖死。1.1 一个典型的什么都懂一点的Agent到底缺了什么我先拆一个真实的边缘案例给你看。假设你给一个Agent下达了这样一个任务协调A项目的上线排期。单Agent内部大致是这么走的理解任务需要知道A项目的当前进度、关键里程碑、涉及哪些团队。检索信息从知识库拉取项目文档、从项目管理工具拉取任务列表。决策判断是否存在资源冲突、是否需要调整排期。执行发送通知、更新任务计划、把结论写入文档。看起来逻辑完整但放到真实企业环境里问题立刻暴露出来。第一个问题上下文窗口装不下全量信息。一个中型项目的文档、历史决策、上下游依赖关系Token量级轻松超过模型上下文上限于是Agent只能截断、摘要、或者干脆凭经验补全这一步就是幻觉的高发区。第二个问题权限失控。如果这个Agent同时拥有读取财务数据、修改业务系统、发送对外通知的权限一旦规划阶段出现偏差它可能在你还没发现之前就把错误排期同步给了所有相关方。第三个问题也是最要命的责任归属消失。排期调整这个动作在真实业务里需要产品、研发、测试、运维各自确认每一个确认节点本身就是一段独立的上下文和决策逻辑。硬塞给一个Agent统一处理等于让一个实习生同时扮演四个部门负责人它不出错才奇怪。所以单Agent适合的是那些信息密度低、决策路径短、动作单一的轻量任务。一旦进入跨系统、跨角色、带人工审批的流转型业务核心矛盾不是模型能力而是架构上没有为职责边界和上下文隔离做好设计。1.2 从单Agent到协作不是功能叠加是范式切换很多人以为Agentic Collaboration就是多接几个Agent让它们互相发消息。这个理解方向对但设计逻辑全错。如果你只是把同一套System Prompt复制到多个Agent上然后让它们互相聊天最后得到的不是协作而是一场没有主持人的头脑风暴——每个Agent都在用自己的完整世界观解读局部信息很快就会发现上下文互相污染、结论互相矛盾、责任边界完全模糊。我个人的理解是从单Agent到Agentic Collaboration本质上是从全能个体到专业分工的组织的转变。它借用了现代组织管理中最基本的思路拆解流程、明确岗位、划定权限、建立标准化的沟通机制。一个Agent不再需要什么都会它只需要在一个足够窄的职责域内做到可靠然后把结果通过协议化的方式交给下一个环节。这个思路带来的直接收益有三个。一是可靠性大幅提升每个Agent只需要在一个小范围任务上做到高准确率比一个Agent硬扛全流程可靠得多。二是可审计性变强任何一次业务流转都能清楚看到是哪个Agent、在哪个环节、基于什么输入做出了什么决策。三是演进成本降低某一个环节的Agent能力升级不会牵连整个系统重构只需要保证输入输出协议不变即可。如果你正在规划企业级AI工作流我建议你先做一个思维转换不要问这个Agent能不能完成整个任务而要问这个任务应该被拆成哪几个独立决策点每个决策点需要什么信息和权限。前者是功能视角后者是架构视角。Agentic Collaboration真正值钱的地方恰恰是这个架构视角。2. Agentic Collaboration架构的本质从会说话到会共事我一直有个观点让两个Agent对话这件事本身没有技术难度难的是让它们在对话之后还能对业务结果负责。日常开发里我们经常听到Agent协作被描述成让多个Agent像人类同事一样聊天。这个说法很形象但也很误导。人类同事之间之所以能高效协作靠的不仅仅是语言还有公司制度、岗位说明、汇报关系、项目章程这些看不见的约束。Agent协作要跑得稳同样需要把这类约束显式构建到系统里。2.1 三种常见协作范式与适用场景我在实际项目中观察到当前真正能落地的主流协作范式有三类按成熟度排序分别是编排式、协议式、生态式。**编排式Orchestration**是目前企业落地最稳的选择。它的核心是一个中心化的协调者负责拆解任务、调用各子Agent、汇总结果。各个子Agent之间不直接通信所有信息都通过协调者中转。优点是控制力强、状态统一、方便审计缺点是协调者本身可能成为瓶颈而且对协调者的规划能力要求很高。打个比方这就像项目集经理模式——所有小组向项目经理汇报由项目经理统一调度。我见过很多企业AI工作流的第一个稳定版本都是这么跑的因为出问题了你至少知道去哪里查日志。**协议式Protocol-based Collaboration**是更接近去中心化组织的形态。每个Agent是独立节点通过一套约定好的消息协议直接交换数据。比如A Agent完成需求解析后把结构化结果发布到Team的共享空间B Agent订阅到这个结果后自动触发下一阶段处理。这种模式好在灵活度高适合业务流程经常调整、Agent职责边界清晰、但具体流转路径不固定的场景。代价是需要预先定义好一套足够健壮的数据协议否则每个Agent之间两两联调复杂度是组合爆炸级别的。**生态式Agent Ecosystem**是更远期的形态类似应用商店模式。Agent以服务的形式注册到平台其他Agent通过服务发现机制按需调用。这个模式我目前只在大型平台类项目里见到过雏形它的核心价值是让业务方像选SaaS一样选Agent能力而不是把全链路都攥在自己手里。三种模式没有绝对优劣核心判断依据是你的业务控制力需求。如果合规审计是硬要求编排式是首选如果业务流程天然就是事件驱动的协议式更合适如果你想构建开放生态那就得考虑生态式。2.2 为什么让Agent自己开个会通常会翻车顺着上面说的你会发现让Agent们自己开会讨论这个想法其实非常危险。我见过不止一个团队在早期尝试这种自由讨论模式结局几乎无一例外Agent们非常礼貌地各说各话讨论几十轮之后得出一个看起来合理、实际上完全偏离目标的结论而且整个过程不可复现、不可审计。为什么缺少统一的评估函数。人类开会时有主持人控制议题方向有决策规则决定结论归属Agent自由讨论时没有任何一个机制保证讨论收敛到业务目标模型的自回归特性反而会让讨论沿着对话惯性跑偏——后续内容被前面的内容锚定久而久之整个讨论串就会离原始任务越来越远。上下文被无关信息污染。每个Agent带入了自己的历史对话、角色设定、局部视角这些信息在协作场景下不是资产而是噪声。A Agent说根据成本数据我建议延期B Agent可能把这个建议当成既定事实开始执行因为缺少一个中间层帮助它区分观点和事实。责任无法回溯。最终结论诞生在哪里是哪个Agent基于哪条信息做出的关键决策如果全程都是自由对话这些问题几乎无法回答。一旦业务方要求追责或复盘你拿不出一份可信的过程记录。我的建议是在Agentic工作流里对话只发生在人与Agent或人与编排器之间Agent之间的信息传递一律走结构化消息。这听起来少了一些智能感但换来的可观测性和可靠性完全值得。企业系统最不需要的就是惊喜。2.3 协作架构要解决的四件事不管采用哪种协作范式我认为一套合格的Agentic Collaboration架构必须解决下面四件事缺一件都会在长尾场景里翻车。第一能力发现。A服务需要调用财务预测能力时它怎么知道系统里有这个能力、入口在哪、需要的输入格式是什么在企业内部建议维护一个统一的能力注册表用统一的接口描述标准登记所有Agent服务而不是靠硬编码地址互相调用。第二执行协议。一次协作任务从开始到完成消息格式是什么错误重试怎么办超时怎么约定这是整个架构里最繁琐但最重要的部分。你可以不引入复杂的协议标准但至少要定义一套内部统一的数据交换Schema并强制所有Agent消息都按这个Schema校验通过后才能发送。第三状态共享。多Agent协作里每个Agent执行完自己的环节结果放哪里后续Agent从哪读取是共享数据库、事件总线、还是消息队列核心是让任务当前进展成为一个可查询、可持久化的状态而不是漂在某个Agent的上下文里。第四边界认定。上面提到的两个核心边界——职责边界和权限边界——必须在架构层面落地为可执行的配置而不是靠System Prompt里那句你只负责数据分析。Prompt约束是软的架构约束才是硬的。这四件事里前两件决定系统能不能跑起来后两件决定系统能不能长期稳定跑下去。3. 落地一套Agentic工作流五个关键环节与实施要点聊完架构理念下面进入实操环节。我把一次真实的企业Agentic Collaboration落地过程拆成五个环节每个环节都给出具体做法和判断依据你可以直接对着这个框架去设计自己的系统。3.1 第一环节把业务流程拆成带契约的任务图第一步不是写代码也不该是选模型。第一步是一个纯业务分析动作把你想要自动化的业务流程画成一张任务图。这张图里每个节点是一个有明确输入输出定义的业务动作每个连线是一次数据交接。画图时有几个关键原则每个节点的职责必须单一。比如生成风险报告和发送风险报告要拆成两个节点因为前者是内容生成类任务后者是通信类任务它们的可靠性特征完全不一样。内容生成需要模型推理通信发送需要API调用和重试策略混在一起会让排查困难。节点之间的数据交接必须显式定义Schema。哪怕一开始只是简单的JSON结构也要明确说清楚这个环节输出什么字段、类型是什么、可空吗、默认值是什么。一旦定义好后面的Agent实现就有据可依。识别需要人工介入的节点。不是所有步骤都应该交给Agent涉及对外确认、成本承诺、制度审批的动作建议在流程里预留human-in-the-loop开关让Agent只做预填和建议最终确认权留在人手上。我见过一个很好的实践团队在任务图里用三种不同颜色标识节点——绿色是Agent可全自动执行的、黄色是需要人在环上确认的、红色是Agent只读禁止写入的。开发阶段遵循这个配色的边界来配置权限比后期靠代码Review安全得多。3.2 第二环节为每个Agent划定能力与权限边界任务图画完接下来给节点分配Agent。一个常见的错误是一个Agent跑多个节点理由通常是省资源、省调用。我的建议是初期宁可拆细一点每个关键节点对应一个独立Agent实例至少也要做到一个Agent只承担一个职责域。为什么因为Agent的可信度边界和任务边界强相关。一个Agent如果只在从结构化数据中筛选异常值这个范围内工作你可以通过严格的输入校验和输出校验把它控制在极低的幻觉率但如果你让它同时承担筛选异常和提出业务建议第二个动作就会引入开放式推理幻觉风险迅速上升。权限这块我的经验是遵循最小权限原则给Agent分配一个服务账号只开通完成本节点任务所需的API访问权。如果流程里某个环节需要读取财务系统但后续环节只需要看到处理结果的摘要那就不要让后续环节的Agent拥有财务系统的访问权。这一步做得越严格后面系统出安全问题的概率就越低。3.3 第三环节建立有质量的通信机制这个环节是Agentic Collaboration里最容易被低估的部分。很多初版系统就是让Agent直接调下一个Agent的API图省事。这种方式在两三个Agent的小链路里没问题一旦Agent数量超过五个就开始出现联调地狱。更稳妥的做法是引入一个轻量级的消息层可以是一个简单的消息队列也可以是一个共享的任务状态表关键点是消息不直接从一个Agent进程发给另一个Agent进程而是写入到一个持久化存储中由消费方自行拉取。这样做有三个收益生产者和消费者解耦任何一个Agent升级或者临时故障都不会阻塞其他环节。消息可以保留完整审计轨迹谁是生产者、什么时候生产、谁消费了、什么时候消费的一目了然。失败重试变得容易。消费者处理失败后消息还在队列里不会丢。消息格式建议统一用JSON并包含以下通用字段消息ID、消息类型、生产者ID、目标消费者ID、业务关联ID、生成时间戳、数据负载。其中业务关联ID尤其重要它用于串联同一个业务请求在所有Agent节点之间的流转痕迹排查问题时你只需要拿着这个ID去全链路检索。3.4 第四环节状态管理与失败恢复Agentic工作流跑起来之后你面临的真实挑战是Agent执行到一半外部API超时或者返回异常然后怎么办很多初版系统直接选择整体失败让用户重新发起任务。这个体验对于内部工具还算勉强能忍对于面向客户或面向高管看板的流程基本不可接受。我的建议是给每个任务设计状态机至少包含以下状态待执行、执行中、等待人工确认、失败待重试、已终止、已完成。每个节点执行完毕后立即更新任务状态。这样即使某个环节失败你也会很清楚是第几个环节挂了、当前停留状态是什么、哪些前置步骤已经成功不需要重跑。对于重试策略别一股脑失败就重试。区分错误类型重试是安全的错误网络超时、HTTP 5xx、API限流。这类错误可以指数退避重试初始间隔1秒上限5次。重试是危险的操作业务逻辑校验失败、数据格式错误、权限拒绝。这类错误重试多少次都会失败应直接标记为失败待检并推送告警给维护人员。对模型生成内容的质量错误比如输出不符合Schema、关键字段缺失重试逻辑建议触发一次带反馈重写也就是把校验错误信息连同原输入一起回传给Agent让它在下次生成时主动修正。实测下来这种基于校验反馈的重写方式比无脑重试有效得多。3.5 第五环节可观测性设计很多Agent系统上线时功能演示很完美但一进入维护期就原形毕露——因为完全没有可观测性。无法回答上周五下午那个客户的订单为什么在排期节点卡了40分钟这不是技术问题是管理问题。Agentic工作流天然是分布式的一个任务经过多个Agent处理任何一环出问题影响都会沿着链路传导。没有可观测性你排查一个卡点可能需要人肉翻遍所有Agent日志非常痛苦。最低限度你需要做到以下三件事全链路Trace。每个业务请求从入口开始分配一个TraceID贯穿所有Agent调用、API调用、人工确认节点。借助这个ID你可以按时间顺序还原一次任务在所有节点上的完整经过。关键指标监控。核心指标至少有每个Agent节点的任务处理数量、成功率、平均耗时、重试率、人工确认等待时长。这些指标直接反映工作流健康状况任何一项的异常波动都值得关注。生成内容质量抽检。定期抽取每个Agent在处理真实任务时生成的中间输出由业务方人工评分。这项工作能提前发现模型退化和Prompt衰减而不是等用户投诉才后知后觉。4. 避坑清单与排查诊断手册最后分享几个我们在实战中踩过的坑和总结出的排查方法这部分内容通常是项目复盘时最有价值的沉淀。4.1 五个高频翻车现场翻车1Agent开始一本正经地胡说八道。现象很典型销售日报生成Agent明明没有库存数据却在汇报里写库存充足建议加大促销投入。排查时发现它的Prompt里有一句请结合库存情况给出建议模型在缺少数据时选择合理推测而不是明确说缺数据。这类问题的根源是Prompt设计时没有给模型拒绝回答的空间。修复方向不是加一句不要编造数据而是改写任务方式仅基于以下返回的库存字段生成分析报告如果字段缺失在报告中单独列出缺失项。翻车2权限范围设置过宽Agent误操作生产环境。很多企业在POC阶段让Agent使用管理员账号跑通后忘记收缩权限结果某次流程里Agent解析错了意图直接在生产环境修改了一组配置。这个事故的教训是Agent的权限初始化必须和任务图同步设计不是开发完Agent再补权限而是在任务图阶段就确定每个节点的最小权限包。POC用管理员账号没问题但上生产之前必须做一次彻底的权限收敛。翻车3上下文污染导致的信息串台。多Agent协作时一个Agent的输出被当成了另一个Agent的事实依据。比如需求分析Agent建议项目可能延期排期Agent直接把这个建议当成既定事实更新了里程碑。修复方法是前面说的Agent之间的消息传递不传自然语言文本而是传结构化数据并且明确标识字段的可信等级。翻车4重试风暴。某个Agent依赖的外部接口出现抖动导致大量任务同时失败并触发重试重试请求又加剧了上游服务的压力形成雪崩。后来我们给重试逻辑加了熔断机制单个任务重试次数逼近上限时自动将新到任务切换到降级路径比如先记录待办、通知人工介入而不是继续盲目重试。翻车5任务图中缺少终止条件。早期设计流程时有个环节是让Agent自动和业务方确认信息但我们忘了定义如果连续三次确认都失败怎么办。结果Agent在确认环节无限循环每次会话都产生新的对话记录、新的Token消耗直到运维人员发现账单数字不对劲。解决方式是给所有循环性任务预设一个最大尝试次数超过即进入人工处理队列绝不无限重试。4.2 Agentic工作流常见问题速查表我把运维阶段高频出现的问题和排查方向整理成了一张表方便大家对照处理。症状可能原因优先排查方向任务卡在执行中超过预期时间上游API超时未配置查看该节点Trace确认调用外部系统时耗时分布Agent输出格式频繁校验失败任务图阶段没有定义严格的输出Schema检查是该Agent系统性错误还是偶发系统性错误优先修Prompt流程偶尔跳过某个必要节点编排器节点条件判断逻辑有漏洞核对编排器的条件分支覆盖是否完整有没有默认兜底分支多Agent协作结论质量下降各Agent之间上下文互相污染检查Agent之间的消息传递是否全部采用结构化工单模式排掉自然语言直传重试次数很多但成功率低重试了不该重试的错误类型消除业务类错误的自动重试改为告警人工介入人工确认节点长期无人处理确认通知渠道没打通检查通知是否进入了正确的IM或OA通道是否设置了升级机制排查时的通识性心法不要从日志第一行开始读先看TraceID把链路拉出来再从耗时异常的节点反向定位到具体Agent调用。这个效率高于顺序翻阅落盘日志的做法尤其在节点数量超过五个的系统里顺序排查基本没法用。4.3 我的几点个人体会做了一段时间的Agentic Collaboration之后我发现一个反直觉的现象技术难度并不是这个方向最大的门槛真正难的是在组织内部建立流程化思维。开发者习惯了写从上到下顺序执行的代码业务方习惯了让一个人从头跟到尾切换到Agentic协作意味着双方都要接受一个新的现实业务流程变成了一张可以由机器调度、自动流转的任务网络每个人负责的只是其中一个节点。这个认知转变往往比技术选型花更多时间。另外一个体会是不要一上来就追求完全自主先跑通Agent辅助人在环确认的版本。这样场景下Agent可以先自主完成信息收集和初稿生成把需要决策的部分推送给人确认。运行一段时间、对各个环节的成功率有了测算数据后再逐步扩大自动化的范围。这个渐进路线的翻车概率远低于一步到位的全自动方案也会更有说服力去获得业务方的信任。最后再分享一个小技巧把Agent之间传递的每条数据都打上生产时间戳和数据源标识。看起来只是加了两个字段实际排查时价值巨大。当你在业务方那里被问这个数据是哪来的、是否过期时这两个字段能直接给出答案不用再去翻Agent上下文里它究竟什么时候、从哪个接口拿到的数据。真实的生产系统往往就是这些不起眼的小设计在支撑长期稳定性。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进