ohdearquant/lionagi

解決的問題

lionagi 為編排多代理工作流提供了一個受治理的框架。它透過賦予使用者對執行迴圈的完全控制權、提供型別化且可檢查的狀態，並允許將基於 API 的模型和基於訂閱的 CLI 代理（如 Claude Code）組合到單一工作流中，消除了許多代理框架的「黑盒」性質。

工作原理

該框架使用幾個核心概念來管理代理：

• Branches: 包含歷史紀錄、工具和配置的單個對話執行緒。
• Sessions: 在多個分支上執行 DAG（有向無環圖）工作流的協調器。
• Flows: 編排模式，其中主代理會規劃一個專家工作者的 DAG，這些工作者會隨著依賴關係的解決而執行。
• Fan-outs: 多個工作者的並行執行，並帶有可選的合成步驟以合併結果。
• Persistence: 每次執行都會自動儲存到本地檔案系統，允許使用者重新開始、重新附加或即時監控代理。

使用者可以透過 Python API 進行自定義整合，或透過強大的 CLI (li) 進行代理和工作流的快速部署。它還包括「Lion Studio」，這是一個用於管理專案、進度和執行圖的基於 Web 的 UI。

適用對象

它專為需要對代理狀態和治理進行精確控制的開發人員和 AI 工程師、想要混合使用不同 LLM 提供商（API 和 CLI）的使用者，以及需要具有內建安全護欄的持久、可恢復代理執行之團隊而設計。

亮點

• 混合提供商支援：將 REST API 與基於 CLI 的代理（例如 Claude Code, Codex）無縫整合。
• 持久化執行：所有執行都會自動持久化，實現輕鬆的恢復和監控。
• 治理工具：內建工具呼叫的權限策略、用於阻斷破壞性指令的防護鉤子（guard hooks）以及 git-worktree 沙箱機制。
• 結構化輸出：對基於 Pydantic 的結構化回應提供一流支援。
• 靈活的編排：支援單個代理、並行扇出（fan-outs）和複雜的基於 DAG 的工作流。