做Agent开发这两年我最大的体会就是一个Agent什么都能干往往最后什么都干不好。你把资料搜集、数据清洗、图表生成、报告撰写全塞进一个Agent里提示词写到五千字工具配了七八个结果它要么在中间步骤跑偏要么在某个环节突然开始一本正经地胡说八道。最近我换了个思路干脆把单个Agent掰成多个让它们各自只干一件事再用消息机制串起来。跑了一轮下来效果意外地好这篇就好好聊聊这个影分身到底怎么玩以及中间踩过哪些坑。先说清楚这篇博文主要解决什么问题当你觉得一个Agent不够用时不是硬怼提示词而是通过拆分split和复制fork两种方式把单体Agent改造成多Agent协作系统。里面会涉及到multi-agent的架构思路、fork的实现细节、分身之间的通信协议设计以及我在实际改造一个报告生成Agent时验证过的完整流程。想快速上手多Agent开发的照着这篇文章能少走很多弯路。1. 为什么要把一个Agent掰成两个单体的瓶颈其实很具体很多人在单体Agent还能跑的时候是感觉不到拆分需求的。等你在生产环境里跑过几轮就会发现瓶颈根本不是模型不够聪明而是单Agent的结构性问题。这些问题不会在demo里暴露一旦接上真实数据和多步工具调用马上现原形。1.1 上下文窗口和注意力稀释大模型Agent在上文窗口里全塞进去一旦超出2万token——现在很多Agent在处理长文档时动不动就几万token——中间层的注意力就开始洗地。模型不会明说我忘了但它大概率把早期信息当背景噪声处理了。我做过一个测试同样的任务上下文8000 token时准确率还算能打涨到25000 token之后关键字段的提取准确率掉了将近20%。这不是模型不行是单Agent天然要吃完整上下文。处理A任务时它在读B任务的材料处理B任务时A任务的结果还在背景里飘。拆成多个Agent后每个分身只看自己需要的上下文注意力集中在一个职责范围内模型的真实能力反而能发挥出来。1.2 职责混乱导致提示词失控单体Agent要同时遵守多套规则时提示词会变得极其臃肿。比如我之前那个报告Agent既要当严格的数据校验员又要当风格活泼的文案写手还要当格式规范的技术排版工。这三套指令在System Prompt里反复切换模型经常在严格和活泼之间精神分裂——数据校验漏了文案又写得像说明书。拆开之后每个分身的System Prompt只需要三到五条清晰指令不需要互相妥协。数据Agent就老老实实校验数字格式文案Agent就专心把话说明白两者之间通过结构化的JSON交换信息谁都不用迁就谁。提示词短了指令遵循度反而大幅提升。1.3 工具链相互干扰单Agent挂了一堆工具选择困难症会非常严重。模型每次要决定用哪个工具本身就需要额外的推理成本。更要命的是工具之间的状态冲突搜索工具把临时文件写进了工作目录绘图工具又把同一目录清空Agent自己根本注意不到。这就是我之前遇到的资料收集完了图片路径全没了的经典翻车现场。拆分之后工具归属非常清晰。每个分身只能调用自己职责范围内的两三个工具选择面窄了误用率直线下降。工具之间的副作用也被隔离在各自独立的工作目录里互不污染。1.4 真实例子我把一个报告Agent掰成了三个上个月我做了一个季度运营报告自动生成的项目初始方案就是单Agent喂它一堆原始数据文件让它自己搜补充资料、算指标、画趋势图、写总结、排版导出。这听起来挺合理实际跑起来问题不断。后来我把这个Agent拆成了三个分身资料收集Agent负责检索行业信息和竞品动态数据分析Agent负责读取内部数据算指标、生成图表报告撰写Agent负责把资料和数据组织成完整报告。三个分身通过一个共享任务板通信前一个完成后自动把产出物挂到板上后一个从板上取。改造后整条流水线的成功率从61%提升到了88%单次任务的token消耗反而降了30%左右。后面我会把具体的改造细节全部写出来。2. 分身的两种姿势拆分与复制别用混很多初接触多Agent的人一上来就纠结到底怎么把Agent掰成两个。掰这个动作其实有两种截然不同的含义一种是垂直拆分把一个大而全的Agent按职责切成几块另一种是水平复制把同一个Agent并行拉起多个实例。这两件事经常被混在一起讲但在架构上完全是两码事。2.1 垂直拆分按职责切解决什么都干不好垂直拆分的关键是找职责边界。判断标准很简单看提示词里能不能划出清晰的段落边界。比如报告生成资料收集、数据分析、文案撰写这三个环节本身就对应不同的工具和不同的Prompt要求中间有明确的产物交接点。在这种边界位置下刀拆出来的分身各自独立协作起来最顺畅。拆分时我最看重一条原则每个分身要有自己独立的工作产物和工作目录。分身A的输出是分身B的输入这个接缝要像工厂流水线一样清晰。如果两个分身需要频繁地边算边聊说明边界划得不够合理该重新考虑拆法。2.2 水平复制按量并行解决忙不过来水平复制解决的不是质量问题而是吞吐问题。比如你要让Agent审核一百篇稿件单Agent串行审一篇两分钟得三小时。这时就可以把一个Agent跑一份配置文件当成模板启动多个实例并发审核。我习惯管这叫replicate但很多人也直接叫fork意思就是这个模板复制动作。水平复制需要注意状态的隔离。每个实例如果共享同一个临时文件目录或者共用一个向量库写入权限几乎必然出现互相覆盖的竞态问题。我通常会给每个实例分配独立的session_id所有临时文件和中间结果都挂到这个session_id下跑完整体清理。2.3 fork在Agent开发里到底是什么fork这个说法在Agent领域里其实有两个层面的含义。第一层是工程层面指把一个现成的Agent项目代码复制一份出来改成自己的版本——比如你在开源Agent框架的基础上fork一个私有版本进行二次开发。这个层面的fork大家比较熟悉GitHub上到处都是。第二层是运行层面指在同一个Agent进程内派生出子Agent。这就更像是影分身了主Agent在某个执行节点上把当前的任务上下文拷贝一份派生出一个带着相同记忆但执行不同任务的子Agent并行推进工作。现在不少开源Agent框架都已经支持类似的操作运行时本质上是新起一个Agent实例传入Task上下文。实操里第二层的fork很容易踩坑派生出的子Agent如果没有任务的完整描述它的上下文是断的但如果把父Agent的整个历史上下文全部传进去子Agent的注意力又会被无关信息稀释。我的做法是只传契约——把任务目标、输入数据的引用路径、期望的输出格式传过去不传父Agent的碎碎念。2.4 拆分和复制怎么选三个判断条件这里给一个非常实用的选型参考。如果你只想在工程里少花力气做对决策就套下面三个问题来判断判断问题倾向拆分的信号倾向复制的信号瓶颈在质量还是速度质量下降单Agent经常跑偏速度不足需要并发处理职责边界是否清晰很清晰各环节产物独立职责相同只是任务量大上下文是否有重叠各环节看的材料完全不同材料相同只是处理对象不同拆完之后如果发现每个分身的提示词仍然超过1500字说明拆得不够细继续在职责边界上下功夫。复制的话注意关注并发的资源池大小和限流策略别把所有实例同时打到一个API端点上容易被限速。3. 多Agent协作的关键环节让分身们不打架拆分只是第一步真正难的是让分身们协作起来不互相使绊子。三个Agent各干各的那叫三个并行的script三个Agent有序衔接、共享信息、决策互补才叫multi-agent系统。协作机制选错了多个Agent带来的混乱程度是单Agent的三倍。3.1 三种主流协作模式编排、协商、黑板我把现在常用的多Agent协作模式归纳成三种它们没有高下之分只看场景匹配。第一种是编排模式Orchestration也是最实用的。一个主Agent当调度员把任务分解后分发给子Agent再收集结果。这种模式类似项目经理带外包团队主Agent控制全局子Agent各做各的。适合流程固定的任务比如我上面的报告生成流水线。第二种是协商模式Negotiation多个Agent平等对话通过互相质询达成共识。这种模式适合没有唯一正确答案的任务比如产品方案评审可以让需求Agent、研发Agent、市场Agent互相PK逼出更完整的方案。但这种模式成本极高对话轮数不好控制非必要不建议新手尝试。第三种是黑板模式Blackboard所有Agent共享一块内存区域各自在上面读写。这个模式在复杂任务里很灵活但需要非常严格的读写协议和版本管理。我看到不少半途而废的黑板项目都是坏在谁改了什么说不清楚原生调试成本太高。3.2 通信协议怎么定结构化消息优于自由文本刚开始做多Agent时我让分身之间直接传大白话文本。比如资料Agent传一句资料已经找好了有很多报告和文章你看下怎么用结果下游的数据Agent根本不知道从哪取文件也不知道字段含义双方在对话里反复确认浪费了好几轮token。后来我改成结构化消息所有分身的交接数据都用JSON格式固定包含四个字段task_id、source_path、schema、confidence。source_path写清楚产物文件存储位置schema写清楚字段结构confidence记录这个产物的可信度评分。下游Agent拿到消息后直接按schema取数不需要来回追问接口也稳定得多。这个改动上线后分身间的无效对话消耗降低了约四成。3.3 共享记忆每个分身该记住什么多Agent最容易出现的问题之一就是记忆混乱。分身B需要知道分身A干了什么但不需要知道过程有多曲折。所以我的经验是给每个分身配三种记忆全局长效记忆、任务相关记忆、过程无关记忆。全局长效记忆放在一个共享的知识库里比如项目背景、术语表、历史决策记录所有分身启动时都会加载相当于公司文化手册。任务相关记忆在任务开始时注入只包含本任务相关的上下文比如本次报告的主题、目标读者。过程排除在外——分身A在搜集资料时试了多少种搜索词这些信息对分身B毫无用处传过去只会污染上下文。一个很实用的技巧是在每个分身的System Prompt里明确告诉它你不需要知道其他Agent是怎么做事的你只需要接受它们的结果。这句话听上去有点生硬但实测能防止模型脑补出不存在的协作关系减少幻想的内部流程。3.4 我的轻量Event Bus实现如果你不想引入重型框架可以自己搭一个极简的Event Bus。我用的方案不复杂核心就是一个Pub/Sub中间件出租给所有Agent调用。我实际用的代码结构大致是这样的# event_bus.py - 轻量事件总线用于Agent间通信 class EventBus: def __init__(self): self._subscribers {} self._events [] def subscribe(self, event_type, handler): self._subscribers.setdefault(event_type, []).append(handler) def publish(self, event_type, data): event {type: event_type, data: data, ts: time.time()} self._events.append(event) for handler in self._subscribers.get(event_type, []): handler(event)每个Agent实例在启动时注册自己关注的事件类型然后异步监听。父Agent只需要负责编排整体流程子Agent完成后发布事件下游Agent订阅到事件后自动开始工作。这套东西跑得很稳拓扑关系通过事件类型解耦后面加Agent也不需要动主干代码。4. 实操实录从单Agent到多Agent的改造过程理论知识讲再多不如完整跑一遍。下面把我那个季度报告Agent的实际改造过程拆解出来从原始结构一直到调优后的版本每一步的思考和参数调节都写清楚你可以直接照着这个路径设计自己的拆分方案。4.1 原始单体Agent长什么样改造前的单体Agent是一个典型的大一统选手。它挂载了如下工具网络搜索、文档解析、数据表格处理、绘图、markdown导出。System Prompt大概2000多字包含了数据校验规则、图表风格要求、文案语气要求、排版规范。任务流程全靠提示词描述先读数据文件再搜索补充资料计算指标生成图表最后拼接成报告。表面上步骤清晰实际上没有任何程序层面的强制约束。模型一旦在中间某一步动作不确定就会自由发挥经常出现搜索完资料后忘了算指标这种流程断裂。当时跑了20次测试只有12次完整跑通并输出了合格报告。失败样例里大概有三类问题任务中断输出格式错乱数据计算明显错误。这就是催化我拆分的直接原因。4.2 拆分后的架构与配置我最终把单体Agent拆成了三个子Agent外加一个编排器。编排器不调用工具只负责任务分发和状态流转。三个子Agent的职责和产出物如下子Agent职责描述产出物挂载工具资料Agent检索行业资讯和竞品动态markdown文件引用来源列表网络搜索数据Agent清洗内部数据计算指标生成图表指标JSON图表图片表格处理、绘图撰写Agent基于前两者的产出组织报告全文最终markdown报告文档格式化编排器在每个阶段结束后检查产出物的schema完整性和非空约束只有验证通过才把事件发布给下游。这份代码逻辑不多但把流程强制住了模型的自由发挥空间被压缩到合理范围。4.3 关键的参数调节记录拆分后需要重新调整参数有几个数值我记录一下供参考。首先是上下文长度。每个子Agent的最大上下文我设为16384 token比原单体Agent的32768低了一半跑下来效果反而更好因为注意力更集中。其次是reasoning effort的分配。资料Agent和数据Agent是执行型任务不需要太多思考深度我调到了低档撰写Agent负责组织语言和逻辑需要更好的连贯性中档。这个调节是基于成本的优化实测下来同样任务质量不变的情况下总消耗降低了三成左右。还有一个值得说的细节是每个子Agent设置单独的温度参数。数据Agent负责计算温度直接调到0避免计算类任务随机发挥撰写Agent温度0.4保留一定的措辞灵活性但又不至于放飞。这种细粒度的参数控制是单Agent做不到的。4.4 实测效果对比改造前后跑同一套测试集结果对比如下指标单体Agent三Agent拆分完整跑通率60%90%数据计算错误率15%2%平均运行时长约6分钟约7分钟单任务token消耗基准下降约30%时长略增是因为分身间的消息传递和验证环节引入了一些开销。换取的是接近三倍的成功率提升和更低的token消耗这笔账非常划算。我之所以保留这个结果不谈具体数值的绝对值是因为不同项目差异很大但相对趋势是相当一致的。5. 常见问题与排查技巧实录多Agent项目里有些问题特别爱出现而且因为多了协作环节排查起来比单体Agent复杂得多。这一节我把自己遇到过的高频故障整理成速查表再展开讲几个最典型的场景方便你直接对照。5.1 高频问题速查表现象可能原因排查方向对应处理分身A完成但分身B迟迟不动事件未发布或订阅未注册检查Event Bus日志确认subscribe与publish的事件类型完全一致下游拿到乱码字段schema约定不一致对比两个Agent的JSON Schema用统一schema文件禁止各自定义多个分身同时写一个文件没有隔离工作目录查看临时文件时间戳强制使用session_id隔离目录输出报告前后风格不一致各分身独立生成段落缺乏统稿检查撰写Agent是否拿到风格模板给撰写Agent提供明确的风格样例禁止其他Agent自定义风格任务跑到一半卡住某个Agent进入了无限循环查看工具调用记录设置最大工具调用轮数超时强制终止表格里列的都是我实战中遇到的真实场景不是从文档里抄来的理论。这里重点提示一下多Agent项目里的日志必须带上agent_id和时间戳否则排查问题时满屏信息混在一起根本分不清是谁先动了谁的资源。5.2 分身间的上下文串味这是我踩过最深的坑。有一次数据Agent输出的指标JSON里莫名混进了资料Agent搜索时的标题文案排查了半天后来发现是两个Agent复用了同一个Prompts模板模板里的变量名冲突数据Agent误取了模板里的公共变量。这种问题非常隐蔽。后来我强制规定每个Agent定义自己独立的prompt模板文件公共的入口变量必须加前缀比如data_input_xxx、ref_input_xxx。变量名命名规范做细致一点能省掉后面大量脑细胞。5.3 Token预算失控多Agent的token消耗如果不设预算很容易雪崩。特别是编排模式主Agent负责收集结果时如果把所有子Agent的完整输出都塞回自己的上下文再重新整理一遍消耗就直接起飞。我最开始就吃过这个亏。资料Agent产出了8000字的资料汇总主编排器把这些全文当作自己下一轮决策的上下文结果光这一步就烧掉了上万token。后来改成只传递摘要引用路径主编排器不读全文只做状态判断和流程管理token消耗立刻降下来了。多Agent环境的预算控制关键在于不要把中间产物反复塞进上下文里。5.4 结果不一致与接缝质量拆分的最大副作用是接缝问题——各分身独立产出没问题但拼在一起总有点违和感。报告的前半部分是数据Agent的图表风格后半部分是撰写Agent的文字分析两者数值对不上一眼就能看出来。解决思路是强约束接缝的交接格式。数据Agent除指标数值外还必须输出指标的口径说明和单位定义撰写Agent写正文前先校验口径一致性不一致就回退给数据Agent重算。这相当于在两个独立模块之间建立了一个API契约。一个可靠的实践是给接缝处的数据结构写一份非常详细的注释文档两个Agent的开发者都按同一份文档对齐效果比口头约定好得多。最后再补一句实在话做多Agent改造不是目的让系统更可靠更有效率才是目的。我个人的经验和看法是技术方案的选择要围绕成本与收益的关系来权衡。如果单体Agent已经能稳定满足业务需求你不需要为了追潮流强行拆成多个但如果项目已经暴露了职责混乱、上下文过载、工具冲突这些典型症状那影分身这套思路就值得认真试一试。多Agent的配置和调优是有学习曲线的我也走过不少弯路。真要动手的话建议先从两个Agent开始拆跑通消息机制后再逐步增加分身。一上来就搞五六个Agent的编排网络大概率会把自己绕进去。稳定运行的配置是慢慢迭代出来的这个项目拆完下一轮还可以给每个分身内置专属的记忆模块和私有工具组又是一种新的玩法。
多Agent开发实战：拆分与复制，让每个Agent专注一件事
做Agent开发这两年我最大的体会就是一个Agent什么都能干往往最后什么都干不好。你把资料搜集、数据清洗、图表生成、报告撰写全塞进一个Agent里提示词写到五千字工具配了七八个结果它要么在中间步骤跑偏要么在某个环节突然开始一本正经地胡说八道。最近我换了个思路干脆把单个Agent掰成多个让它们各自只干一件事再用消息机制串起来。跑了一轮下来效果意外地好这篇就好好聊聊这个影分身到底怎么玩以及中间踩过哪些坑。先说清楚这篇博文主要解决什么问题当你觉得一个Agent不够用时不是硬怼提示词而是通过拆分split和复制fork两种方式把单体Agent改造成多Agent协作系统。里面会涉及到multi-agent的架构思路、fork的实现细节、分身之间的通信协议设计以及我在实际改造一个报告生成Agent时验证过的完整流程。想快速上手多Agent开发的照着这篇文章能少走很多弯路。1. 为什么要把一个Agent掰成两个单体的瓶颈其实很具体很多人在单体Agent还能跑的时候是感觉不到拆分需求的。等你在生产环境里跑过几轮就会发现瓶颈根本不是模型不够聪明而是单Agent的结构性问题。这些问题不会在demo里暴露一旦接上真实数据和多步工具调用马上现原形。1.1 上下文窗口和注意力稀释大模型Agent在上文窗口里全塞进去一旦超出2万token——现在很多Agent在处理长文档时动不动就几万token——中间层的注意力就开始洗地。模型不会明说我忘了但它大概率把早期信息当背景噪声处理了。我做过一个测试同样的任务上下文8000 token时准确率还算能打涨到25000 token之后关键字段的提取准确率掉了将近20%。这不是模型不行是单Agent天然要吃完整上下文。处理A任务时它在读B任务的材料处理B任务时A任务的结果还在背景里飘。拆成多个Agent后每个分身只看自己需要的上下文注意力集中在一个职责范围内模型的真实能力反而能发挥出来。1.2 职责混乱导致提示词失控单体Agent要同时遵守多套规则时提示词会变得极其臃肿。比如我之前那个报告Agent既要当严格的数据校验员又要当风格活泼的文案写手还要当格式规范的技术排版工。这三套指令在System Prompt里反复切换模型经常在严格和活泼之间精神分裂——数据校验漏了文案又写得像说明书。拆开之后每个分身的System Prompt只需要三到五条清晰指令不需要互相妥协。数据Agent就老老实实校验数字格式文案Agent就专心把话说明白两者之间通过结构化的JSON交换信息谁都不用迁就谁。提示词短了指令遵循度反而大幅提升。1.3 工具链相互干扰单Agent挂了一堆工具选择困难症会非常严重。模型每次要决定用哪个工具本身就需要额外的推理成本。更要命的是工具之间的状态冲突搜索工具把临时文件写进了工作目录绘图工具又把同一目录清空Agent自己根本注意不到。这就是我之前遇到的资料收集完了图片路径全没了的经典翻车现场。拆分之后工具归属非常清晰。每个分身只能调用自己职责范围内的两三个工具选择面窄了误用率直线下降。工具之间的副作用也被隔离在各自独立的工作目录里互不污染。1.4 真实例子我把一个报告Agent掰成了三个上个月我做了一个季度运营报告自动生成的项目初始方案就是单Agent喂它一堆原始数据文件让它自己搜补充资料、算指标、画趋势图、写总结、排版导出。这听起来挺合理实际跑起来问题不断。后来我把这个Agent拆成了三个分身资料收集Agent负责检索行业信息和竞品动态数据分析Agent负责读取内部数据算指标、生成图表报告撰写Agent负责把资料和数据组织成完整报告。三个分身通过一个共享任务板通信前一个完成后自动把产出物挂到板上后一个从板上取。改造后整条流水线的成功率从61%提升到了88%单次任务的token消耗反而降了30%左右。后面我会把具体的改造细节全部写出来。2. 分身的两种姿势拆分与复制别用混很多初接触多Agent的人一上来就纠结到底怎么把Agent掰成两个。掰这个动作其实有两种截然不同的含义一种是垂直拆分把一个大而全的Agent按职责切成几块另一种是水平复制把同一个Agent并行拉起多个实例。这两件事经常被混在一起讲但在架构上完全是两码事。2.1 垂直拆分按职责切解决什么都干不好垂直拆分的关键是找职责边界。判断标准很简单看提示词里能不能划出清晰的段落边界。比如报告生成资料收集、数据分析、文案撰写这三个环节本身就对应不同的工具和不同的Prompt要求中间有明确的产物交接点。在这种边界位置下刀拆出来的分身各自独立协作起来最顺畅。拆分时我最看重一条原则每个分身要有自己独立的工作产物和工作目录。分身A的输出是分身B的输入这个接缝要像工厂流水线一样清晰。如果两个分身需要频繁地边算边聊说明边界划得不够合理该重新考虑拆法。2.2 水平复制按量并行解决忙不过来水平复制解决的不是质量问题而是吞吐问题。比如你要让Agent审核一百篇稿件单Agent串行审一篇两分钟得三小时。这时就可以把一个Agent跑一份配置文件当成模板启动多个实例并发审核。我习惯管这叫replicate但很多人也直接叫fork意思就是这个模板复制动作。水平复制需要注意状态的隔离。每个实例如果共享同一个临时文件目录或者共用一个向量库写入权限几乎必然出现互相覆盖的竞态问题。我通常会给每个实例分配独立的session_id所有临时文件和中间结果都挂到这个session_id下跑完整体清理。2.3 fork在Agent开发里到底是什么fork这个说法在Agent领域里其实有两个层面的含义。第一层是工程层面指把一个现成的Agent项目代码复制一份出来改成自己的版本——比如你在开源Agent框架的基础上fork一个私有版本进行二次开发。这个层面的fork大家比较熟悉GitHub上到处都是。第二层是运行层面指在同一个Agent进程内派生出子Agent。这就更像是影分身了主Agent在某个执行节点上把当前的任务上下文拷贝一份派生出一个带着相同记忆但执行不同任务的子Agent并行推进工作。现在不少开源Agent框架都已经支持类似的操作运行时本质上是新起一个Agent实例传入Task上下文。实操里第二层的fork很容易踩坑派生出的子Agent如果没有任务的完整描述它的上下文是断的但如果把父Agent的整个历史上下文全部传进去子Agent的注意力又会被无关信息稀释。我的做法是只传契约——把任务目标、输入数据的引用路径、期望的输出格式传过去不传父Agent的碎碎念。2.4 拆分和复制怎么选三个判断条件这里给一个非常实用的选型参考。如果你只想在工程里少花力气做对决策就套下面三个问题来判断判断问题倾向拆分的信号倾向复制的信号瓶颈在质量还是速度质量下降单Agent经常跑偏速度不足需要并发处理职责边界是否清晰很清晰各环节产物独立职责相同只是任务量大上下文是否有重叠各环节看的材料完全不同材料相同只是处理对象不同拆完之后如果发现每个分身的提示词仍然超过1500字说明拆得不够细继续在职责边界上下功夫。复制的话注意关注并发的资源池大小和限流策略别把所有实例同时打到一个API端点上容易被限速。3. 多Agent协作的关键环节让分身们不打架拆分只是第一步真正难的是让分身们协作起来不互相使绊子。三个Agent各干各的那叫三个并行的script三个Agent有序衔接、共享信息、决策互补才叫multi-agent系统。协作机制选错了多个Agent带来的混乱程度是单Agent的三倍。3.1 三种主流协作模式编排、协商、黑板我把现在常用的多Agent协作模式归纳成三种它们没有高下之分只看场景匹配。第一种是编排模式Orchestration也是最实用的。一个主Agent当调度员把任务分解后分发给子Agent再收集结果。这种模式类似项目经理带外包团队主Agent控制全局子Agent各做各的。适合流程固定的任务比如我上面的报告生成流水线。第二种是协商模式Negotiation多个Agent平等对话通过互相质询达成共识。这种模式适合没有唯一正确答案的任务比如产品方案评审可以让需求Agent、研发Agent、市场Agent互相PK逼出更完整的方案。但这种模式成本极高对话轮数不好控制非必要不建议新手尝试。第三种是黑板模式Blackboard所有Agent共享一块内存区域各自在上面读写。这个模式在复杂任务里很灵活但需要非常严格的读写协议和版本管理。我看到不少半途而废的黑板项目都是坏在谁改了什么说不清楚原生调试成本太高。3.2 通信协议怎么定结构化消息优于自由文本刚开始做多Agent时我让分身之间直接传大白话文本。比如资料Agent传一句资料已经找好了有很多报告和文章你看下怎么用结果下游的数据Agent根本不知道从哪取文件也不知道字段含义双方在对话里反复确认浪费了好几轮token。后来我改成结构化消息所有分身的交接数据都用JSON格式固定包含四个字段task_id、source_path、schema、confidence。source_path写清楚产物文件存储位置schema写清楚字段结构confidence记录这个产物的可信度评分。下游Agent拿到消息后直接按schema取数不需要来回追问接口也稳定得多。这个改动上线后分身间的无效对话消耗降低了约四成。3.3 共享记忆每个分身该记住什么多Agent最容易出现的问题之一就是记忆混乱。分身B需要知道分身A干了什么但不需要知道过程有多曲折。所以我的经验是给每个分身配三种记忆全局长效记忆、任务相关记忆、过程无关记忆。全局长效记忆放在一个共享的知识库里比如项目背景、术语表、历史决策记录所有分身启动时都会加载相当于公司文化手册。任务相关记忆在任务开始时注入只包含本任务相关的上下文比如本次报告的主题、目标读者。过程排除在外——分身A在搜集资料时试了多少种搜索词这些信息对分身B毫无用处传过去只会污染上下文。一个很实用的技巧是在每个分身的System Prompt里明确告诉它你不需要知道其他Agent是怎么做事的你只需要接受它们的结果。这句话听上去有点生硬但实测能防止模型脑补出不存在的协作关系减少幻想的内部流程。3.4 我的轻量Event Bus实现如果你不想引入重型框架可以自己搭一个极简的Event Bus。我用的方案不复杂核心就是一个Pub/Sub中间件出租给所有Agent调用。我实际用的代码结构大致是这样的# event_bus.py - 轻量事件总线用于Agent间通信 class EventBus: def __init__(self): self._subscribers {} self._events [] def subscribe(self, event_type, handler): self._subscribers.setdefault(event_type, []).append(handler) def publish(self, event_type, data): event {type: event_type, data: data, ts: time.time()} self._events.append(event) for handler in self._subscribers.get(event_type, []): handler(event)每个Agent实例在启动时注册自己关注的事件类型然后异步监听。父Agent只需要负责编排整体流程子Agent完成后发布事件下游Agent订阅到事件后自动开始工作。这套东西跑得很稳拓扑关系通过事件类型解耦后面加Agent也不需要动主干代码。4. 实操实录从单Agent到多Agent的改造过程理论知识讲再多不如完整跑一遍。下面把我那个季度报告Agent的实际改造过程拆解出来从原始结构一直到调优后的版本每一步的思考和参数调节都写清楚你可以直接照着这个路径设计自己的拆分方案。4.1 原始单体Agent长什么样改造前的单体Agent是一个典型的大一统选手。它挂载了如下工具网络搜索、文档解析、数据表格处理、绘图、markdown导出。System Prompt大概2000多字包含了数据校验规则、图表风格要求、文案语气要求、排版规范。任务流程全靠提示词描述先读数据文件再搜索补充资料计算指标生成图表最后拼接成报告。表面上步骤清晰实际上没有任何程序层面的强制约束。模型一旦在中间某一步动作不确定就会自由发挥经常出现搜索完资料后忘了算指标这种流程断裂。当时跑了20次测试只有12次完整跑通并输出了合格报告。失败样例里大概有三类问题任务中断输出格式错乱数据计算明显错误。这就是催化我拆分的直接原因。4.2 拆分后的架构与配置我最终把单体Agent拆成了三个子Agent外加一个编排器。编排器不调用工具只负责任务分发和状态流转。三个子Agent的职责和产出物如下子Agent职责描述产出物挂载工具资料Agent检索行业资讯和竞品动态markdown文件引用来源列表网络搜索数据Agent清洗内部数据计算指标生成图表指标JSON图表图片表格处理、绘图撰写Agent基于前两者的产出组织报告全文最终markdown报告文档格式化编排器在每个阶段结束后检查产出物的schema完整性和非空约束只有验证通过才把事件发布给下游。这份代码逻辑不多但把流程强制住了模型的自由发挥空间被压缩到合理范围。4.3 关键的参数调节记录拆分后需要重新调整参数有几个数值我记录一下供参考。首先是上下文长度。每个子Agent的最大上下文我设为16384 token比原单体Agent的32768低了一半跑下来效果反而更好因为注意力更集中。其次是reasoning effort的分配。资料Agent和数据Agent是执行型任务不需要太多思考深度我调到了低档撰写Agent负责组织语言和逻辑需要更好的连贯性中档。这个调节是基于成本的优化实测下来同样任务质量不变的情况下总消耗降低了三成左右。还有一个值得说的细节是每个子Agent设置单独的温度参数。数据Agent负责计算温度直接调到0避免计算类任务随机发挥撰写Agent温度0.4保留一定的措辞灵活性但又不至于放飞。这种细粒度的参数控制是单Agent做不到的。4.4 实测效果对比改造前后跑同一套测试集结果对比如下指标单体Agent三Agent拆分完整跑通率60%90%数据计算错误率15%2%平均运行时长约6分钟约7分钟单任务token消耗基准下降约30%时长略增是因为分身间的消息传递和验证环节引入了一些开销。换取的是接近三倍的成功率提升和更低的token消耗这笔账非常划算。我之所以保留这个结果不谈具体数值的绝对值是因为不同项目差异很大但相对趋势是相当一致的。5. 常见问题与排查技巧实录多Agent项目里有些问题特别爱出现而且因为多了协作环节排查起来比单体Agent复杂得多。这一节我把自己遇到过的高频故障整理成速查表再展开讲几个最典型的场景方便你直接对照。5.1 高频问题速查表现象可能原因排查方向对应处理分身A完成但分身B迟迟不动事件未发布或订阅未注册检查Event Bus日志确认subscribe与publish的事件类型完全一致下游拿到乱码字段schema约定不一致对比两个Agent的JSON Schema用统一schema文件禁止各自定义多个分身同时写一个文件没有隔离工作目录查看临时文件时间戳强制使用session_id隔离目录输出报告前后风格不一致各分身独立生成段落缺乏统稿检查撰写Agent是否拿到风格模板给撰写Agent提供明确的风格样例禁止其他Agent自定义风格任务跑到一半卡住某个Agent进入了无限循环查看工具调用记录设置最大工具调用轮数超时强制终止表格里列的都是我实战中遇到的真实场景不是从文档里抄来的理论。这里重点提示一下多Agent项目里的日志必须带上agent_id和时间戳否则排查问题时满屏信息混在一起根本分不清是谁先动了谁的资源。5.2 分身间的上下文串味这是我踩过最深的坑。有一次数据Agent输出的指标JSON里莫名混进了资料Agent搜索时的标题文案排查了半天后来发现是两个Agent复用了同一个Prompts模板模板里的变量名冲突数据Agent误取了模板里的公共变量。这种问题非常隐蔽。后来我强制规定每个Agent定义自己独立的prompt模板文件公共的入口变量必须加前缀比如data_input_xxx、ref_input_xxx。变量名命名规范做细致一点能省掉后面大量脑细胞。5.3 Token预算失控多Agent的token消耗如果不设预算很容易雪崩。特别是编排模式主Agent负责收集结果时如果把所有子Agent的完整输出都塞回自己的上下文再重新整理一遍消耗就直接起飞。我最开始就吃过这个亏。资料Agent产出了8000字的资料汇总主编排器把这些全文当作自己下一轮决策的上下文结果光这一步就烧掉了上万token。后来改成只传递摘要引用路径主编排器不读全文只做状态判断和流程管理token消耗立刻降下来了。多Agent环境的预算控制关键在于不要把中间产物反复塞进上下文里。5.4 结果不一致与接缝质量拆分的最大副作用是接缝问题——各分身独立产出没问题但拼在一起总有点违和感。报告的前半部分是数据Agent的图表风格后半部分是撰写Agent的文字分析两者数值对不上一眼就能看出来。解决思路是强约束接缝的交接格式。数据Agent除指标数值外还必须输出指标的口径说明和单位定义撰写Agent写正文前先校验口径一致性不一致就回退给数据Agent重算。这相当于在两个独立模块之间建立了一个API契约。一个可靠的实践是给接缝处的数据结构写一份非常详细的注释文档两个Agent的开发者都按同一份文档对齐效果比口头约定好得多。最后再补一句实在话做多Agent改造不是目的让系统更可靠更有效率才是目的。我个人的经验和看法是技术方案的选择要围绕成本与收益的关系来权衡。如果单体Agent已经能稳定满足业务需求你不需要为了追潮流强行拆成多个但如果项目已经暴露了职责混乱、上下文过载、工具冲突这些典型症状那影分身这套思路就值得认真试一试。多Agent的配置和调优是有学习曲线的我也走过不少弯路。真要动手的话建议先从两个Agent开始拆跑通消息机制后再逐步增加分身。一上来就搞五六个Agent的编排网络大概率会把自己绕进去。稳定运行的配置是慢慢迭代出来的这个项目拆完下一轮还可以给每个分身内置专属的记忆模块和私有工具组又是一种新的玩法。
