Agent Swarm

官方

面向企业的多智能体编排操作系统。

分类: 开发工具第 199 / 438
Stars: ★ 875 非常热门
传输方式: Streamable HTTP
运行环境: Node.js · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 今天

54FMRS · D

资料显示 Agent Swarm 是由 desplega-ai 维护的开源多智能体编排系统，采用 streamable HTTP MCP 传输，支持本地 SQLite、Docker 工作智能体、共享记忆、工作流和多种输入集成。清单未提供具体 MCP 工具名称或客户端兼容性列表，因此工具和客户端信息留空。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

9/20

维护活跃度

12/20

文档质量

14/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: 清单声明了可辨识的 npm、streamable HTTP、认证头和端口，README 也描述了 API/MCP 服务及多种运行方式，因此正常初始化和工具发现是合理可行的。但本次仅有静态材料，没有源代码、CI 或提交测试来验证 MCP 握手、工具行为、错误处理和依赖可控性；清单默认端口 3000 与 README 的 API 端口 3013 还存在矛盾，故大幅扣分。
安全与权限 9/20: API 密钥通过必需的秘密环境变量和 Authorization Bearer 头传递，远程传输使用 HTTPS，且声明了本地实例和 agent ID 边界；材料中没有发现恶意软件、窃取凭据或真实秘密，也没有触发红线。但系统可编排 Docker worker、访问记忆、外部集成、脚本和第三方路由，潜在副作用范围很大；缺少源代码证据证明最小权限、租户隔离、危险操作确认、审计和数据流控制，因此仅给中等分数。
维护活跃度 12/20: 仓库未归档，提供 MIT 许可证、明确维护者组织、当前版本 1.129.0、文档网站和贡献入口；README 还声称仓库每日演进，说明维护信号较强。但没有可核验的提交历史、发布记录、依赖更新、CI 状态、漏洞响应流程或明确安全联系方式；开放 issue 数量本身不证明响应质量，因此扣分。
文档质量 14/20: README 覆盖架构、用例、集成、CLI、部署、Docker、环境变量入口、工作流和多个文档链接，并给出 onboarding、npm/npx 与 Docker 示例，信息层次较丰富。但没有提供 MCP 工具逐项参数、权限边界、限制、成本、失败诊断或兼容客户端配置的可审查证据；端口示例与清单不一致，且许多能力主要是未验证的声明，因此扣分。
安装易用性 11/20: 提供 bunx/npx onboarding、手动 Docker Compose、API/worker/lead 命令及本地端点，理论上能从运行时准备进入可用实例。但仍需 Docker、至少一种 harness 凭据、环境文件编辑和可能的集成配置；没有主流 MCP 客户端的完整连接示例，远程部署步骤也较概括，且 3000/3013 端口不一致，故只能评为中等。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

需要自托管多智能体编排的团队
希望让主智能体协调多个专业工作智能体的工程和运营团队
需要共享记忆、持久身份、工作流或人工审批门的组织
能够管理 Docker、API 密钥和智能体运行环境凭据的用户

不适合谁

只需要单一 MCP 工具或简单聊天助手的用户
无法运行 Docker 或管理智能体运行环境凭据的环境
不希望任务在多个智能体、共享记忆或外部集成之间流转的团队
需要现成桌面客户端兼容性证明的用户

所需权限

需要访问本地或远程 Agent Swarm 实例的 MCP 端点
需要使用 Agent Swarm API 密钥，并在 Authorization 标头中提供 Bearer 前缀
需要提供已注册智能体的 X-Agent-ID
根据启用的集成和运行环境，可能需要 Slack、代码托管、电子邮件、Linear、Jira 或其他服务的凭据

风险与副作用

工作智能体在隔离 Docker 环境中执行任务，仍可能访问为其配置的代码、文件和服务
共享记忆会保存跨会话的学习内容，可能扩大后续任务可见的上下文范围
启用外部集成后，任务可能触发消息、电子邮件、工单更新、代码变更或拉取请求
错误配置 API 密钥、Bearer 标头或智能体 ID 可能导致连接失败或访问错误的智能体实例
自动化工作流和外部操作应结合人工审批门进行审查，尤其是不可逆操作

安装接入

准备工作

运行环境：Node.js · Docker

AGENT_SWARM_API_KEY 必填密钥本地 Agent Swarm 实例的 API 密钥，用于 Bearer 认证；由你部署的 Agent Swarm 实例提供，传输时必须作为必需的秘密凭据。

准备 Docker 和至少一种受支持的智能体运行环境凭据。使用 bunx 或 npx 运行 @desplega.ai/agent-swarm onboard，或按照仓库说明配置 Docker Compose。启动 MCP 服务后，通过实例地址、Bearer API 密钥和已注册智能体的 X-Agent-ID 连接。

验证是否装好

启动本地 API 后，MCP 客户端连接 http://localhost:3000/mcp 并携带 Authorization: Bearer <AGENT_SWARM_API_KEY> 与 X-Agent-ID 请求头；若连接成功且能列出 Agent Swarm 的 MCP 工具（如记忆、KV、页面相关工具），说明安装正常。

常见排障

确认 Agent Swarm 实例正在运行，并检查 MCP URL 中使用的端口；清单默认端口为 3000，快速开始示例使用 3013
确认 AGENT_SWARM_API_KEY 已设置，并将 Authorization 标头写成 Bearer 加密钥的形式
确认 X-Agent-ID 对应实例中已注册的智能体
确认 Docker 已安装并运行，且所选智能体运行环境的凭据已配置
本地连接使用 http://localhost:{port}/mcp；远程连接需要替换为自己的 swarm 主机地址
检查本地与远程配置是否使用了同一实例、端口、API 密钥和智能体 ID

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把这条 Slack 上收到的功能请求拆解成子任务并分派给合适的 worker，最后以 Pull Request 形式交付。
查看当前 swarm 里所有 agent 的状态，列出正在运行的任务和它们的进度。
每天早上 9 点跑一次代码健康检查，并把 Sentry 新告警的分析报告写到仪表盘页面。
把过去一周的任务成本和 token 用量整理成一份报告页面。

使用场景

将 Slack、GitHub、GitLab、电子邮件、Linear、Jira 或 API 中的任务交给智能体团队处理

在隔离 Docker 容器中执行软件开发任务并产出拉取请求

运行带人工审批、重试和分支汇合的工作流

通过共享记忆和定时任务支持持续性的客户支持、内容生成、报告和代码健康工作

详细介绍

Agent Swarm 是一个开源的多智能体编排 API 和 MCP 服务器，使用本地 SQLite 存储。它由主智能体拆分任务，并将任务交给运行在隔离 Docker 环境中的工作智能体，同时提供共享记忆、持久身份、工作流、定时任务和人工审批能力。