Orchestrator 编排器

返回 Agent 开发笔记合集

1、定义

Orchestrator 是 Agent 系统中的编排层，负责协调模型调用、工具调用、状态流转、错误处理和子流程执行。

它不一定负责具体业务逻辑，而是负责让各个组件按正确顺序协作。

如果把 Agent 系统比作乐队，Orchestrator 就是指挥：它不一定亲自演奏每个乐器，但决定谁什么时候进场、结果交给谁、失败时怎么继续。

2、为什么它重要

当任务只有一次模型调用时，不需要复杂编排。

但当任务涉及多个步骤、多个工具、多个条件分支、人工审批和失败恢复时，就需要 Orchestrator 管住流程。

没有编排层，系统容易变成一堆散落的工具调用。每个工具都能做事，但整体任务不可控、不可恢复、不可审计。

3、常见职责

Orchestrator 的质量决定了 Agent 是否像一个系统，而不是一串临时脚本。

4、和 Router、Workflow 的区别

Router 更像入口分诊，Workflow 更像流程图，Orchestrator 更像运行时指挥。

在简单系统里，这些角色可能写在同一段代码里；复杂系统里最好拆清楚。

5、一个 Agent 开发例子

一个“自动修复 CI”系统里，Orchestrator 可能这样工作：

1. 接收 CI 失败事件
2. 调用 Router 判断进入 coding-fix workflow
3. 调用 Planner 生成修复计划
4. 调用 Executor 修改代码
5. 调用测试工具验证
6. 如果失败，更新 State 并重试
7. 如果连续失败，升级给人
8. 如果成功，写总结并提交 PR

这里每个步骤可能由不同组件完成，但 Orchestrator 负责整体流转。

6、常见误区

误区一：Orchestrator 就是 Agent

不完全是。Agent 是面向目标的整体系统，Orchestrator 是其中的编排层。

误区二：让 LLM 自己决定所有编排就行

风险很高。LLM 可以参与决策，但停止条件、权限、重试和错误处理应该由系统硬编码或严格约束。

误区三：Orchestrator 只适合多 Agent

不是。单 Agent 只要有多步骤、多工具和状态，也需要编排。

误区四：编排器越通用越好

过度通用会变复杂。好的 Orchestrator 应该围绕业务任务设计清楚的节点和边界。

7、一句话总结

Orchestrator 是 Agent 系统的运行指挥层。它把模型、工具、状态、Workflow 和人工节点协调成一条可执行、可恢复、可审计的任务路径。

参考资料

• Anthropic: Building effective agents
• LangGraph Documentation
• Temporal Documentation