desplega-ai/agent-swarm

agent‑swarm – 面向 AI 原生工作的開源作業系統

是什麼 – agent-swarm 是一個框架，允許「主控」AI代理從日常渠道（Slack、郵件、GitHub、API 等）接收任務，並委派給在隔離的 Docker 容器中執行的專用工作代理。工作代理共享一個持久化的「大腦」（向量搜尋記憶體與身分儲存），可在會話間保持上下文，系統可自動為您建立拉取請求、Slack 回覆或郵件回覆。

核心元件

• 主控代理 – 計畫、優先排序並路由傳入的工作。
• 工作代理 – Docker 隔離的執行環境，可執行任何支援的模型（Claude Code、Codex、Pi、Open‑Code、Devin、ACP 等）。
• 持久大腦 – 向量搜尋記憶體 + 身分（SOUL、CLAUDE.md），重啟後仍保留。
• 整合 – 提供 Slack、GitHub/GitLab、Linear、Jira、WhatsApp、Sentry 等預建連接器。
• 即時房間 – 用於協作除錯或即時監控的共享狀態與存在通道。
• 可擴充的 harness – 您可自由選擇底層 LLM 提供商；平台與模型無關。

典型使用情境

• 直接從 Slack 或問題追蹤器自動化程式碼審查與 PR 建立。
• 在完整上下文下執行定時維護腳本（例如，每晚依賴項更新）。
• 建構內部「AI助理」，可讀取工單、撰寫程式碼並回覆客戶，無需人工介入。
• 為希望將資料保留在內部的團隊提供自架設的 AI 原生後端。

快速入門

# 若您使用 Desplega 技能系統，可將技能加入現有操作員
npx skills add desplega-ai/agent-swarm

# 或直接執行倉儲
git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm
cp .env.docker.example .env   # 填入 API_KEY、harness 憑證與八個代理 UUID
openssl rand -base64 32 > encryption_key && chmod 600 encryption_key
docker compose -f docker-compose.example.yml --env-file .env up -d

API 將可於 http://localhost:3013 使用，Swagger 文件位於 /docs。同時提供 Web 仪表板 https://app.agent-swarm.dev 用於視覺化監控。

文件與社群

• 完整文件：https://docs.agent-swarm.dev
• 實時示範網站：https://agent-swarm.dev
• Discord 社群，用於支援與功能討論。
• 貢獻指南與開放 PR 政策（參見 CONTRIBUTING.md）。

授權 – MIT（2025–2026，Desplega Labs）。專案積極維護，歡迎社群貢獻。