OpenAI Agents SDK

What it is

OpenAI 把 Agents SDK 定位为“build agents in code”的路径，适合应用自己掌控 orchestration、tool execution、approvals 与 state。

Key surfaces in docs

文档给出的阅读路径很清楚：

• Quickstart：先把一个 working run 跑起来
• Agent definitions：先定义单个 specialist 的职责边界
• Models and providers：决定模型和传输策略
• Running agents / Orchestration / Guardrails：逐步进入更复杂 workflow
• Results and state / Integrations and observability：把 runtime 接回业务代码

另外，文档特别强调了 sandbox agents：当 agent 需要文件、命令、端口、包、快照与内存时，可以使用容器化环境。

Positioning

它不是托管式工作流编辑器，而是代码优先的 runtime 框架。OpenAI 还明确把 Agent Builder 归到 hosted workflow path，而把 Voice agents 留在 SDK 路径里。

Relationships

• openai 通过它暴露多 agent、handoff、guardrails 等能力
• responses-api 提供更底层的统一调用接口
• 在横向比较里，它最像一层显式 runtime SDK，而不是单独的 tool primitive 集合