先用单 Agent 建立可验证基线,再决定是否拆成多个独立推理循环。本文沿任务依赖计算并行上限,明确每个分支的输入、产物与提交权,并处理迟到结果和失败恢复。成功标准是完整任务的质量、时间和成本改善。
从工作流到多 Agent
单 Agent 也能并行调用独立工具;因此“需要同时读多个文件”不一定需要多个推理循环。多 Agent 更适合需要各自较长分析、不同信息范围或独立工作过程的子任务。每个 Worker 形成自己的上下文后,向协调者返回压缩结果与证据定位,可以减少主上下文承载的原始材料。
多次模型调用也不自动等于多 Agent。固定抽取、校验和格式化流水线可以由普通工作流实现;动态分解任务并让各分支根据工具反馈独立推进,才更接近这里讨论的协作 Agent。Building effective agents
| 组织方式 | 谁决定步骤 | 主要收益与代价 |
| 串接与路由 | 程序预设路径或分类规则 | 易复现,但面对未知分支需扩展流程 |
| 并行分片 | 预先划定独立范围 | 缩短可重叠工作,仍需归并 |
| 动态协调者与 Worker | 模型提出划分,调度器执行 | 适应未知任务,协调与验证更复杂 |
| 生成与评审循环 | 既定流程加模型反馈 | 改进候选,受评审质量与迭代上限约束 |
多 Agent 对话框架展示了角色、工具和交流模式的组合能力,但框架提供对话机制不等于自动提供任务正确性。AutoGen 论文 决定采用哪种结构时,应先找出单 Agent 当前的具体限制,再验证增加协作是否改善了它。
先画依赖,再计算收益
假设任务由准备 A、实现 B、独立兼容性检查 C 和汇总 D 组成。B、C 都需要 A 的接口约定;D 必须拿到两者结果。若 B 与 C 确实能独立推进,下面的并行成立:
串行时间是 2+4+6+3=15 分钟;理想并行时间是 2+max(4,6)+3=11 分钟,节约 4 分钟。若委派、排队和合并冲突额外耗费 5 分钟,总时间反而是 16 分钟。启动了两个 Worker,并不等于任务快了一倍。
如果 C 检查的是 B 尚未产出的补丁,C 就依赖 B,这个图需要改成串行;也可以先让 C 独立整理检查标准,等补丁完成后再验证。改变任务定义可以创造一部分并行空间,但不能用模型猜测消除真实数据依赖。
duration = {"A": 2, "B": 4, "C": 6, "D": 3}
deps = {"A": [], "B": ["A"], "C": ["A"], "D": ["B", "C"]}
finish = {}
for node, minutes in duration.items():
finish[node] = max((finish[x] for x in deps[node]), default=0) + minutes
assert finish["D"] == 11
assert sum(duration.values()) == 15
print("理想并行分钟:", finish["D"])
print("另加 5 分钟协调开销:", finish["D"] + 5)
成本也要加总主 Agent、所有 Worker、重复读取、工具调用和失败尝试。便宜模型承担合适子任务可能节省费用,但多个独立窗口也会重复加载约束和材料;前缀缓存能否命中取决于服务、模型和输入。不能保证“另开子 Agent 必然比主循环切模型便宜”。
实际多 Agent 研究系统的工程报告同时讨论了上下文隔离、独立研究与较高 token 消耗,也指出紧密依赖任务的协调限制。该系统的收益应作为具体案例理解,而非所有任务的加速倍数。Anthropic 多 Agent 研究系统
增加并行,为什么没有按人数提速?
先画出依赖,再谈并行收益。图中每条任务条的起点由前置任务决定,合并也占时间。注意默认总工时是 15,最长路径却是 9;这两个量分别回答资源消耗与完成延迟。
Tparallel=p∈pathsmaxi∈p∑ti+Tcoordination
正在呈现知识画面
增加并行,为什么没有按人数提速?并行时间由最长依赖路径和协调开销决定;任务总工时除以人数通常不是实际完成时间。
{"id":"ai-critical-path","title":"增加并行,为什么没有按人数提速?","summary":"并行时间由最长依赖路径和协调开销决定;任务总工时除以人数通常不是实际完成时间。","height":1000,"html":"<h2 data-i18n=\"heading\"></h2><p class=\"intro\" data-i18n=\"intro\"></p><label class=\"check\"><input type=\"checkbox\" id=\"dependency\"><span data-i18n=\"dependency\"></span></label><div class=\"control\"><label for=\"overhead\" data-i18n=\"overhead\"></label><output for=\"overhead\" id=\"overhead-value\"></output><input id=\"overhead\" type=\"range\" min=\"0\" max=\"6\" value=\"0\" step=\"1\"></div><section class=\"panel\"><h3 data-i18n=\"timeline\"></h3><div id=\"timeline\"></div></section><div class=\"metrics\"><div><span data-i18n=\"parallel\"></span><strong id=\"parallel\"></strong></div><div><span data-i18n=\"speedup\"></span><strong id=\"speedup\"></strong></div></div><div class=\"copy\"><p id=\"explanation\" role=\"status\"></p><p class=\"reserve\" aria-hidden=\"true\" data-i18n=\"explain\"></p></div><details class=\"scope\"><summary data-i18n=\"scopeLabel\"></summary><p data-i18n=\"scope\"></p></details>","css":".intro{margin:8px 0 18px;color:var(--muted);font-size:14px}.control{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:6px 12px;align-items:center;margin:14px 0;font-size:13px}.control output{color:var(--accent);text-align:right;font-variant-numeric:tabular-nums;min-width:4em}.control input{grid-column:1/-1;width:100%;margin:0}.presets{display:flex;gap:4px;align-items:stretch}.presets button{flex:1;min-width:0;overflow-wrap:anywhere;font-size:13px;min-height:44px}.actions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin:16px 0}.actions button{min-width:0;min-height:44px;font-size:13px;overflow-wrap:anywhere}.copy{display:grid;font-size:14px;margin:16px 0}.copy>*{grid-area:1/1;margin:0;overflow-wrap:anywhere}.reserve{visibility:hidden}.scope{margin-top:14px;color:var(--muted);font-size:12px}.scope summary{padding:8px 0;cursor:pointer}.scope p{margin-top:10px;overflow-wrap:anywhere}.metrics{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:14px;margin:18px 0}.metrics>div{border-left:2px solid var(--accent);padding:0 6px 0 10px;min-width:0}.metrics span{display:block;min-height:3.6em;color:var(--muted);font-size:12px;overflow-wrap:anywhere}.metrics strong{font-size:21px;display:block;min-height:2em;font-weight:550;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.check{display:flex;align-items:center;gap:9px;font-size:13px;margin:14px 0}.check input{width:18px;height:18px;flex-shrink:0;accent-color:var(--accent)}select,input[type=text],input[type=number]{background:var(--paper);color:var(--ink);font:inherit;font-size:14px;padding:10px;border:1px solid var(--rule);border-radius:7px;max-width:100%;min-width:0}select{width:100%;min-height:44px}.panel{padding:14px;border:1px solid var(--rule);border-radius:9px;margin:16px 0;min-width:0}.panel>header{font-size:13px;font-weight:600;margin-bottom:12px;color:var(--muted)}.panel>div{overflow-wrap:anywhere}.track-row{margin:16px 0}.track-row>span{display:block;font-size:12px;color:var(--muted);margin-bottom:8px}.track{display:flex;gap:5px;min-width:0}.cell{flex:1;min-width:0;min-height:56px;border:1px solid var(--rule);border-radius:5px;background:var(--surface);display:flex;align-items:center;justify-content:center;text-align:center;padding:6px 3px;font-size:12px;overflow-wrap:anywhere}.cell.on{background:var(--accent-soft);border-color:var(--accent)}.cell.gold{background:var(--second-soft);border-color:var(--second)}.cell.empty{border-style:dashed;color:var(--muted)}.cell.error{border-color:var(--second);text-decoration:line-through}.table{display:grid;gap:5px;font-size:12px}.tr{display:grid;gap:5px}.tr>div{background:var(--surface);border-radius:4px;padding:9px 6px;min-width:0;min-height:5em;overflow-wrap:anywhere;display:flex;align-items:center}.tr>.gold{background:var(--second-soft)}.tr>.on{background:var(--accent-soft)}.formula,.source{font:13px/1.8 ui-monospace,monospace;white-space:pre-wrap;overflow-wrap:anywhere;margin:16px 0}.formula{border-top:1px solid var(--rule);padding-top:12px;min-height:7.2em}.source{min-height:8em;background:var(--surface);padding:12px;border-radius:8px}.intervals{margin:16px 0}.interval{position:relative;height:38px;background:var(--surface);margin:6px 0;border-radius:4px;overflow:hidden}.interval i{position:absolute;height:100%;background:var(--accent-soft);border-left:2px solid var(--accent)}.interval i.gold{background:var(--second-soft);border-color:var(--second)}.interval span{position:relative;z-index:1;font:12px/38px ui-monospace,monospace;padding-left:7px}.bars{display:grid;gap:10px;margin:16px 0}.bar-row{display:grid;grid-template-columns:44px minmax(0,1fr) 62px;gap:8px;align-items:center;font:12px ui-monospace,monospace}.bar-track{height:24px;background:var(--surface);border-radius:4px;overflow:hidden}.bar-track i{display:block;height:100%;background:var(--accent);transition:width .2s}.bar-track i.gold{background:var(--second)}.bar-track i.empty{opacity:.2}.bar-row output{text-align:right}.diagram{display:block;width:100%;height:auto;margin:18px 0}.diagram text{font:13px ui-monospace,monospace;fill:var(--ink)}.node{fill:var(--surface);stroke:var(--rule)}.node.on{fill:var(--accent-soft);stroke:var(--accent)}.node.gold{fill:var(--second-soft);stroke:var(--second)}.edge{stroke:var(--rule);stroke-width:2;fill:none}.edge.on{stroke:var(--accent)}.matrix{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:6px;margin:16px 0}.matrix button{min-width:0;min-height:44px;font:13px ui-monospace,monospace}.matrix button[aria-pressed=true]{background:var(--accent-soft);border-color:var(--accent)}.matrix button.masked{opacity:.35}.legend{font-size:12px;color:var(--muted);min-height:3.6em;overflow-wrap:anywhere}.numeric{font-variant-numeric:tabular-nums}.scope p{line-break:strict}@media(max-width:480px){.presets button,.actions button{font-size:12px}.panel{padding:12px}.metrics{gap:10px}.metrics strong{font-size:19px}.bar-row{grid-template-columns:34px minmax(0,1fr) 58px;gap:6px}}@media(prefers-reduced-motion:reduce){*,*::before,*::after{transition:none!important;animation:none!important}}\n\n.panel>h3{font-size:13px;font-weight:600;margin:0 0 12px;color:var(--muted)}\n\n.bar-row{grid-template-columns:44px minmax(0,1fr) 82px}.bar-row output{white-space:nowrap}@media(max-width:480px){.bar-row{grid-template-columns:34px minmax(0,1fr) 76px}}\n\n","js":"const $=s=>document.querySelector(s);const set=(id,v)=>$('#'+id).textContent=v;const t=k=>viz.t(k);function cells(id,values){$('#'+id).replaceChildren(...values.map(v=>{const e=document.createElement('div');e.className='cell '+(v.cls||'');e.textContent=v.text;e.title=v.title||v.text;return e;}));}function pressed(mode){document.querySelectorAll('[data-mode]').forEach(e=>e.setAttribute('aria-pressed',String(e.dataset.mode===mode)));}const esc=s=>String(s).replace(/[&<>\"']/g,c=>({'&':'&','<':'<','>':'>','\"':'"',\"'\":'''}[c]));const fmt=s=>'{'+[...s].sort().join(', ')+'}';function graph(id,nodes,edges){const el=$('#'+id);el.setAttribute('viewBox','0 0 360 200');el.innerHTML='<defs><marker id=\"arrow-'+id+'\" viewBox=\"0 0 10 10\" refX=\"8\" refY=\"5\" markerWidth=\"5\" markerHeight=\"5\" orient=\"auto-start-reverse\"><path d=\"M 0 0 L 10 5 L 0 10 z\" fill=\"var(--muted)\"/></marker></defs>'+edges.map(e=>{const a=nodes[e[0]],b=nodes[e[1]],dx=b.x-a.x,dy=b.y-a.y,d=Math.hypot(dx,dy)||1;if(edges.some(r=>r[0]===e[1]&&r[1]===e[0])){const nx=-dy/d,ny=dx/d;return '<path class=\"edge '+(e[2]?'on':'')+'\" d=\"M '+(a.x+dx/d*22+nx*12)+' '+(a.y+dy/d*22+ny*12)+' Q '+((a.x+b.x)/2+nx*38)+' '+((a.y+b.y)/2+ny*38)+' '+(b.x-dx/d*25+nx*12)+' '+(b.y-dy/d*25+ny*12)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}return '<line class=\"edge '+(e[2]?'on':'')+'\" x1=\"'+(a.x+dx/d*25)+'\" y1=\"'+(a.y+dy/d*25)+'\" x2=\"'+(b.x-dx/d*28)+'\" y2=\"'+(b.y-dy/d*28)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}).join('')+nodes.map(n=>'<g><circle class=\"node '+(n.cls||'')+'\" cx=\"'+n.x+'\" cy=\"'+n.y+'\" r=\"25\"/><text x=\"'+n.x+'\" y=\"'+(n.y+4)+'\" text-anchor=\"middle\">'+esc(n.name)+'</text>'+(n.sub?'<text x=\"'+n.x+'\" y=\"'+(n.y+43)+'\" text-anchor=\"middle\">'+esc(n.sub)+'</text>':'')+'</g>').join('');}function table(id,rows){$('#'+id).classList.add('table');$('#'+id).replaceChildren(...rows.map(r=>{const row=document.createElement('div');row.className='tr';row.style.gridTemplateColumns='repeat('+r.length+',minmax(0,1fr))';r.forEach(x=>{const c=document.createElement('div');if(typeof x==='object'){c.textContent=x.text;c.className=x.cls||'';}else c.textContent=x;row.append(c)});return row;}));}function band(id,parts,total){$('#'+id).replaceChildren(...parts.map((p,i)=>{const e=document.createElement('i');e.style.width=(100*p.value/total)+'%';e.className=i%2?'gold':'on';e.title=p.name+': '+p.value;return e}));}function intervals(id,items,total){$('#'+id).replaceChildren(...items.map(p=>{const row=document.createElement('div');row.className='interval';const bar=document.createElement('i');bar.style.left=(100*p.start/total)+'%';bar.style.width=(100*(p.end-p.start)/total)+'%';bar.className=p.cls||'';const label=document.createElement('span');label.textContent=p.label;row.append(bar,label);return row;}));}function plot(id,series,xr,yr,opts={}){const e=$('#'+id),X=x=>42+(x-xr[0])/(xr[1]-xr[0])*298,Y=y=>175-(y-yr[0])/(yr[1]-yr[0])*148;let out='<defs><clipPath id=\"clip-'+id+'\"><rect x=\"42\" y=\"27\" width=\"298\" height=\"148\"/></clipPath></defs>';for(let i=0;i<3;i++){let x=xr[0]+i*(xr[1]-xr[0])/2,y=yr[0]+i*(yr[1]-yr[0])/2;out+='<path class=\"gridline\" d=\"M '+X(x)+' 27V175M42 '+Y(y)+'H340\"/><text x=\"'+X(x)+'\" y=\"194\" text-anchor=\"middle\">'+esc(opts.xfmt?opts.xfmt(x):Number(x.toFixed(2)))+'</text><text x=\"36\" y=\"'+(Y(y)+4)+'\" text-anchor=\"end\">'+esc(opts.yfmt?opts.yfmt(y):Number(y.toFixed(2)))+'</text>';}out+='<g clip-path=\"url(#clip-'+id+')\">';for(const s of series){out+='<path fill=\"none\" stroke=\"'+(s.color||'var(--accent)')+'\" stroke-width=\"2.5\" '+(s.dash?'stroke-dasharray=\"5 4\"':'')+' d=\"'+s.pts.map((p,i)=>(i?'L':'M')+X(p[0]).toFixed(2)+','+Y(p[1]).toFixed(2)).join(' ')+'\"/>';}for(const p of opts.points||[])out+='<circle cx=\"'+X(p[0])+'\" cy=\"'+Y(p[1])+'\" r=\"4\" fill=\"var(--second)\" stroke=\"var(--paper)\" stroke-width=\"1.5\"/>';if(opts.cursor!==undefined)out+='<path d=\"M'+X(opts.cursor)+' 27V175\" stroke=\"var(--muted)\" stroke-dasharray=\"3 3\"/>';e.innerHTML=out+'</g>';e.dataset.curves=JSON.stringify(series.map(s=>s.pts));}const curve=(fn,lo,hi,n=120)=>Array.from({length:n+1},(_,i)=>{const x=lo+(hi-lo)*i/n;return[x,fn(x)]});function inputs(draw){document.querySelectorAll('input,select').forEach(e=>{e.addEventListener('input',draw);e.addEventListener('change',draw)});draw()}const n=id=>+$('#'+id).value;const show=(id,v,d=3)=>set(id,Number(v.toFixed(d)));function bars(id,values,max=1){$('#'+id).className='bars';$('#'+id).innerHTML=values.map(v=>'<div class=\"bar-row\"><span>'+esc(v.label)+'</span><div class=\"bar-track\"><i class=\"'+(v.cls||'')+'\" style=\"width:'+Math.max(0,Math.min(100,v.value/max*100))+'%\"></i></div><output>'+esc(v.text??(v.value*100).toFixed(1)+'%')+'</output></div>').join('')}function softmax(z,T=1){let max=Math.max(...z),w=z.map(x=>Math.exp((x-max)/T)),sum=w.reduce((a,b)=>a+b,0);return w.map(x=>x/sum)}function draw(){let c=$('#dependency').checked?4:0,end=c+6,o=n('overhead'),total=end+3+o;intervals('timeline',[{label:'A 0→2',start:0,end:2},{label:'B 0→4',start:0,end:4},{label:'C '+c+'→'+end,start:c,end},{label:'D '+end+'→'+(end+3),start:end,end:end+3,cls:'gold'},{label:'+ '+o,start:end+3,end:total,cls:'gold'}],19);set('overhead-value',o);set('parallel',total);set('speedup',(15/total).toFixed(2)+'×');set('explanation',t('explain'));document.body.dataset.total=total;}inputs(draw);","audio":false,"strings":{"dependency":"C 必须等 B 完成","explain":"默认最长工作 C 用 6,加上合并 3,完成于 9。C 依赖 B 后最长路径变成 B→C→D,共 13;协调再花 3,就比串行 15 更慢。","heading":"增加并行,为什么没有按人数提速?","intro":"改变 C 的前置依赖和协调开销,观察完成时间。","overhead":"额外协调时间","parallel":"并行完成时间","reset":"重置","scope":"A=2、B=4、C=6、最终合并 D=3;A/B/C 可各用一个 worker,D 等待全部完成,无资源争用。","scopeLabel":"模型范围与约定","speedup":"相对串行 15 的加速比","timeline":"并行时间线"}}
委派是交付一个任务契约
“你负责检查兼容性”过于模糊:检查哪个版本、哪些接口、是否允许修改、需要什么证据都没有定义。协调者应把 Worker 完成任务所需的信息交付完整,同时避免倾倒全部主会话历史。
| 契约项目 | 示例 |
| 目标 | 检查迁移方案是否破坏已有导入格式 |
| 输入与版本 | schema-v3、样例集 R12、方案 draft-4 |
| 范围 | 只分析格式兼容,不修改实现 |
| 可用能力与权限 | 读取样例、运行本地验证;不发布产物 |
| 输出 | 兼容矩阵、失败样例、证据位置、未覆盖项 |
| 停止条件 | 完成矩阵或达到已分配预算,明确剩余缺口 |
| 合并接口 | 结果写到任务专属目录并回传标识 |
工具、历史、文件系统是否共享依运行环境而定。即使共享目录,Worker 也未必已经读过文件;即使不共享历史,也可以通过明确输入恢复必要背景。委派消息应说明实际可访问的资源,而不是假定对方“知道前面聊过什么”。
如果主任务要求“先只改中文”,这个约束必须传给所有可能修改文档的 Worker。主 Agent 的授权也不是任意扩张工具权限的理由:只读检查任务应获得它需要的能力,越出范围的发现交回协调者决定。
产物所有权与结果验收
给写入划定边界
共享工作区中,两个 Agent 同时修改同一文件可能覆盖内容;分配不同文件也不一定独立,因为它们可能共同改变某个接口约定。可选择按目录或产物分工、使用独立分支或工作副本,再由一个明确的集成者合并。
隔离的副本减少直接覆盖,却不能避免语义冲突。例如 B 把字段改名为 item_id,C 的测试仍认为字段叫 sku;即使补丁文本能自动合并,集成后也会失败。契约中固定接口版本,变更时先传播给依赖方,可以减少这种无效工作。
摘要用于定位,证据用于确认
Worker 返回“检查通过”不够。结果应包含针对的输入版本、采用的方法、可查看产物和未覆盖项。协调者先检查目标覆盖,再核验版本与证据,最后决定接受、补充还是重新划分。
| 返回情况 | 协调者动作 |
| 所有结论有对应样例与检查结果 | 接受并纳入整体证据 |
| 结论正确但只覆盖部分格式 | 标记部分完成,分配明确缺口 |
| 两个 Worker 结论冲突 | 回到原始条件与版本,不直接多数表决 |
| 引用文件存在但已被后续修改 | 核对哈希或提交,重新验证相关结论 |
| 只有流畅摘要,没有可核验产物 | 视任务风险要求补证据 |
独立评审有助于发现遗漏,但另一个同模型 Agent 也可能共享同样偏差。“作者与评审分离”提供角色和上下文差异,不等于统计独立或证明正确。把明确标准、独立测试、实际运行与必要的人类评审结合,才有可解释的验证边界。
worker 成功,为什么仍不能合并?
结果归档可以保存所有尝试,正式产物合并却只能接受满足当前合同的结果。把“worker 已结束”“结果已收到”“结果已验收并合并”拆成不同状态,避免一个 success 字段承担三种含义。
正在呈现知识画面
worker 成功,为什么仍不能合并?成功状态不等于当前有效结果;合并门必须检查任务身份、当前尝试、输入版本与验收证据。
{"id":"ai-stale-result","title":"worker 成功,为什么仍不能合并?","summary":"成功状态不等于当前有效结果;合并门必须检查任务身份、当前尝试、输入版本与验收证据。","height":1000,"html":"<h2 data-i18n=\"heading\"></h2><p class=\"intro\" data-i18n=\"intro\"></p><div class=\"control\"><label for=\"attempt\" data-i18n=\"attempt\"></label><output for=\"attempt\" id=\"attempt-value\"></output><input id=\"attempt\" type=\"range\" min=\"1\" max=\"2\" value=\"1\" step=\"1\"></div><div class=\"control\"><label for=\"version\" data-i18n=\"version\"></label><output for=\"version\" id=\"version-value\"></output><input id=\"version\" type=\"range\" min=\"3\" max=\"4\" value=\"4\" step=\"1\"></div><label class=\"check\"><input type=\"checkbox\" id=\"evidence\" checked><span data-i18n=\"evidence\"></span></label><section class=\"panel\"><h3 data-i18n=\"checks\"></h3><div id=\"checks\"></div></section><div class=\"copy\"><p id=\"explanation\" role=\"status\"></p><p class=\"reserve\" aria-hidden=\"true\" data-i18n=\"explain\"></p></div><details class=\"scope\"><summary data-i18n=\"scopeLabel\"></summary><p data-i18n=\"scope\"></p></details>","css":".intro{margin:8px 0 18px;color:var(--muted);font-size:14px}.control{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:6px 12px;align-items:center;margin:14px 0;font-size:13px}.control output{color:var(--accent);text-align:right;font-variant-numeric:tabular-nums;min-width:4em}.control input{grid-column:1/-1;width:100%;margin:0}.presets{display:flex;gap:4px;align-items:stretch}.presets button{flex:1;min-width:0;overflow-wrap:anywhere;font-size:13px;min-height:44px}.actions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin:16px 0}.actions button{min-width:0;min-height:44px;font-size:13px;overflow-wrap:anywhere}.copy{display:grid;font-size:14px;margin:16px 0}.copy>*{grid-area:1/1;margin:0;overflow-wrap:anywhere}.reserve{visibility:hidden}.scope{margin-top:14px;color:var(--muted);font-size:12px}.scope summary{padding:8px 0;cursor:pointer}.scope p{margin-top:10px;overflow-wrap:anywhere}.metrics{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:14px;margin:18px 0}.metrics>div{border-left:2px solid var(--accent);padding:0 6px 0 10px;min-width:0}.metrics span{display:block;min-height:3.6em;color:var(--muted);font-size:12px;overflow-wrap:anywhere}.metrics strong{font-size:21px;display:block;min-height:2em;font-weight:550;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.check{display:flex;align-items:center;gap:9px;font-size:13px;margin:14px 0}.check input{width:18px;height:18px;flex-shrink:0;accent-color:var(--accent)}select,input[type=text],input[type=number]{background:var(--paper);color:var(--ink);font:inherit;font-size:14px;padding:10px;border:1px solid var(--rule);border-radius:7px;max-width:100%;min-width:0}select{width:100%;min-height:44px}.panel{padding:14px;border:1px solid var(--rule);border-radius:9px;margin:16px 0;min-width:0}.panel>header{font-size:13px;font-weight:600;margin-bottom:12px;color:var(--muted)}.panel>div{overflow-wrap:anywhere}.track-row{margin:16px 0}.track-row>span{display:block;font-size:12px;color:var(--muted);margin-bottom:8px}.track{display:flex;gap:5px;min-width:0}.cell{flex:1;min-width:0;min-height:56px;border:1px solid var(--rule);border-radius:5px;background:var(--surface);display:flex;align-items:center;justify-content:center;text-align:center;padding:6px 3px;font-size:12px;overflow-wrap:anywhere}.cell.on{background:var(--accent-soft);border-color:var(--accent)}.cell.gold{background:var(--second-soft);border-color:var(--second)}.cell.empty{border-style:dashed;color:var(--muted)}.cell.error{border-color:var(--second);text-decoration:line-through}.table{display:grid;gap:5px;font-size:12px}.tr{display:grid;gap:5px}.tr>div{background:var(--surface);border-radius:4px;padding:9px 6px;min-width:0;min-height:5em;overflow-wrap:anywhere;display:flex;align-items:center}.tr>.gold{background:var(--second-soft)}.tr>.on{background:var(--accent-soft)}.formula,.source{font:13px/1.8 ui-monospace,monospace;white-space:pre-wrap;overflow-wrap:anywhere;margin:16px 0}.formula{border-top:1px solid var(--rule);padding-top:12px;min-height:7.2em}.source{min-height:8em;background:var(--surface);padding:12px;border-radius:8px}.intervals{margin:16px 0}.interval{position:relative;height:38px;background:var(--surface);margin:6px 0;border-radius:4px;overflow:hidden}.interval i{position:absolute;height:100%;background:var(--accent-soft);border-left:2px solid var(--accent)}.interval i.gold{background:var(--second-soft);border-color:var(--second)}.interval span{position:relative;z-index:1;font:12px/38px ui-monospace,monospace;padding-left:7px}.bars{display:grid;gap:10px;margin:16px 0}.bar-row{display:grid;grid-template-columns:44px minmax(0,1fr) 62px;gap:8px;align-items:center;font:12px ui-monospace,monospace}.bar-track{height:24px;background:var(--surface);border-radius:4px;overflow:hidden}.bar-track i{display:block;height:100%;background:var(--accent);transition:width .2s}.bar-track i.gold{background:var(--second)}.bar-track i.empty{opacity:.2}.bar-row output{text-align:right}.diagram{display:block;width:100%;height:auto;margin:18px 0}.diagram text{font:13px ui-monospace,monospace;fill:var(--ink)}.node{fill:var(--surface);stroke:var(--rule)}.node.on{fill:var(--accent-soft);stroke:var(--accent)}.node.gold{fill:var(--second-soft);stroke:var(--second)}.edge{stroke:var(--rule);stroke-width:2;fill:none}.edge.on{stroke:var(--accent)}.matrix{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:6px;margin:16px 0}.matrix button{min-width:0;min-height:44px;font:13px ui-monospace,monospace}.matrix button[aria-pressed=true]{background:var(--accent-soft);border-color:var(--accent)}.matrix button.masked{opacity:.35}.legend{font-size:12px;color:var(--muted);min-height:3.6em;overflow-wrap:anywhere}.numeric{font-variant-numeric:tabular-nums}.scope p{line-break:strict}@media(max-width:480px){.presets button,.actions button{font-size:12px}.panel{padding:12px}.metrics{gap:10px}.metrics strong{font-size:19px}.bar-row{grid-template-columns:34px minmax(0,1fr) 58px;gap:6px}}@media(prefers-reduced-motion:reduce){*,*::before,*::after{transition:none!important;animation:none!important}}\n\n.panel>h3{font-size:13px;font-weight:600;margin:0 0 12px;color:var(--muted)}\n\n.bar-row{grid-template-columns:44px minmax(0,1fr) 82px}.bar-row output{white-space:nowrap}@media(max-width:480px){.bar-row{grid-template-columns:34px minmax(0,1fr) 76px}}\n\n","js":"const $=s=>document.querySelector(s);const set=(id,v)=>$('#'+id).textContent=v;const t=k=>viz.t(k);function cells(id,values){$('#'+id).replaceChildren(...values.map(v=>{const e=document.createElement('div');e.className='cell '+(v.cls||'');e.textContent=v.text;e.title=v.title||v.text;return e;}));}function pressed(mode){document.querySelectorAll('[data-mode]').forEach(e=>e.setAttribute('aria-pressed',String(e.dataset.mode===mode)));}const esc=s=>String(s).replace(/[&<>\"']/g,c=>({'&':'&','<':'<','>':'>','\"':'"',\"'\":'''}[c]));const fmt=s=>'{'+[...s].sort().join(', ')+'}';function graph(id,nodes,edges){const el=$('#'+id);el.setAttribute('viewBox','0 0 360 200');el.innerHTML='<defs><marker id=\"arrow-'+id+'\" viewBox=\"0 0 10 10\" refX=\"8\" refY=\"5\" markerWidth=\"5\" markerHeight=\"5\" orient=\"auto-start-reverse\"><path d=\"M 0 0 L 10 5 L 0 10 z\" fill=\"var(--muted)\"/></marker></defs>'+edges.map(e=>{const a=nodes[e[0]],b=nodes[e[1]],dx=b.x-a.x,dy=b.y-a.y,d=Math.hypot(dx,dy)||1;if(edges.some(r=>r[0]===e[1]&&r[1]===e[0])){const nx=-dy/d,ny=dx/d;return '<path class=\"edge '+(e[2]?'on':'')+'\" d=\"M '+(a.x+dx/d*22+nx*12)+' '+(a.y+dy/d*22+ny*12)+' Q '+((a.x+b.x)/2+nx*38)+' '+((a.y+b.y)/2+ny*38)+' '+(b.x-dx/d*25+nx*12)+' '+(b.y-dy/d*25+ny*12)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}return '<line class=\"edge '+(e[2]?'on':'')+'\" x1=\"'+(a.x+dx/d*25)+'\" y1=\"'+(a.y+dy/d*25)+'\" x2=\"'+(b.x-dx/d*28)+'\" y2=\"'+(b.y-dy/d*28)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}).join('')+nodes.map(n=>'<g><circle class=\"node '+(n.cls||'')+'\" cx=\"'+n.x+'\" cy=\"'+n.y+'\" r=\"25\"/><text x=\"'+n.x+'\" y=\"'+(n.y+4)+'\" text-anchor=\"middle\">'+esc(n.name)+'</text>'+(n.sub?'<text x=\"'+n.x+'\" y=\"'+(n.y+43)+'\" text-anchor=\"middle\">'+esc(n.sub)+'</text>':'')+'</g>').join('');}function table(id,rows){$('#'+id).classList.add('table');$('#'+id).replaceChildren(...rows.map(r=>{const row=document.createElement('div');row.className='tr';row.style.gridTemplateColumns='repeat('+r.length+',minmax(0,1fr))';r.forEach(x=>{const c=document.createElement('div');if(typeof x==='object'){c.textContent=x.text;c.className=x.cls||'';}else c.textContent=x;row.append(c)});return row;}));}function band(id,parts,total){$('#'+id).replaceChildren(...parts.map((p,i)=>{const e=document.createElement('i');e.style.width=(100*p.value/total)+'%';e.className=i%2?'gold':'on';e.title=p.name+': '+p.value;return e}));}function intervals(id,items,total){$('#'+id).replaceChildren(...items.map(p=>{const row=document.createElement('div');row.className='interval';const bar=document.createElement('i');bar.style.left=(100*p.start/total)+'%';bar.style.width=(100*(p.end-p.start)/total)+'%';bar.className=p.cls||'';const label=document.createElement('span');label.textContent=p.label;row.append(bar,label);return row;}));}function plot(id,series,xr,yr,opts={}){const e=$('#'+id),X=x=>42+(x-xr[0])/(xr[1]-xr[0])*298,Y=y=>175-(y-yr[0])/(yr[1]-yr[0])*148;let out='<defs><clipPath id=\"clip-'+id+'\"><rect x=\"42\" y=\"27\" width=\"298\" height=\"148\"/></clipPath></defs>';for(let i=0;i<3;i++){let x=xr[0]+i*(xr[1]-xr[0])/2,y=yr[0]+i*(yr[1]-yr[0])/2;out+='<path class=\"gridline\" d=\"M '+X(x)+' 27V175M42 '+Y(y)+'H340\"/><text x=\"'+X(x)+'\" y=\"194\" text-anchor=\"middle\">'+esc(opts.xfmt?opts.xfmt(x):Number(x.toFixed(2)))+'</text><text x=\"36\" y=\"'+(Y(y)+4)+'\" text-anchor=\"end\">'+esc(opts.yfmt?opts.yfmt(y):Number(y.toFixed(2)))+'</text>';}out+='<g clip-path=\"url(#clip-'+id+')\">';for(const s of series){out+='<path fill=\"none\" stroke=\"'+(s.color||'var(--accent)')+'\" stroke-width=\"2.5\" '+(s.dash?'stroke-dasharray=\"5 4\"':'')+' d=\"'+s.pts.map((p,i)=>(i?'L':'M')+X(p[0]).toFixed(2)+','+Y(p[1]).toFixed(2)).join(' ')+'\"/>';}for(const p of opts.points||[])out+='<circle cx=\"'+X(p[0])+'\" cy=\"'+Y(p[1])+'\" r=\"4\" fill=\"var(--second)\" stroke=\"var(--paper)\" stroke-width=\"1.5\"/>';if(opts.cursor!==undefined)out+='<path d=\"M'+X(opts.cursor)+' 27V175\" stroke=\"var(--muted)\" stroke-dasharray=\"3 3\"/>';e.innerHTML=out+'</g>';e.dataset.curves=JSON.stringify(series.map(s=>s.pts));}const curve=(fn,lo,hi,n=120)=>Array.from({length:n+1},(_,i)=>{const x=lo+(hi-lo)*i/n;return[x,fn(x)]});function inputs(draw){document.querySelectorAll('input,select').forEach(e=>{e.addEventListener('input',draw);e.addEventListener('change',draw)});draw()}const n=id=>+$('#'+id).value;const show=(id,v,d=3)=>set(id,Number(v.toFixed(d)));function bars(id,values,max=1){$('#'+id).className='bars';$('#'+id).innerHTML=values.map(v=>'<div class=\"bar-row\"><span>'+esc(v.label)+'</span><div class=\"bar-track\"><i class=\"'+(v.cls||'')+'\" style=\"width:'+Math.max(0,Math.min(100,v.value/max*100))+'%\"></i></div><output>'+esc(v.text??(v.value*100).toFixed(1)+'%')+'</output></div>').join('')}function softmax(z,T=1){let max=Math.max(...z),w=z.map(x=>Math.exp((x-max)/T)),sum=w.reduce((a,b)=>a+b,0);return w.map(x=>x/sum)}function draw(){let a=n('attempt'),v=n('version'),e=$('#evidence').checked,ok=a===2&&v===4&&e;set('attempt-value',a);set('version-value','v'+v);table('checks',[[t('current'),'T / 2 / v4'],[t('candidate'),'T / '+a+' / v'+v],[t('attempt'),a===2?'✓':'×'],[t('version'),v===4?'✓':'×'],[t('evidence'),e?'✓':'×'],[t('accepted'),ok?'✓':'×']]);set('explanation',t('explain'));document.body.dataset.accepted=ok;}inputs(draw);","audio":false,"strings":{"accepted":"允许合并","attempt":"结果的 attempt","candidate":"收到的结果","checks":"合并条件","current":"当前任务","evidence":"验收报告通过","explain":"旧尝试可能比新尝试更晚返回。按“最后到达者覆盖”合并会复活过期结果;检查 attempt 与输入版能把迟到成功与当前成功区分开。","heading":"worker 成功,为什么仍不能合并?","intro":"选择结果所属的尝试与输入版本,对照当前任务。","reset":"重置","scope":"任务固定 T,当前 attempt=2、input=v4;所有候选都声称成功且属于 T,只改变尝试、版本和检查报告。","scopeLabel":"模型范围与约定","version":"结果的输入版本"}}
编排也需要恢复语义
协调者应为每个子任务保存任务 ID、尝试编号、输入版本、状态和产物位置。状态至少区分 queued、running、completed、accepted、failed、cancelled:Worker 已完成,只代表结果产生;accepted 才表示协调者已确认可用于整体交付。
假设尝试 1 超时,协调者启动尝试 2;稍后尝试 1 的旧结果到达。若只按子任务名接受,会让旧内容覆盖新内容。需要按尝试编号与输入版本核验迟到结果,必要时把它留作参考而不自动发布。
取消也不保证旧 Worker 立刻停止写入。共享资源场景要控制提交权限,例如由集成者核验当前有效尝试或版本后才写入权威产物;否则界面显示 cancelled 的 Worker 仍可能在后台覆盖文件。跨执行者的状态规则与 记忆与状态 中的条件更新相呼应。
| 故障 | 恢复时先确认 |
| Worker 失联 | 有没有已完成产物,是否仍可能执行 |
| 协调者重启 | 哪些任务已接受,哪些结果未知 |
| 子任务重复启动 | 两个尝试是否会写同一资源 |
| 合并过程中失败 | 哪部分已落盘,能否恢复或回退 |
| 外部副作用响应丢失 | 业务操作实际是否完成,不能只看线程状态 |
怎样判断多 Agent 确实有收益
用同一任务集比较单 Agent、单 Agent 并行工具和多 Agent,尽量保持工具权限、输入证据与验收标准一致。除了任务成功率和总延迟,还记录主 Agent 协调时间、重复工作比例、冲突数、失败重试与全部成本。
如果 Worker 很快而主 Agent 长时间反复澄清和合并,瓶颈是任务划分或结果契约;如果两个 Worker 总查相同材料,范围可能重叠;如果总是合并后失败,应检查共享接口与集成测试。如果单 Agent 的批量工具已达到相同效果,就没有必要为了角色数量增加维护成本。
更详细的指标和逐任务追踪在 评估与可观测 展开。评估的单位应是用户的完整任务,不能只统计启动了多少 Agent 或产生了多少条消息。
继续阅读:评估、试次与可观测。