microsoft/conductor
A CLI tool for defining and running multi-agent workflows with the GitHub Copilot SDK and Anthropic Agents SDK.
Conductor – 可重复、版本控制的多智能体AI工作流CLI
是什么 – Conductor 是一个命令行工具,允许您在单个 YAML 文件中描述 AI 智能体(Copilot、Claude 等)的流水线,并在本地、CI 或云中运行。编排本身是确定性的(没有 LLM 决定下一步),整个工作流定义以纯文本形式存在,因此您可以像代码一样进行版本控制、差异比较和审查。
为何重要 – 构建可靠的 AI 驱动流水线(代码审查机器人、研究后合成循环、计划后实施周期等)很困难,因为大多数现有解决方案依赖于临时脚本或手动提示。Conductor 为您提供:
- 可重复性 – 相同输入始终遵循相同路径。
- 确定性路由 – 基于 Jinja2 的条件决定下一个运行的智能体,无需为编排消耗 token。
- 源码控制友好 – 工作流是 YAML 文件,可在拉取请求中审查。
核心功能
| 功能 | 说明 |
|---|---|
| 基于 YAML 的工作流定义 | 在可读的文件中声明智能体、提示、路由和子工作流。 |
| 多 AI 提供商支持 | GitHub Copilot、Anthropic Claude、Claude Agent SDK、NousResearch Hermes、Azure Container Apps sandbox(实验性)。 |
| 并行与动态执行 | 并发运行智能体组;for_each 可在运行时对列表进行分发。 |
| 子工作流组合 | 通过模板化输入映射复用工作流片段。 |
| 脚本与设置步骤 | 无需调用 LLM 即可运行 shell 命令或计算 Jinja2 值。 |
| 人机协作门控 | 通过 Markdown 提示、可点击的文件链接或 Web 仪表板暂停以进行手动决策。 |
| 安全限制 | 最大迭代次数限制和超时强制,防止失控运行。 |
| Web 仪表板 | 实时 DAG 可视化、智能体输出的实时流式传输、浏览器内的人机门控。 |
| 舰队管理器 TUI | 终端用户界面,列出所有运行中的工作流,显示状态、token 使用量、成本,并可回答门控或启动新运行。 |
| 验证功能 | 运行前检查缺失输入、过期模板引用和未声明依赖项。 |
典型用例
- 代码审查流水线 – Copilot 智能体编写审查,Claude 智能体总结,人工门控批准后合并。
- 研究后合成 – 一个智能体收集资料,另一个起草报告,最终智能体进行格式化。
- 计划后实施循环 – 智能体提出设计,第二个智能体在隔离的 Azure Container Apps sandbox 中编写代码,第三个智能体验证结果。
安装(快速)
# macOS / Linux
curl -sSfL https://aka.ms/conductor/install.sh | sh
# Windows (PowerShell)
irm https://aka.ms/conductor/install.ps1 | iex
该脚本会安装 uv 包管理器(如需要),拉取最新版本,并创建包含所有依赖项的隔离虚拟环境。更新通过 conductor update(或带 --apply 的相同安装脚本)完成。
运行工作流
- 编写 YAML 文件(例如
my-workflow.yaml)。 - 执行:
conductor run my-workflow.yaml --input question="What is Python?"
- CLI 将打印最终 JSON 输出,您可选择通过
--web或--web-bg启动 Web 仪表板,实时观察 DAG。
示例片段(来自 README)
workflow:
name: simple-qa
entry_point: answerer
agents:
- name: answerer
model: gpt-5.5
prompt: |
Answer the following question:
{{ workflow.input.question }}
output:
answer:
type: string
routes:
- to: $end
output:
answer: "{{ answerer.output.answer }}"
提供者配置 – 在文件顶部设置提供者,例如:
workflow:
runtime:
provider: copilot # 或 openai, claude, hermes, aca 等
default_model: gpt-5.5
认证遵循常规环境变量约定(OPENAI_API_KEY、ANTHROPIC_API_KEY、Copilot 使用 GitHub CLI 登录等)。
可扩展性 – Conductor 随附一个 技能,用于 Claude Code 和 GitHub Copilot CLI,允许在这些助手内使用相同的 workflow 模式。实验性提供者(Claude Agent SDK、Hermes、ACA)可通过 uv add 或 pip install 按文档添加。
总结 – Conductor 将 LLM 驱动的流水线转变为一等、可测试的软件制品。通过保持编排的确定性和版本控制,使 AI 增强的自动化适用于 CI/CD、团队协作和生产级工作负载。
相关
- 项目
- 项目
- 项目
- 项目
- 项目