NEXTAI
去下单
NEXTAI

NEXT AI EDITORIAL

OpenAI Agents API 上线：Codex 托管智能体怎么接？定价、沙箱与迁移指南

NEXT AI 编辑团队更新于 约 9 分钟

OpenAI Agents API 已开放公测，托管 Codex harness、长会话、工具、子智能体与沙箱。本文给出选型、接入、安全和成本检查清单。

OpenAI Agents API 上线：Codex 托管智能体怎么接？定价、沙箱与迁移指南封面
文章目录

OpenAI 已在 2026 年 9 月 10 日把 Codex 背后的长任务执行框架开放为 Agents API 公测。它不是“再包一层聊天接口”，而是托管会话、上下文压缩、工具调用、子智能体与沙箱；公测期不另收平台费，但模型 token、工具和执行环境仍会计费。

要点速览

  • Agents API 当前是 public beta，面向所有开发者开放，核心是由 OpenAI 托管 Codex harness。
  • 一次请求可声明模型、MCP/函数/内置工具、执行环境和多智能体并发；任务可跨多个上下文窗口持续运行。
  • 环境可选 OpenAI 托管沙箱、自有基础设施或合作方沙箱；“托管智能体”不等于必须把所有文件放进 OpenAI 沙箱。
  • API 本身公测期无附加费，实际成本来自模型 token、工具与沙箱资源，不能理解成免费运行。
  • 上线前应先做最小权限、网络出口白名单、密钥隔离、审批点和可恢复性测试。

Agents API 到底解决什么问题

传统智能体应用除了模型调用，还要自己维护循环、工具路由、上下文裁剪、失败重试、长任务状态、并发协作和执行环境。OpenAI 的官方发布说明把这些能力组合成托管会话：开发者给出任务、模型、工具和环境，平台负责维持智能体运行。

官方列出的关键能力包括自动压缩早期上下文、按需加载工具定义、程序化并行工具调用、子智能体独立上下文，以及把产物保存在沙箱中。第三方分析也把它概括为“把 Codex harness 变成托管服务”，但这只是架构判断，不代表任何业务场景都应迁移；可参考 RuntimeWire 的实现拆解 和 InfoWorld 的企业视角。

Agents API、Agents SDK 和 Responses API 怎么选

方案 谁管理循环 更适合什么场景
Responses API 你的服务 单次或自定义流程，需要完全掌控每一步调用
Agents SDK SDK 在你的进程内 需要会话、追踪、交接和审批，但运行时仍由你部署
Agents API OpenAI 托管 harness 与会话 长时间、可恢复、需要沙箱或多智能体的云任务

OpenAI 的 Agents SDK 文档强调：Responses API 适合自己拥有循环；SDK 适合让库管理循环；Agents API 则进一步托管运行基础设施。已经使用 Responses API 的项目不需要为了“新”而重写，只有当运维智能体循环本身成为负担时，迁移收益才明显。若你正在处理模型接入兼容问题，可先看本站的 GPT-6 Astra Responses API 与 .NET 迁移指南。

适用人群与前置条件

适合：需要运行数小时或数天任务的研发团队、需要代码/文件沙箱的自动化产品、需要主智能体协调多个专长任务的系统，以及不想自行维护上下文压缩与恢复机制的团队。

前置条件：OpenAI API 项目与可用额度；明确的数据分级；至少一个受控工具或 MCP 服务；可审计的任务输入；失败后可重复执行的幂等设计。涉及生产系统时，还要准备人工审批和回滚入口。不了解订阅与 API 两套账单的区别，可先读 ChatGPT Plus 是否包含 API 额度。

最小接入步骤

1. 先做只读任务

首个任务不要直接部署或付款。选择日志分析、资料整理或测试报告生成，让智能体只能读取指定目录和只读接口，并把结果写入独立输出目录。

2. 明确模型、工具与环境

请求中显式指定模型、工具和 environment。使用 MCP 时仅连接本任务必需的服务器；自建环境或 VPC 更适合不能离开现有边界的数据，OpenAI 托管沙箱则适合快速验证文件、命令和产物流程。

const session = await client.beta.agents.sessions.create({
  agent: {
    model: "gpt-6-astra",
    tools: [{ type: "mcp", server_label: "readonly-observability" }],
    environment: { type: "openai_hosted" },
    multi_agent: { enabled: true, max_concurrent_subagents: 3 }
  },
  input: "只读分析最近 30 分钟错误，保存证据与建议，不执行部署。"
});

字段仍处于公测演进期，实际代码应以当天官方 quickstart 为准，不要从文章复制后直接上生产。

3. 设置边界与审批

