开发与工程 python-sdkmulti-agent-orchestrationsequential-workflowsconcurrent-workflowsworkflow-dagmcp-integrationx402-payments

Swarms 多智能体编排框架

面向 Python 的多智能体编排库,用顺序、并发和图工作流组织模型驱动任务。

FollowAgents 评估 · FARS-2.1
不推荐
0/ 100 五分制 0.0 / 5
1 2 3 4 5 6
按维度查看评分与理由
1信任安全0 / 29 · 0.0/5

证据显示:仓库包含SECURITY.md,声称使用环境变量、无遥测、加密等安全特性,但这些都是声明,没有代码或配置支持。没有发现最小权限原则、用户确认机制、数据流透明性、敏感数据处理、依赖安全、外部影响控制、回滚机制或来源归属的具体实现。因此所有标准得分为0。

2可靠稳定0 / 14 · 0.0/5

证据显示:README和pyproject.toml提供了版本信息,但未发现自一致性检查、依赖可用性保障或失败消息处理的证据。因此所有标准得分为0。

3适用触发0 / 18 · 0.0/5

证据显示:README描述了多种多智能体架构和场景,但未明确目标受众、能力边界、触发精度或环境适配。因此所有标准得分为0。

4规范维护0 / 18 · 0.0/5

证据显示:README提供了安装说明和示例,但未发现信息架构、命名稳定性、FAQ、已知限制、版本变更日志或维护责任的明确证据。许可证为Apache-2.0,但未提供版权归属。因此所有标准得分为0。

5有效结果0 / 13 · 0.0/5

证据显示:README声称提供生产级框架,但未提供输出可用性、边际价值或成本效益的具体证据。因此所有标准得分为0。

6证据核验0 / 8 · 0.0/5

证据显示:README中的声明缺乏可追溯性,没有交叉来源验证,也没有区分事实与推断。因此所有标准得分为0。

证据充分度: 评估于 2026年8月9日 审查版本 f894187d7da4
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
源码中未见的安全控制:最小权限约束、执行前用户确认、数据流向说明、敏感信息处理、依赖安全审查、外部影响披露、回滚或恢复路径、来源归属可核验
使用前请注意
  • 仓库中的安全声明(如SECURITY.md)缺乏代码或配置支持,不应视为实际安全保证。
  • README中的示例代码可能无法直接运行,因为依赖外部API密钥和未验证的模型名称(如gpt-5.4)。
  • 发布者身份未经验证,不应基于品牌信任其可靠性或安全性。
查看完整评分方法 →

这个 Agent 能做什么,适合哪些场景?

Swarms 是一个可通过 pip、uv、Poetry 或源码安装的 Python 多智能体编排库。其核心 Agent 以 LLM、工具和记忆为基础,通过 Agent.run 执行任务;示例使用模型名、系统提示词和循环次数配置行为。库提供 SequentialWorkflow、ConcurrentWorkflow、GraphWorkflow、AgentRearrange、MixtureOfAgents、GroupChat、HierarchicalSwarm、HeavySwarm 与 SwarmRouter 等编排接口。GraphWorkflow 将 Agent 表示为 DAG 节点,按依赖顺序执行并让独立分支并行;SwarmRouter 则以统一入口选择工作流类型。运行结果由各工作流或 Agent 的 run 调用返回,AOP 示例还展示了将已注册 Agent 作为运行在指定端口上的服务。

