openai/swarm

这是什么？

核心功能

• 01Agent 对象将指令与模型可调用的 Python 函数组合在一起。
• 02任务移交可让一个智能体把对话转给另一个智能体。
• 03上下文变量可传入函数和动态生成的指令。
• 04基于 Chat Completions API 构建，不在服务端保存状态。
• 05支持流式输出和命令行演示循环。

适用场景

• 学习多智能体任务移交和工具调用的实际工作方式。
• 原型验证将请求分发给专门智能体的分诊流程。
• 搭建客服演示，为不同任务配置独立的智能体。

快速上手

1. 1

   使用 pip 从 GitHub 安装 Swarm（需要 Python 3.10+）

   pip install git+https://github.com/openai/swarm.git
2. 2

   创建 Swarm 客户端、定义智能体和函数，然后按照 README 用法示例调用 client.run()

使用前须知

• !Swarm 是实验性的教学项目，不适合直接用于生产环境。
• !README 称 Swarm 已被 OpenAI Agents SDK 取代，生产场景建议迁移到该 SDK。
• !Swarm 基于 Chat Completions API 构建，调用之间不保存状态，需要自行管理对话历史。

收录于专题

标签

常见问题

swarm 是什么？

基于 Chat Completions API 的实验性教学框架，用 Agent 与任务移交实现轻量多智能体编排。 Swarm 是一个用于协调多个大模型智能体的 Python 框架。它的两个核心概念是 Agent（封装指令与可调用函数）和任务移交（handoff，让一个智能体把对话转交给另一个）。client.run() 会循环执行模型补全、工具调用和智能体切换，直到不再有新的函数调用，然后返回更新后的消息、当前智能体和上下文变量。

swarm 可以免费使用吗？用的什么许可证？

swarm 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

swarm 还在维护吗？

超过半年未提交。swarm 最近一次提交是在 2026年4月15日。

swarm 适合用来做什么？

学习多智能体任务移交和工具调用的实际工作方式。 原型验证将请求分发给专门智能体的分诊流程。 搭建客服演示，为不同任务配置独立的智能体。

swarm 怎么安装和运行？

使用 pip 从 GitHub 安装 Swarm（需要 Python 3.10+）: pip install git+https://github.com/openai/swarm.git 创建 Swarm 客户端、定义智能体和函数，然后按照 README 用法示例调用 client.run()

在哪里获取 swarm？

源代码和安装说明在 GitHub 上：https://github.com/openai/swarm