OpenAI Agents SDK

OpenAI Agents SDK 是 OpenAI 官方的 Python / TypeScript 生产级智能体运行时，也是 Swarm 实验的加固继任者。2026-08-17 复核 Python 文档：核心原语仍是 Agents、交接（含 agents-as-tools）、护栏、会话和追踪。更新的官方页补上了沙箱智能体、基于 gpt-realtime-2.1 的实时智能体、语音智能体、MCP 服务端工具，以及人在回路。

安装：pip install openai-agents 或 npm install openai-agents。入门是 from agents import Agent, Runner，然后 Runner.run_sync(...)。

核心功能

• Agents：LLM 加上指令、工具和设置。
• Handoffs / agents-as-tools：把活交给专家，或把另一个智能体当工具调用。
• Guardrails：与智能体循环并行的输入输出检查。
• Sessions + tracing：会话持久化，并观察运行。LangSmith、Langfuse、AgentOps 仍可接入。
• 沙箱、实时、语音、MCP、HITL：在 Swarm 时期的表面上，现行文档已覆盖这些。

适用场景

• 以 OpenAI 为主、想用官方薄运行时的生产智能体。
• 用交接而不是自研路由器拼起来的专家系统。
• 现在已有官方类型的语音或实时循环。

限制：这不是图运行时。若要持久 checkpoint 和手画状态机，用 LangGraph。

定价

快速开始

1. 读 Python 文档。
2. pip install openai-agents。
3. 创建 Agent，再 Runner.run_sync(agent, "Hello")。
4. 上线前先加护栏和会话。

常见问题

这就是 Swarm 吗？

这是 Swarm 的生产继任者，不是那个教学实验。

只有 Python？

不是。TypeScript 仍在（npm install openai-agents）。

能用非 OpenAI 模型吗？

能，只要提供商兼容 OpenAI API。

替代方案

• LangGraph：把持久图和人在回路当一等运行时。
• CrewAI：按角色组多智能体团队。
• Google ADK：Google 的智能体框架。

使用技巧

1. 智能体保持小，用交接。不要养一个全能智能体。
2. 第一次生产事故前打开追踪。
3. 再看实时和沙箱页。这些面比第一版文案后移了。

总结

Agents SDK 仍是官方、薄的 OpenAI 智能体运行时：智能体、交接、护栏、会话、追踪，现在加上沙箱、实时、语音、MCP 和 HITL。从 文档 开始；需要图再对比 LangGraph。