开发者先创建 Agent,并设置 agent_name、system_prompt、model_name、max_loops 等参数;随后调用 agent.run(task) 处理文本任务。多个 Agent 可交给 SequentialWorkflow 串行传递输出,交给 ConcurrentWorkflow 同时处理同一任务,或作为 GraphWorkflow 的 Node 通过 Edge 声明依赖。AgentRearrange 使用如 researcher -> writer, editor 的 flow 字符串描述关系,MixtureOfAgents 并行运行专家 Agent 后由 aggregator_agent 汇总。设置 mcp_url 或 mcp_urls 后,Agent 可连接 MCP 服务器并自动获得其工具;AutoSwarmBuilder 可依据任务生成 Agent 与工作流配置,AOP 可通过 add_agent 注册 Agent 后以 run 启动服务。

  1. 需要将研究、写作、审校依次衔接的内容团队,可用 SequentialWorkflow 让前一位 Agent 的输出成为下一位的输入。
  2. 需要同时完成市场、财务和风险分析的分析团队,可用 ConcurrentWorkflow 并行运行多个专长不同的 Agent。
  3. 需要处理扇出、汇合或钻石形依赖的软件项目,可用 GraphWorkflow 将 Agent 和依赖关系建模为 DAG。
  4. 需要在多种协作策略之间切换的 Python 应用,可通过 SwarmRouter 以同一接口选择 SequentialWorkflow、ConcurrentWorkflow 或 MixtureOfAgents。
  5. 需要让 Agent 调用外部工具或数据服务的开发者,可为 Agent 配置 MCP 服务器 URL。
  6. 需要将研究和分析 Agent 注册为网络服务的团队,可参考 AOP 的 server_name、port、add_agent 与 run 流程。

这个 Agent 有哪些优点和局限?

优点
  • 提供顺序、并发、DAG、层级、群聊、专家汇总和动态路由等多种明确命名的编排接口。
  • GraphWorkflow 明确以 Node 和 Edge 表达 DAG 依赖,并说明独立分支可自动并行执行。
  • Agent 可通过 mcp_url 或 mcp_urls 对接一个或多个 MCP 服务器,并自动获得相应工具。
  • SwarmRouter 用 swarm_type 提供统一调用面,方便在同一组 Agent 上替换协作策略。
局限
  • 所给可执行示例均依赖命名模型或 HTTP MCP 服务;资料未说明凭证管理、调用成本或配额控制策略。
  • 材料未给出 Python 版本要求;Docker 部署段落被注释,未提供启用中的容器部署流程。
  • max_loops="auto" 依赖 Agent 自行判断完成条件;通用工作流的失败恢复、重试和超时策略没有在所给材料中说明。
  • 功能表声称兼容 LangChain、AutoGen 和 CrewAI,但未给出迁移步骤、兼容范围或版本矩阵。

如何安装或部署这个 Agent?

安装:

uv pip install swarms

也可使用:

pip3 install -U swarms
poetry add swarms

源码安装:

git clone https://github.com/kyegomez/swarms.git
cd swarms
pip install -r requirements.txt

README 列出的环境变量包括 OPENAI_API_KEY、ANTHROPIC_API_KEY、GROQ_API_KEY 和 WORKSPACE_DIR。

如何使用这个 Agent?

最小调用:

from swarms import Agent
agent = Agent(

model_name="gpt-5.4",
max_loops="auto",
interactive=True,
temperature=None,
)

result = agent.run("What are the key benefits of using a multi-agent system?")
print(result)

若要串行协作,创建多个 Agent 后传入 SequentialWorkflow(agents=[...]),再调用 workflow.run(task)。使用 MCP 时,在 Agent 中设置 mcp_url="https://mcp.deepwiki.com/mcp" 或 mcp_urls。

这个 Agent 与同类方案有什么区别?

材料仅说明与 LangChain、AutoGen 和 CrewAI 向后兼容;未提供可用于逐项比较的 API 覆盖、性能数据或迁移细节。

常见问题

需要哪些密钥?
环境配置列出 OPENAI_API_KEY、ANTHROPIC_API_KEY 和 GROQ_API_KEY。具体示例使用 gpt-5.4、claude-sonnet-5 等模型名,但所给材料没有说明每个模型名对应的完整凭证规则。
它是托管服务还是本地库?
安装方式和示例表明它可作为 Python 库在应用中调用。AOP 示例还展示了以指定端口运行 Agent 服务;材料没有定义托管部署方案。
如何接入外部工具和数据?
为 Agent 设置 mcp_url 或 mcp_urls 即可连接 MCP 服务器,README 表述为服务器会自动向 Agent 提供所需工具。具体服务的认证、权限和数据处理规则未在材料中给出。
循环何时停止?
max_loops 可设固定次数,也可设为 "auto" 让 Agent 自行决定任务完成。GroupChat 还可由 max_loops 消息上限或 idle_timeout 的空闲超时停止。

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents