OpenAI Agents SDK 是什么?那个「一只手数得完概念」的多 Agent 框架,为什么周更还不到 1.0

OpenAI Agents SDK 是什么?那个「一只手数得完概念」的多 Agent 框架,为什么周更还不到 1.0

OpenAI Agents SDK 是什么?那个「一只手数得完概念」的多 Agent 框架,为什么一周更一回还不到 1.0

做个人 Agent 这半年,我上手过的框架一只手数不过来。多智能体这块,经常有朋友问我:AutoGen、CrewAI、MetaGPT 都试过了,还想找个轻的,有没有那种「概念少到看完就敢写」的?

有,就是 OpenAI 自己出品的 Agents SDK。

先说结论:如果你想搭一套「几个 AI 分工干活」的东西,又不想被框架本身的大概念绕晕,这个值得第一个看。它已经把「多 Agent」这件事压缩成了三四个词,剩下的交给 Python。

OpenAI Agents SDK 是什么?

它是 OpenAI 官方出的一个轻量级 Python 框架,专门用来写多 Agent 工作流。仓库叫 openai/openai-agents-python,MIT 开源,目前 GitHub 上 29K+ 星。它其实就是 OpenAI 之前那个实验项目 Swarm 的「转正版」——Swarm 当时只是个概念演示,Agents SDK 是把那套思路重写、加固、拿去上生产的正式货。

它诞生的时间是 2025 年 3 月,到现在还在 0.x 版本上滚动更新(基本是周更的节奏)。按官方定位,就是「做一个够用、但概念又少到学起来快的多 Agent 框架」——跟那些一上来就十几个类的大生态,完全是两种气质。

核心概念:一只手数得完

它的好处在于「少」。整个框架的核心概念就这几个:

1. Agent(智能体):一个 LLM + 指令 + 工具 + 护栏 + 交接权的组合体。你说「这个 Agent 负责查资料」,它就背着这几个东西去干活。

2. Handoff(交接):这是它最有特色的地方。Agent 不是孤立干活的,它可以把手头的活儿「交接」给另一个 Agent。比如负责分词题的 Agent 发现自己答不上来,直接把手柄丢给负责代码的 Agent。多 Agent 协作就是靠这个「互相甩活儿」串起来的。

3. Guardrails(护栏):相当于在 AI 真正动手前,先跑一遍检查。比如内容合规、输入校验,先拦截再放行,不让它瞎跑。

4. Sessions(会话状态):跨次数保持上下文,让 Agent 记住「上次聊到哪」。

再加上内置的 Tracing(追踪),每次 LLM 调用、工具执行、交接全都留痕,排查问题不用瞎猜。

它对外部 LLM 是开放的——不止用 GPT,OpenAI 自己的 Responses 和 Chat Completions API 能用,100+ 其他模型的 API 也能接。也就是说,你不一定非要全家桶,拿它套你自己的模型路由也可以。

上手:真就这么短

装它只需要一条命令:

pip install openai-agents

然后写一个最简单的 Agent:

from agents import Agent, Runner

agent = Agent(
    name="研究助手",
    instructions="你是一个能联网查资料的助手。",
)

result = Runner.run_sync(agent, "帮我查一下开源多 Agent 框架有哪些")
print(result.final_output)

就这几行,Agent 建好了,跑起来了。要加多 Agent 协作,就建几个 Agent 相互 handoff,没了。它的设计哲学就是「够用就好」——你不需要为了搭一个简单的多 Agent 流程去背一整套工程概念。

实话

我给它一个中肯的评价:相当能打,但也不是免费的午餐。

好的地方:概念精简,Python 上手极快;OpenAI 官方背书,基本周更,修 bug 和加功能都快;交接机制是亮点,多 Agent 协作写起来很直观;自带的追踪开了就免费,排查问题省心;还有官方原生的 JS/TS 版,前后端能对上话。

得说实话的坑:

一是它重心明显倾向 OpenAI 自家平台。默认模型是 GPT、文档推荐你用 Responses API、追踪默认流到 OpenAI 的控制台。虽然它声称支持 100+ 外部模型,但从设计到文档,处处都在往自家生态拽。你如果主打省钱用便宜模型,得自己多折腾路由和追踪的配置。

二是到现在还在 0.x。周更虽快,但意味着 API 随时可能变,你的代码可能跟着框架升级要改。想搞「写完丢那儿几个月不用管」的朋友,这点得掂量下。

三是 Agent 这个词看着轻,但 Agent 真正干得好不好,还是看你的工具、护栏和提示词。框架只是把「多 Agent」这块做轻了,真正让它干活的还是底下那个 LLM 和你喂它的东西。

适合谁

想快速把「多个 AI 分工协作」跑起来的人,尤其是 Python 选手,这个的入门成本在主流多 Agent 框架里算很低的。等它哪天出 1.0,基本就能当生产基础设施用了。

一次只讲一个,这篇先到这儿。同类里还有微软的 AutoGen、CrewAI 的角色分工、MetaGPT 的「软件公司」那套,各有各的适法人;哪天想对比,我再单独拎出来讲。

by 数码罗记 · godsun.pro

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注