guilds.run：能檢查執行過程的開源 AI 代理團隊

guilds.run 是 Cigale AI 開發的開源 AI 代理團隊平台。你能為每個成員設定任務、模型和工具，讓它們共享對話、筆記與資料表，並檢查每次工作的實際過程。

用白話說，這個網站是做什麼的？

它像一個「AI 小組工作台」：研究員蒐集資料，另一位成員準備草稿，你負責查看流程與結果。Guild 就是團隊，Task 是成員每次工作會讀取的長期指示，run 則是一次執行紀錄。平台保留實際送給模型的提示詞、工具呼叫、回傳結果及記憶變更，幫助你理解錯誤從哪一步開始。

它適合需要重複執行研究或業務流程的開發者與營運人員。若只是偶爾問問題，還要考量安裝、模型設定與維護成本。

用角色、筆記和資料表維持協作

不同成員可以使用不同模型。共享筆記保存規則與發現，資料表管理結構化紀錄，腳本保存能再執行的處理邏輯；個別代理的記憶則延續後續工作的上下文。先寫清楚一個小任務的輸入、預期輸出和允許動作，再擴充角色。

連接器可能是原生介面或遠端 MCP 端點。Gmail、Drive、GitHub 也需要管理員完成應用程式和憑證設定。工具可依組織、團隊或單一代理授權；官網展示圖示並不代表帳號已經接好。

先看執行紀錄，再透過 Studio 修改

在回覆旁開啟 Inspect run，先確認實際 Task，再檢查工具輸入與回傳資料。如果錯誤在後續反覆出現，可以對照記憶版本。

Prompt Studio 說明指出，Studio 會分析已有團隊的證據並起草 Task 修正。你查看差異後決定發布或捨棄，教練不會自行發布。修正影響新的執行，過去紀錄保持原樣。這能改善排錯效率，但仍需要確認輸出是否正確。

自行部署與本地模型：資料和費用怎麼算？

截至 2026 年 10 月 14 日，自行部署的核心是採 AGPL-3.0-only 的自由軟體；托管版本是獨立的專有實作，本次沒有核實到可用套餐或額度。免費指軟體，不包含主機、雲端模型和外部工具成本，也沒有核實適用所有使用者的台幣總價。

核心支援 OpenAI、OpenRouter、xAI、DeepInfra，以及 Ollama、LM Studio、vLLM 等相容本地端點。Claude、Gemini 可透過 OpenRouter 接入；Kimi Code 只服務程式開發代理。模型與金鑰文件明確說明，費用由金鑰所屬帳號向供應商支付，Guilds 不設支出上限。

自行部署不代表雲端模型請求留在本機；還要檢查連接器的資料流。Docker 裡的 127.0.0.1 指向容器，連接主機上的模型需使用可達位址。憑證應限縮授權；同一機器上的代理共享信任邊界，必要時用獨立機器隔離。

本次官網隱私與條款連結返回 404，未能確認完整的資料保留及訓練規則，因此不能視為已取得相關隱私保證。

安裝並驗證第一個團隊

準備 Docker 與 Compose、git、bash，依官方安裝指南執行：

git clone https://github.com/CigaleAI/guilds.git
cd guilds
./setup.sh
docker compose up --detach --wait

首次建置可能花數分鐘。保留產生的 .env，裡面有解密已存憑證所需的金鑰。開啟 http://127.0.0.1:8080/。

1. 連接模型供應商，勾選可用模型並設定預設。
2. 建立 guild，新增 agent，在 Prompt 填入並儲存 Task。
3. 在 Group chat 發送小任務；開頭的 @成員名 指定喚醒對象，不加標記會喚醒所有成員。
4. 查看 Inspect run，再提一個延續前次資訊的問題，於 State 檢查記憶版本。

先確認小任務成功，再接入業務帳號或排程。遠端多人存取需要另外設定。

排程和 Recipes 能重用什麼？

Routine 支援暫停；Cron 採 UTC，喚醒間隔至少五分鐘。測試結束後暫停，避免持續使用模型。

Recipes 設定格式以 JSON 保存團隊設定。先 Save as recipe、審核、匯出；匯入後查看建立預覽，完成登入與外部設定清單，再啟用排程。它不搬移金鑰、對話歷史、記憶、資料表紀錄或瀏覽器登入狀態。官網公開 Recipes 目錄仍標示「即將推出」。

常見問題

免費自行部署還會收到帳單嗎？

可能會。主機、雲端模型及外部服務可各自收費，模型預算須在供應商端設定。

能使用本地模型處理敏感資料嗎？

可接入相容端點，但也要檢查外部工具。若使用雲端模型，請求仍會送到供應商；完整隱私條款本次無法核實。

能查看 AI 代理實際做了哪些事嗎？

可以開啟 Inspect run 查看提示詞、工具呼叫與結果，再對照記憶版本。它提供排錯證據，但不會自動保證答案正確。

官方資源與開發者社群

• 官方文件：安裝、連接器與維運。
• GitHub 原始碼及問題回報：實作與授權。
• 官方 X 帳號：產品公告。
• 官網連結的 Discord 社群：可能需要帳號及頻道權限。