# Agents API Agents API 为应用提供由 OpenAI 管理的 Codex harness，用于构建可持久运行的云端代理；它负责会话、编排、上下文压缩与恢复，应用则提供工具并选择执行环境。 - Findings24: - 网站: - 价格: Freemium - 分类: AI 智能体基础设施 ## 什么是 Agents API？ Agents API 是一种面向应用的 API 运行时，适用于需要代理在持久会话中执行多步骤工作的场景。它通过由 OpenAI 管理的 API 提供 Codex harness，将代理的任务执行与应用的用户界面或周边工作流分离。OpenAI 负责管理会话状态、编排、上下文压缩与恢复，而应用则配置代理、提供工具，并选择使用 OpenAI 托管的沙盒、自托管沙盒或不使用沙盒。 代理可配置模型、指令、工具和可选的 MCP 服务器。环境可以提供沙盒或计算机，让代理访问文件、加载技能并运行命令。在会话期间，应用发送输入，并接收代表进度和输出的事件与项目。应用可以流式传输输出，或使用 Webhook 了解工作何时完成、代理何时需要输入，然后在同一会话中继续执行另一项任务，或在代理当前轮次中对其进行引导。 ## Agents API 能做什么？ ### 托管的持久会话 OpenAI 管理会话配置、轮次和项目，因此应用可以在同一会话中继续工作、发送其他任务，或从代理上次停止的位置恢复。 ### 编排与上下文管理 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 托管沙盒的标准容器费率