托管的持久会话
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 托管沙盒的标准容器费率
Agents API 替代品
Claude Platform
platform.claude.com
Claude Platform gives developers programmatic access to Claude models and managed agent infrastructure for building agents and applications. It includes a REST API, official client SDKs, a web Console, and documentation for direct integrations.
Statewave
www.statewave.ai
Statewave 是面向 AI 智能体的开源、自托管记忆运行时：持久化存储事件，编译带来源信息的结构化记忆，并为需要跨会话连续性的应用返回排序后的上下文集合。
deadeye
deepaksinghcs14.github.io
面向 Claude Code 的编码代理插件：按任务选择合适的模型与工作强度，并在输出进入上下文前精简冗余命令内容；实验性支持 Codex CLI、Gemini CLI、Cursor 和 Windsurf。
Kody
kody.codes
Kody 是一个为互联 AI 代理提供共享记忆、凭据、可复用软件包、服务集成和定时执行能力的软件平台，帮助开发者在 Cursor、Claude、ChatGPT 与 Codex 等代理之间复用工作，无需每次重新构建相同的自动化流程。
AgentOps
www.agentops.ai
AgentOps is a developer platform for building, tracing, debugging, and deploying AI agents and LLM applications. It provides observability for agents built with OpenAI, CrewAI, AutoGen, and more than 400 LLMs and frameworks.
Cognee
www.cognee.ai
Cognee 是一个面向 AI 智能体和应用的开源记忆平台，连接多源数据并构建可查询的向量、图谱与关系型记忆。