智能体是能够进行规划、调用工具、跨专家协作，并维护足够状态以完成多步骤工作的应用程序。
- 使用 OpenAI 客户端库 适用于需要直接使用 API 客户端发起模型请求的场景。
- 使用 Apps SDK 适用于由应用程序自行处理编排、工具执行、审批和状态管理的页面。
- 使用 智能体构建器 仅当您明确需要托管工作流编辑器和 ChatKit 路径时使用。
获取 Agents SDK
访问 GitHub 仓库以获取安装指南、问题反馈、示例及特定语言的参考详情。
选择您的起点
| 如果您想要 | 从此开始 | 原因 |
|---|---|---|
| 构建代码优先的智能体应用 | 快速入门 | 这是实现可运行 SDK 集成的最短路径。 |
| 清晰地定义单一专家 | 智能体定义 | 当您仍在为单个智能体塑造契约时，请从此开始。 |
| 选择模型、默认值和传输方式 | 模型与提供方 | 当模型选择、提供商设置或传输策略会影响工作流时使用此项。 |
| 了解运行时循环和状态 | 运行智能体 | 智能体循环、流式处理和延续策略的相关内容都在这里。 |
| 在基于容器的环境中运行工作 | 沙盒智能体 | 当智能体需要文件、命令、包、快照、挂载或提供商链接时使用此项。 |
| 设计专家所有权 | 编排与交接 | 当您需要多个智能体并必须决定由谁负责回复时使用此项。 |
| 添加验证或人工审核 | 护栏与人工审查 | 当工作流需要在继续执行高风险操作之前进行阻止或暂停时使用此项。 |
| 了解运行返回的内容 | 结果与状态 | 此页面说明了最终输出、可恢复状态以及下一轮交互的展现形式。 |
| 添加托管工具、函数工具或 MCP | 使用工具 and 集成与可观测性 | 工具的语义位于平台工具文档中；特定于 SDK 的 MCP 和追踪功能则在此处。 |
| 检查和改进运行 | 集成与可观测性 and 评估智能体工作流 | 首先使用追踪进行调试，然后逐步进入评估循环。 |
| 构建语音优先的工作流 | 语音智能体 | 语音功能仍然是 SDK 优先的路径，因为 Agent Builder 暂不支持该功能。 |
使用 SDK 构建
当您的服务器负责编排、工具执行、状态管理和审批时，请使用 SDK 路径。当您有以下需求时，该路径是最佳选择：
- 使用 TypeScript 或 Python 编写的强类型应用程序代码
- 直接控制工具、MCP 服务器和运行时行为
- 自定义存储或服务器管理的对话策略
- 与现有产品逻辑或基础设施的紧密集成
典型的 SDK 阅读顺序为：
- 起始项 快速入门 以在屏幕上获得一次可运行的结果。
- 使用 智能体定义 and 模型与提供方 清晰地塑造单一专家。
- 继续前往 运行智能体, 编排与交接，且 护栏与人工审查 随着工作流变得越来越复杂。
- 使用 结果与状态 and 集成与可观测性 当应用程序逻辑依赖于运行对象或需要对行为有更深入的可见性时。
使用 Agent Builder 的托管工作流路径
当您希望使用由 OpenAI 托管的工作流创建、发布和 ChatKit 部署时，请使用 Agent Builder。这些页面被归为一类，因为它们描述的是同一个产品界面：在可视化编辑器中构建工作流、发布版本、将其嵌入、自定义 UI 以及评估结果。
语音智能体是一个例外：它们位于 SDK 路径中，因为 Agent Builder 目前暂不支持语音工作流。请使用 语音智能体 当您需要语音到语音或链式语音管线时。