为网络出口使用允许名单；把凭据放入独立 vault，不写进提示词或工作区；删除、发布、付款、发信等动作必须暂停并等待确认。智能体能调用工具不等于它应拥有管理员权限。可结合本站的 AI Agent 最小权限实操指南建立权限矩阵。

4. 验证恢复能力

主动制造超时、工具 429、沙箱重启和上下文增长，确认任务能从已保存状态继续，而不是重复执行写操作。每个外部写操作都要携带幂等键或版本戳。

成本、数据与安全边界

官方说明称公测期不另收 Agents API 平台费，但仍按 token 和工具计费，第三方或托管沙箱也可能有计算、存储和网络费用。评估成本时应记录每次任务的模型用量、工具次数、沙箱存活时间、失败重试和人工复核时间，而不是只看每百万 token 单价。

数据边界取决于你选择的环境和工具。即使代码运行在自有基础设施，任务、模型请求和会话元数据仍可能经过 API 路径；具体保留、区域和企业控制必须以合同与控制台设置为准。不要因为“可选 VPC”就推断所有数据自动留在本地。

常见错误与排障

  1. 把公测当成稳定版。 固定 SDK/API 版本，给字段变化准备兼容层。
  2. 工具一次挂太多。 先用 tool search 或按任务分组，减少上下文与误调用面。
  3. 子智能体没有边界。 给每个子任务单独指令、工具和输出格式，限制最大并发。
  4. 沙箱有网就默认可信。 出站默认策略要显式核对，高风险域名只允许白名单。
  5. 只测成功路径。 必须测试中断、重复回调、过期凭据和部分成功。

上线检查清单与完成标准

  • 只读基线任务连续通过，结果可复核。
  • 每个工具都有最小权限、超时、重试和审计日志。
  • 写操作使用幂等键，并在执行前设置审批。
  • 会话中断后可恢复，且不会重复产生外部副作用。
  • 成本按任务可观测，达到阈值会停止或降级。
  • 生产数据路径经过安全、合规和合同确认。

完成标准不是“成功创建 session”，而是同一测试任务在正常、超时和恢复三种场景下都得到一致结果，所有副作用可追踪、可阻断、可回滚。

总结

Agents API 的真正价值是把 Codex 式长任务 harness、上下文管理、工具与沙箱变成可调用的托管能力。适合先从低风险、只读、可复现任务试点；若现有 Responses API 或 Agents SDK 已稳定且运维成本不高，不必急于迁移。公测阶段最重要的不是追求最大并发，而是锁定版本、限制权限、测清恢复和算清全链路成本。

FAQ

Agents API 已正式商用了吗？

2026 年 9 月 10 日是 public beta，不是一般可用版。所有开发者可尝试，但接口和能力仍可能快速调整。

使用 Agents API 要额外付平台费吗？

公测期官方称没有附加的 Agents API 费用；模型 token、工具调用和沙箱等资源仍按各自规则计费。

它会取代 Responses API 和 Agents SDK 吗？

不会自动取代。Responses API 适合自管循环，Agents SDK 适合在自有进程内运行，Agents API 适合托管长任务与执行基础设施。

可以在自己的基础设施运行代码吗？

可以选择自有基础设施或合作方沙箱，也可用 OpenAI 托管沙箱。具体数据路径和保留策略仍要逐项确认。

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "OpenAI Agents API 上线：Codex 托管智能体怎么接？定价、沙箱与迁移指南",
  "description": "解释 OpenAI Agents API 公测、Codex harness、托管沙箱、定价、适用场景与安全接入步骤。",
  "datePublished": "2026-09-11",
  "dateModified": "2026-09-11",
  "mainEntityOfPage": "https://next.ccgzs.xyz/blog/openai-agents-api-codex-hosted-agent-guide"
}

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {"@type":"Question","name":"Agents API 已正式商用了吗？","acceptedAnswer":{"@type":"Answer","text":"2026 年 9 月 10 日为 public beta，所有开发者可尝试，但接口仍可能变化。"}},
    {"@type":"Question","name":"使用 Agents API 要额外付平台费吗？","acceptedAnswer":{"@type":"Answer","text":"公测期无额外平台费，模型 token、工具和沙箱资源仍分别计费。"}},
    {"@type":"Question","name":"它会取代 Responses API 和 Agents SDK 吗？","acceptedAnswer":{"@type":"Answer","text":"不会；三者分别适合自管循环、自有进程运行和托管长任务。"}},
    {"@type":"Question","name":"可以在自己的基础设施运行代码吗？","acceptedAnswer":{"@type":"Answer","text":"可以选择自有基础设施、合作方沙箱或 OpenAI 托管沙箱。"}}
  ]
}