microsoft/conductor

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?"

3. 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、團隊協作與生產級工作負載。