Wink Pings

把Agent从排队改成并行:Gemini Neon 10步蓝图与图工程14步路线图

谷歌高级工程师的19页PDF已被Google Drive判定违规,但Movez的10步提炼还在。Codez的图工程14步,把多代理系统的正确形态讲清楚了:图,不是链。

一份19页PDF,一份14步路线图。它们来自不同的人、不同的工具,但指向同一个结论:多代理系统的正确形态是图,不是直线。

谷歌高级工程师写了那19页PDF,Movez把它拆成了10步操作蓝图。PDF本身已经失效——Google Drive显示它违反了服务条款。有网友在第一页被屏蔽前扫过一眼,指出PDF第一页自称是三份公开资料的合成:Architecture Center、ADK文档、Neon开发者指南。这个判断大概率正确,但10步提炼本身有独立价值。

image

Gemini Neon的10步代理蓝图

  1. 装好stack:pip install google-adk "google-genai>=2.34.0",然后genai.Client(enterprise=True, location="global"),指定model="gemini-4-neon"。
  2. 知道Neon在哪儿强:长工具链任务、1M token上下文、规划和验证。把它当大脑,不是当工人。
  3. 只调一个旋钮:thinking_level。LOW给路由器,MEDIUM给快速工具调用,HIGH给规划,XHIGH给最终检查。temperature可以删了,Neon忽略它。
  4. 写第一个循环:关掉自动函数调用,手动运行Neon要的工具,把结果用相同的id、name和order送回去。重复,直到它不需要工具调用就给出答案。
  5. 不要碰history:原样追加Neon的响应。重建history会丢thought signatures,报错MALFORMED_FUNCTION_CALL。system prompt保持静态,缓存才生效。
  6. 加三条停止规则:一个"done"信号、max_turns、token预算。每次触发都记日志,这是最好的bug探测器。
  7. 加一个critic:LoopAgent(sub_agents=[critic, refiner], max_iterations=5)加exit_loop工具。critic要自己的rubric和真实测试,不要用writer的prompt。
  8. 用图来路由:ADK 2.0 Workflow加Event(route=…),把请求发给对应专家。永远加一条fallback路由,处理"以上都不是"。
  9. 拆分工作:Neon负责规划和验证,Gemini 4 Hydrogen子代理并行跑量,join节点检查每个结果再放行。
  10. 部署到Google Cloud:Cloud Run、Agent Runtime或GKE,流量走Agent Gateway加Model Armor,每个循环在Cloud Trace里留痕。

这个列表的隐含逻辑:Neon是大脑,不干活。规划、验证、收敛判断归它,跑量归便宜的子代理。Movez建议把PDF喂给Claude Code或Google Antigravity,让它们帮你生成代码。

图工程14步:从直线到图

Codez的14步路线图讲的是Claude Code的dynamic workflows。它要解决的问题很具体:大多数多步agent最后都做成了直线。第一步、第二步、第三步,每一步都在等上一步。9/10的情况下,一半的步骤根本不需要等。

Codez在回复里说:"Graph engineering is the next big thing after you know how to build loops." 这句话可以当作整个方法论的注脚。

  1. 节点是工作,边是数据流。图里只有两种东西。and then不是边——如果下一步不读上一步的输出,就没有边,等待就是浪费。
  2. 线性脚本是退化图。单链没有冗余:C卡住,D就没了。切掉不传数据的箭头,链会塌成更宽的形状。
  3. 给节点契约:bounded in,validated out,一件事。用JSON schema让子代理返回结构化数据——验证发生在tool-call层,不匹配就重试,而不是给你自由文本自己解析。
  4. 边是数据契约。flatten、dedupe、filter用JS做,零token。别为"合并结果"开一个agent——那是边,不是节点。把agent省给需要判断力的地方。
  5. 用parallel()扇出。N个独立节点一次跑完。thunk抛异常返回null而不是拖垮整个batch,.filter(Boolean)掉失败项。并发数受核心数限制,多的排队。
  6. 在barrier汇集。只有真正需要全集的地方才用barrier:跨源去重、排名、按总量早退。只是flatten一个列表?那是边,inline做掉。
  7. 菱形是工作拓扑:split → work → merge。fan out收广度,reduce用代码压缩,synthesize用agent写答案。看到菱形,问题从"怎么加步骤"变成"在哪儿拆、在哪儿合"。
  8. 用代码做运行时路由。router节点产出一个分类结果,if/switch决定走哪个分支。Claude的判断在节点里,路由本身是代码——不会出现"Claude决定跳过审计"这种意外。
  9. 在边上放验证器。对抗验证:N个独立skeptic反驳发现,多数存活才放行。多视角验证:正确性、安全性、可复现性,不同视角抓不同故障。法官小组:N个方向生成尝试,并行打分,综合胜者。
  10. 隔离节点。parallel()里一个thunk挂掉返回null,filter(Boolean)就是隔离。并行写文件用worktree,每个agent自己的沙箱,完了干净合入。
  11. 循环要收敛。loop-until-dry:连续K轮没有新发现就停。关键细节:对"所有见过的"去重,不是只对"已确认的"去重。否则被否掉的发现每轮重新出现,循环永远不会干涸。
  12. 模型分级。重复的、边界清晰的活给便宜模型,真正的判断给贵模型。agent()调用可以覆盖模型选项。查/model,把fan-out降到便宜档,merge节点保持高配。
  13. 拓扑就是成本和延迟。parallel()是barrier,等最慢的节点。pipeline()是流式的,每条item独立走完所有阶段。默认pipeline,除非某个阶段真的需要全集。
  14. 让Claude自己画图。描述目标,Claude写编排脚本。说"workflow"这个词,或者用/deep-research,或者开ultracode。跑得好按s存到.claude/workflows/,版本化管理,克隆repo的人都能启动。

Codez给了六个可以直接照抄的图:

  • 安全扫描:每个路由文件一个subagent,找缺失的auth检查,验证器确认每个发现再进报告。
  • 引用报告:/deep-research。拆解问题 → 并行搜索 → 去重源 → 三票skeptic对抗验证 → 综合。
  • 逐文件移植:并行翻译文件,测试套件当门禁,失败的循环回去。Bun ceiling,缩放到你的repo。
  • 对抗性diff审查:按diff大小路由。小改单pass,大改并行审计,多个视角独立审,法官小组综合。
  • 定时生态扫描:并行查release、博客、讨论,在barrier按影响排名,写digest。存到workflows,按名字启动。
  • 未知规模发现:并行finder,对seen去重,验证幸存者,两轮空转就停。适合你不知道有多少bug的代码库。

一个观察

这两份手册的共同点:直线架构把等待写进了每一步,图架构把等待只留给真正需要全集的地方。Codez文章的结尾有一个漂亮的对比——"A prompter asks a question. An architect draws a graph."

多代理系统的问题从来不是"步骤不够多",而是"不必要的依赖太多"。大多数人会继续按打字习惯把步骤排成一队,少数人把图画出来。区别不在工具,在于能不能看到哪些等待是不必要的。

发布时间: 2026-11-22 18:13