OpenAI Agents SDK

OpenAI Agents SDK 是一个用 Python 写智能体应用的开发包，装好后用 pip install openai-agents 引入。它把做智能体需要的东西收成几个原语：带指令和工具的 Agent、让智能体之间互相转交任务的 Handoff、在输入输出上做校验的 Guardrail，再加上一个跑到任务完成才停的内置循环。官方说它是此前实验项目 Swarm 的生产可用版本。

主要功能

写一个智能体就是给 Agent 起名、写指令、挂工具，然后用 Runner 跑起来。任何 Python 函数都能变成工具，参数结构自动生成，校验交给 Pydantic。多个智能体之间可以互相调用或转交，适合把一件事拆给几个专精角色。Guardrail 和智能体执行并行跑，检查不过就立刻中断。

SDK 还带追踪功能，能把一次运行的调用链可视化，用来调试和评估，也能接 OpenAI 的微调、蒸馏工具。此外有会话层保存上下文、人在回路机制、MCP 服务器工具调用，以及沙箱智能体、实时语音智能体和语音管线这几块较新的能力。

和 Responses API 的关系

对 OpenAI 模型，SDK 默认走 Responses API，但在外面包了一层运行时。如果只想自己掌控循环、工具分发和状态，或者流程很短只是拿模型回复，直接调 Responses API 更合适；需要运行时管轮次、工具执行、转交和会话，或者要跨多步产出结果，就用 SDK。两者不必二选一，同一个应用里可以混用。

适合谁

会写 Python、想把智能体流程做成可运行程序的后端和 AI 应用开发者。文档有英文、日文、韩文和简体中文版本，中文读者可以直接看中文页。