托管的持久会话
OpenAI 管理会话配置、轮次和项目，因此应用可以在同一会话中继续工作、发送其他任务，或从代理上次停止的位置恢复。
Agents API
Freemium
Agents API 为应用提供由 OpenAI 管理的 Codex harness，用于构建可持久运行的云端代理；它负责会话、编排、上下文压缩与恢复，应用则提供工具并选择执行环境。
什么是 Agents API？
Agents API 是一种面向应用的 API 运行时，适用于需要代理在持久会话中执行多步骤工作的场景。它通过由 OpenAI 管理的 API 提供 Codex harness，将代理的任务执行与应用的用户界面或周边工作流分离。OpenAI 负责管理会话状态、编排、上下文压缩与恢复，而应用则配置代理、提供工具，并选择使用 OpenAI 托管的沙盒、自托管沙盒或不使用沙盒。
代理可配置模型、指令、工具和可选的 MCP 服务器。环境可以提供沙盒或计算机，让代理访问文件、加载技能并运行命令。在会话期间，应用发送输入，并接收代表进度和输出的事件与项目。应用可以流式传输输出，或使用 Webhook 了解工作何时完成、代理何时需要输入，然后在同一会话中继续执行另一项任务，或在代理当前轮次中对其进行引导。
Agents API 能做什么？
编排与上下文管理
Codex harness 负责编排、自动上下文压缩和恢复。它还可以总结先前的工作，以帮助管理代理的上下文窗口。
沙盒与环境选项
代理可以运行命令和代码、编辑文件、加载技能并访问工作区。应用可以使用 OpenAI 托管的沙盒、自托管沙盒或不使用沙盒，但需遵循所选环境的设置和限制。
工具与 MCP 连接
代理可以使用已配置的工具，并通过 MCP 服务器连接外部数据。文档所述配置还支持网页搜索和程序化工具调用。
多代理委派
托管的 Codex harness 可以将工作拆分为子任务，并将独立工作委派给子代理；创建会话时可以配置多代理行为。
进度事件与引导
应用可以流式传输代理输出，或使用 Webhook 跟踪进度、检测完成或输入请求，并在代理处于活动轮次期间对其进行引导。
使用场景
“研究与技术调查”
为代理配置网页搜索和 MCP 服务器，以调查技术问题、核查最新信息，并整合委派研究任务的结果。
“事件响应”
使用代理调查告警，并在执行恢复操作前请求批准，同时将调查过程及后续轮次保存在持久会话中。
“数据分析”
构建数据分析师工作流，使用应用配置的工具和执行环境，通过只读 SQL 回答数据仓库问题。
“文档审查”
设置审查代理，应用策略技能并调用专业代理检查文档，返回汇总后的发现。
“互联工作场所与代码工作流”
使用已连接的工具处理工作场所系统中的请求，或调查 GitHub issue：复现报告的问题，并在 GitHub 上分享调查结果。
常见问题
Agents API 为我的应用管理哪些内容？
OpenAI 管理 Codex harness，包括会话、编排、上下文压缩和恢复。您的应用负责配置代理、提供工具、选择环境、发送输入，以及接收事件和输出。
Agents API 代理可以在哪里运行？
文档所述选项包括 OpenAI 托管的沙盒、自托管沙盒或不使用沙盒。沙盒可以提供文件、技能、命令和代码执行访问；具体设置和限制取决于所选环境选项。
应用如何跟踪或继续代理的工作？
创建会话并向代理分配任务后，应用可以流式传输输出，或使用 Webhook 了解代理何时完成工作或需要输入。应用可以向同一会话发送另一项任务，或在代理当前轮次中对其进行引导。
Agents API 可以使用外部服务或其他代理吗？
可以。代理可以配置工具和 MCP 服务器以连接外部数据，托管的 Codex harness 还支持将子任务委派给子代理。应用必须配置相关工具、服务器和权限。
Agents API 与 Agents SDK 有何不同？
Agents API 运行托管的 Codex harness，并保存会话进度。Agents SDK 在应用中运行，让应用能够更充分地控制部署、存储、审批和运行时集成。
快速信息
- 产品类型
- 托管代理运行时 API
- 主要平台
- OpenAI API
- 核心运行时
- 由 OpenAI 管理的 Codex harness
- 状态模型
- 持久会话，保存配置、轮次和项目
- 环境选项
- OpenAI 托管的沙盒、自托管沙盒或不使用沙盒
- 计费依据
- 所选模型的 API 费率、OpenAI 工具的标准费率，以及 OpenAI 托管沙盒的标准容器费率
