OpenAI Swarm 是什么？22K 星的开源多 Agent 轻量框架，研究了它你就懂 OpenAI 的编排思路
导语
OpenAI 自己的多 Agent 编排，早期的代表作其实是个教学框架——Swarm。22K 星、MIT 开源，它不是什么”要上生产的重型框架”，官方原话就是”探索型、教育型“，专门用来演示 OpenAI 看重的两招：Routines（例行流程） 和 Handoffs（交接）。很多人一上来指望用它跑业务，结果发现它连记忆、状态都不管，直接劝退。但如果你是想搞懂”OpenAI 理解的多 Agent 协作长啥样”，Swarm 恰恰是最干净的教材。这篇基础篇，从它的核心思想讲起。
项目介绍：Swarm 到底是个啥？
Swarm 是 OpenAI 开源的、轻量级的多 Agent 编排框架，由 OpenAI Solution 团队维护。一句话定位：它不是产品，是”教科书”——把多智能体协作里最核心的两个概念用最少的代码讲给你听。
核心就两个词：
- Routines（例行流程 / Agent）：一个 Agent 就是”一组指令 + 一组函数（工具）”。注意，Swarm 里的 Agent 不带记忆、不带状态，它更像一张”规定了能调哪些工具、系统提示词是什么”的配置单。这跟很多人印象里”Agent = 有记忆的 AI”完全不一样——这是刻意的简化。
- Handoffs（交接）：Agent 干着干着，发现自己不适合继续，就直接把”话语权”交接给另一个 Agent。比如客服机器人发现用户要退款，就把单子”交给”退款 Agent。这种”谁擅长谁接手”的协作方式，是 Swarm 最核心的卖点。
上手极简主义到什么程度？几行代码就能定义两个 Agent 并实现交接，不需要装一堆依赖、不用配复杂的工作流引擎。OpenAI 官方笔记里甚至说：”Swarm 是我见过的最小的「多 Agent」实现了——它把 Handoff 的思路演得明明白白。”
对比一下就很清晰：LangGraph 搞的是”图编排”，CrewAI 搞的是”角色组队”，而 Swarm 只讲一件事——Agent 之间怎么优雅地把活传下去。
上手：十分钟跑通”交接”
Swarm 的 Python 版装包 pip install openai-swarm（注意 API 走的是 OpenAI 自己的 chat 补丁，接本地/开源模型要自己改，这点前面提醒过——它是教学件，默认绑 OpenAI 服务）。核心就三步：
- 定义工具函数：普通 Python 函数，比如
refund_item()、escalate_to_agent()。 - 定义 Agent：给每个 Agent 配
instructions（系统提示）和functions（能调的工具）。 - 跑交接：实例化
Swarm()客户端，run()时传起始 Agent 和用户话。Agent 一旦在函数里返回”把活交给某某”，交界就发生了。
官方 README 里有客服 + 退款 + 升级的经典三 Agent 示例，十几分钟就能跑通”用户要退款 → 客服 Agent 交给退款 Agent”的完整链路。想省钱在本地玩，得把客户端底层从 OpenAI 换成本地兼容端点——教学框架这块没给你省事，自己动手。
实话：好的、坏的，都聊聊
先夸。
- 概念讲得最干净：Routine + Handoff 这两个词，把多 Agent 协作的核心讲透了，比很多框架的文档都好懂。
- 代码量极小：没有重量级抽象，读源码跟读讲稿似的，特别适合刚接触多 Agent 的人建立心智模型。
- 交接（handoff）这个设计有含金量：这套”谁擅长谁接手”的思路，后来直接影响了 OpenAI 自家的生产级方案（Agents SDK 就把交接、工具选择这些继承并做得更工程化）。
再说坑。
- 官方明说：别拿它上生产。无记忆、无状态、无持久化、无内置验证，跑真实业务撑不住。
- 几乎没做工程化：没有监控、日志、安全、多租户这些，生产要的东西一个都不占。
- 默认绑生态：Python 端接的是 OpenAI 的 chat 接口，想接本地开源模型要自己折腾一层，教学件不愿意帮你省这个心。
- 和”生产版”要分清：OpenAI 后来推的 Agents SDK 才是能落地的正主，搜资料时别把 Swarm 和它混为一谈。Swarm 的价值是”学了明白思路”，不是”直接部署”。
怎么选：一张参考表
| 你的目标 | 选它 |
|---|---|
| 搞懂多 Agent 协作的核心思想、当教材 | OpenAI Swarm |
| 要 OpenAI 系、能上生产的多 Agent | OpenAI Agents SDK |
| 要数据私有、本地省钱 + 平台管理 | Agno（原 Phidata） |
| 企业多语言栈、要治理和可观测 | Microsoft Agent Framework |
结语
OpenAI Swarm 是个被很多人误用的”教学框架”——拿它当产品用会撞墙，但当教材用，它把”Agent 交接”这件事讲得比谁都清楚。理解 Routines 和 Handoffs，你就抓住了 OpenAI 对多 Agent 协作的底层判断，这套判断你会在新一代框架里反复看到。
数码罗记 · godsun.pro | 更多 Agent 平台横评与上手实测，来 ai.godsun.pro 一起折腾。
