OpenAI Agents SDK

是什么

OpenAI Agents SDK 是一套开源开发工具包，用来构建这样的应用：语言模型不只是回答一个问题，它还会调用工具，把任务交给别的智能体。OpenAI 在 2025 年 3 月发布这套 SDK，同一次公告里还推出了 Responses API，以及网页搜索、文件搜索和计算机操作（computer use）等内置工具^[1]。代码放在 GitHub 的 openai/openai-agents-python 仓库，仓库创建于 2025 年 3 月 11 日，采用 MIT 许可证，约有 3 万颗星^[2]。

它要解决的是很实际的问题：一旦任务需要多步操作、需要调用外部工具、甚至需要几个各有所长的智能体轮流处理，应用里的调度逻辑就会迅速变复杂，而这类逻辑往往每个项目都要从头写一遍。

由来

这套 SDK 是 Swarm 的继任者。Swarm 是 OpenAI 前一年发布的实验性 SDK，被开发者广泛采用。OpenAI 称 Agents SDK 相对 Swarm 有显著改进，并把它的主要用途说成是简化多智能体工作流（multi-agent workflow）的编排——也就是决定哪个智能体在什么时候行动、它能做什么的那套管线^[1]。

四个组成部分

OpenAI 列出了四项改进，它们构成了这套 SDK 的设计骨架^[1]。

智能体（Agents）：带有指令和内置工具的语言模型，配置起来很方便。它是读取任务、决定下一步做什么的基本单位。

任务交接（Handoffs）：在智能体之间智能地转移控制权，于是一个请求可以由一个智能体开始，由另一个更合适的智能体结束。

护栏（Guardrails）：可配置的安全检查，用来校验输入和输出，让开发者给智能体可以接受什么、可以返回什么划出边界。

追踪与可观测性（Tracing & Observability）：留下一次运行过程的记录，多步骤、多智能体的流程事后可以被查看，而不是当成黑箱。

兼容哪些模型

这套 SDK 可以配合 Responses API 和 Chat Completions API 使用；其他厂商的模型只要能提供 Chat Completions 风格的 API 端点，也可以用它^[1]。发布时 SDK 以 Python 为先，Node.js 支持宣布即将推出^[1]。

早期使用者

OpenAI 在发布时举了两家公司的例子。Coinbase 用这套 SDK 在几个小时内完成 AgentKit 的原型并部署上线；Box 在几天内做出了带网页搜索的智能体^[1]。

在发展中的位置

这套 SDK 是同一次公告中一整套智能体构建工具的一部分，与 Responses API、内置工具一同推出^[1]；它开源、许可证宽松，仓库星数在数万量级^[2]。它标准化的东西是模型外面那层脚手架：智能体怎么定义，任务怎么在智能体之间路由，进出两头怎么检查，一次运行又怎么留下记录。对开发者来说，这类重复的调度代码被收进一个可复用的库里，不必每个项目自己搭一遍。