面向 AI 编码助手的多 Agent 编排框架,支持 Lead/Worker 架构、DAG 工作流、复利式记忆与多通道任务接入。
核心架构#
Agent Swarm 采用 Lead/Worker 编排模式——Lead Agent 负责任务接收与拆分,Worker Agent 运行在 Docker 容器中提供隔离的完整开发环境,支持多仓库并行处理。数据存储基于 SQLite,API 服务同时支持 HTTP(端口 3013)和 MCP 协议,提供 OpenAPI 3.1 规范。
编排与调度#
- DAG 工作流引擎:基于有向无环图的自动化,支持 trigger、condition、action、重试及结构化 I/O
- Human-in-the-Loop:工作流中的审批门,支持 Dashboard UI 和 Slack 通知
- 定时与周期任务:支持 cron / interval / delayed 调度
记忆与知识体系#
- 复利式记忆:Agent 每次会话后提取学习成果写入共享记忆,未来任务可复用
- 持久身份:每个 Agent 拥有独立 persona、expertise 和 notes,随时间演化
- Skill 系统:可复用的程序化知识,Agent 可创建、共享、安装和发布 skill
- Agent-fs:持久化可搜索文件系统
多通道任务接入#
支持 Slack DM/@mention、GitHub App @mention/issue assign、GitLab webhooks、AgentMail(邮件→任务)、Linear 双向同步、HTTP API 创建任务。
AI 后端支持#
- Claude Code(推荐 harness)
- OpenAI Codex(API key / ChatGPT OAuth)
- pi-mono
- Gemini CLI(README 标题提及,具体支持状态待确认)
可观测与运维#
- 实时 Dashboard:监控 Agent 状态、任务进度、Agent 间对话(本地或托管版 app.agent-swarm.dev)
- MCP Server 管理:注册、安装和管理 MCP servers,支持 scope cascade(agent → swarm → global)
- Context 使用追踪、Sentry 错误追踪
其他特性#
x402 USDC 微支付(细节待确认)、Portless 本地开发域名、Per-repo PR/Merge 策略配置、统一用户身份跨平台解析。
快速开始#
前置条件:Docker、Claude Code OAuth token、Bun(>=1.0.26)。
# 交互式向导(推荐)
bunx @desplega.ai/agent-swarm onboard
# 手动部署
git clone https://github.com/desplega-ai/agent-swarm.git
cd agent-swarm
cp .env.docker.example .env
# 编辑 .env — 设置 API_KEY 和 CLAUDE_CODE_OAUTH_TOKEN
docker compose -f docker-compose.example.yml --env-file .env up -d
待确认事项#
- Gemini CLI 具体支持状态
- x402 USDC 微支付实现细节
- Discord 社区邀请链接
- Worker Docker 容器 base image 及环境配置细节
- MCP 协议作为 Server/Client 的能力边界