如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

Agents SDK

使用 OpenAI Agents SDK 编写智能体,并根据需要采用更高级的运行时模式。

智能体可以使用工具规划并完成任务,与其他智能体协作,并在多个步骤之间保留上下文。

运行您的第一个智能体

按照 Agents SDK 快速入门安装 SDK,定义并运行一个智能体。成功运行后,回到本页,选择应用接下来需要的功能。

获取 Agents SDK

访问 GitHub 代码仓库,查看更多示例、议题以及各编程语言的详细参考资料。

选择从哪里开始

您的目标 建议先读 原因
以代码优先的方式构建智能体应用 快速入门 这是集成 SDK 并成功运行智能体的最快途径。
明确定义一个专用智能体 定义智能体 如果您还在确定单个智能体的接口和职责,可以从这里开始。
选择模型、默认设置和传输方式 模型和提供商 当模型选择、提供商配置或传输策略会影响工作流时,请参阅此页。
了解运行时循环和状态 运行智能体 此页介绍智能体循环、流式传输以及如何继续运行。
在容器环境中执行任务 沙盒智能体 如果智能体需要使用文件、命令、软件包、快照或挂载,或需要连接到提供商,请参阅此页。
划分专用智能体的职责 编排与交接 如果您需要多个智能体,并且必须决定由哪个智能体负责回复,请参阅此页。
添加验证或人工审核 防护措施与人工审核 如果工作流需要阻止或暂停有风险的操作,以免其继续执行,请参阅此页。
了解一次运行会返回什么 结果与状态 此页介绍最终输出、可恢复的状态以及下一轮交互可用的接口。
添加托管工具、函数工具或 MCP 使用工具和集成与可观测性 平台工具文档说明各类工具的行为,SDK 集成文档介绍 SDK 中的 MCP 集成和追踪功能。
检查并改进运行过程 集成与可观测性和评估智能体工作流 先使用追踪记录进行调试,再通过反复评估改进工作流。
构建以语音为主的工作流 语音智能体 使用 SDK 的语音管道和实时智能体模式。

使用 SDK 构建应用

如果您的服务器负责部署、实现工具、存储状态和做出审批决定,而 SDK 负责运行智能体循环并调用这些工具,请选择 SDK 方案。如果您有以下需求,这种方案最为合适:

  • 使用 TypeScript 或 Python 编写带有类型声明的应用代码
  • 直接控制工具、MCP 服务器和运行时行为
  • 使用自定义存储方案,或由服务器管理对话策略
  • 与现有产品逻辑或基础设施紧密集成

通常可以按以下顺序阅读 SDK 文档:

比较智能体运行时方案

参阅智能体概览,比较 Agents SDK、Agents API 和 Responses API。Agents SDK 在您的应用中运行,Agents API 则在 OpenAI 服务中运行托管的执行框架。