OpenAI Agents SDK
★ 27.6k · GitHub →OpenAI 刻意做小的 Agent 框架:Agent、工具、handoff、guardrail——仅此而已。
安装
$ pip install openai-agents OpenAI Agents SDK 是什么?
OpenAI Agents SDK(实验项目 Swarm 的正式继任者)押注的判断是:Agent 框架都做得太大了。它的全部表面积就几个原语:Agent 是模型加指令、工具和 guardrail;handoff 把会话移交给另一个 Agent;Runner 驱动循环;Session 管理历史。多 Agent 编排就是 Agent 之间互相 handoff 或互为工具——没有图编译器,没有角色隐喻,没有 YAML。
虽然挂着 OpenAI 的名字,它是供应商无关的:除了 OpenAI 的 Responses 和 Chat Completions API,还通过 LiteLLM 式适配器支持 100 多个模型。它的成长克制而不蔓延——内置可视化追踪、human-in-the-loop 审批、实时语音 Agent,以及在真实文件系统上做长周期编码工作的沙箱 Agent。MIT 协议,另有对等的 JS/TS 版 SDK。
它的局限是小巧的另一面:没有可与 LangGraph checkpointer 相提并论的持久执行方案——长时状态要自己管;其他供应商虽然能用,但追踪、托管工具、实时语音这些精致体验显然在 OpenAI 平台内最完整。它像一把锋利的小刀:切它擅长的东西极好,但不是工具箱。
核心能力
- ▸ 极简原语:Agent、工具、handoff、guardrail、session——一个下午就能学完
- ▸ 内置追踪与可视化 UI,方便调试和优化 Agent 运行
- ▸ 供应商无关:OpenAI API 之外,经适配器支持 100 多个模型
- ▸ 沙箱 Agent 可在真实文件系统上做长周期工作,另有实时语音 Agent
- ▸ Human-in-the-loop 审批钩子与输入/输出 guardrail 都是一等概念
什么时候该用它
想用最短路径从想法到能跑的 Agent 时选 OpenAI Agents SDK——尤其当你本来就用 OpenAI 模型,想要追踪、guardrail 和 handoff,又不想学一整套框架世界观的时候。它的 handoff 模式是搭建小型 Agent 团队最干净的方式。但需要带检查点的持久长时工作流(LangGraph)、深度 AWS/Bedrock 集成(Strands),或者尽管有多供应商支持、你仍不放心把架构押在 OpenAI 路线图上时,就该看看别家。
替代方案
常见问题
OpenAI Agents SDK 只能用 OpenAI 的模型吗?
不是。它在设计上就是供应商无关的:除了 OpenAI 的 Responses 和 Chat Completions API,还通过适配器支持 100 多个其他模型。不过托管工具、追踪面板、实时语音这些功能在 OpenAI 自家平台上体验最完整,多供应商支持是"能用",不是"同等好用"。
OpenAI Agents SDK 里的 handoff 是什么?
Handoff 是把会话控制权从一个 Agent 移交给另一个——比如分诊 Agent 转给账单 Agent。接手的 Agent 获得会话上下文并继续执行。再配合"Agent 即工具"(像调函数一样调用另一个 Agent),这就是该 SDK 实现多 Agent 编排的全部方式,不需要任何图或工作流引擎。
OpenAI Swarm 后来怎么样了?
Swarm 是 OpenAI 的教学性实验框架。Agents SDK 是它的生产级继任者:保留了 Swarm 轻量的 Agent 加 handoff 哲学,补上了缺失的生产件——追踪、guardrail、session、human-in-the-loop 和广泛的模型支持。OpenAI 建议所有正式项目使用 Agents SDK,Swarm 实际上已经退役。
星标数据更新于 2026-07-02 · 每周从 GitHub API 自动刷新 · 浏览全部工具 →