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 的相同安装脚本)完成。

运行工作流

  1. 编写 YAML 文件(例如 my-workflow.yaml)。
  2. 执行:
conductor run my-workflow.yaml --input question="What is Python?"
  1. 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_KEYANTHROPIC_API_KEY、Copilot 使用 GitHub CLI 登录等)。

可扩展性 – Conductor 随附一个 技能,用于 Claude Code 和 GitHub Copilot CLI,允许在这些助手内使用相同的 workflow 模式。实验性提供者(Claude Agent SDK、Hermes、ACA)可通过 uv addpip install 按文档添加。

总结 – Conductor 将 LLM 驱动的流水线转变为一等、可测试的软件制品。通过保持编排的确定性和版本控制,使 AI 增强的自动化适用于 CI/CD、团队协作和生产级工作负载。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目