OpenAI Agents SDK

OpenAI Agents SDK 是 OpenAI 官方的 AI 智能体构建框架，提供 Python 与 TypeScript 版本。它于 2025 年 3 月发布，是开源 Swarm 实验的正式继任者，提供最小但面向生产的原语集合：带指令与工具的智能体、用于模块化的交接、用于安全的护栏、用于持久化的会话，以及内置的追踪可观测性。

核心功能

• Agents（智能体）：核心原语——带指令、工具与设置的 LLM。
• Handoffs（交接）：智能体间转移工作，构建模块化、可组合系统；子智能体把工作交给专家。
• Guardrails（护栏）：与智能体循环并行运行的输入与输出校验。
• Sessions（会话）：带自动上下文管理的对话持久化。
• 内置追踪：通过 OpenAI 追踪基础设施实现可观测性，支持 LangSmith、Langfuse、AgentOps 集成。
• Responses API 原生：构建在 OpenAI Responses API 之上；适配 OpenAI 模型与任意兼容 Provider。
• 最小抽象：生产级可靠性，无重型框架层。
• TypeScript + Python：两种语言均有完整实现。

适用场景

谁应该使用这个工具？

• 生产智能体团队：交付可靠、可观测、易维护智能体的团队。
• OpenAI 用户：已在 OpenAI 模型上开发、想要官方框架的开发者。
• 模块化系统构建者：通过交接组合专业智能体的团队。

解决的问题

1. 框架锁定：在 Responses API 之上的薄官方层，最小抽象。
2. 安全：护栏并行校验输入与输出。
3. 可观测性：内置追踪，无需单独配置基础监控。

定价方案

优势对比

相比竞品的优势：

1. 官方且最小：OpenAI 维护，小而面向生产的表面。
2. 交接是一等原语：无需定制管道即可构建模块化智能体系统。
3. 原生 Responses API：OpenAI 最新特性立即可用。

独特卖点：

• Swarm 的继任者，经过生产级加固。
• 与智能体循环并行的护栏。
• 集成 E2B、Modal（GPU）、LangSmith、Langfuse。

快速开始

入门指南

1. 安装：pip install openai-agents（Python）或 npm install openai-agents（TS）。
2. 创建智能体：agent = Agent(name="Assistant", instructions="You are helpful")。
3. 添加工具与护栏：为智能体挂载函数与校验。
4. 运行：result = await Runner.run(agent, "Hello")。

集成

无缝集成以下工具：

• E2B 与 Modal（代码执行与 GPU 沙箱）
• LangSmith、Langfuse、AgentOps（追踪）
• 任意 OpenAI 兼容 Provider

常见问题

和 Swarm 一样吗？

它是生产级继任者——Swarm 是教学实验，Agents SDK 面向生产加固。

能用非 OpenAI 模型吗？

能——适配任意 OpenAI 兼容 Provider。

真的很小吗？

是的——设计哲学是用小型原语集合换取生产可靠性，而非重型框架。

替代方案

如果 OpenAI Agents SDK 不合适，可以考虑：

• LangGraph：带持久执行的底层有状态编排。
• CrewAI：角色化多智能体团队。
• Google ADK：带 A2A 互操作的 Google 框架。

使用技巧

1. 用交接做专业化：保持智能体小而专注，把工作交给专家。
2. 始终加护栏：校验输入输出，尽早发现问题。
3. 接上追踪：生产环境接入 LangSmith 或 Langfuse 获得完整可观测性。

总结

OpenAI Agents SDK 是官方、面向生产的智能体构建方式——Python 与 TypeScript 中的最小原语、交接、护栏、会话与追踪。如果你在 OpenAI 模型上构建智能体，想要一个薄而可靠的框架，这是自然之选。