2026 年 9 月 10 日，OpenAI 把 Agents API 放进公开测试：对所有开发者开放，用托管的 Codex harness 跑云端 Agent。官方文档（标注 2026-09-11）把职责写清楚：OpenAI 管会话、编排、上下文压缩和恢复；你的应用提供工具，并选择代码跑在哪里。请求要带 OpenAI-Beta: agents=v1，创建会话走 POST /v1/agents/sessions。文档示例模型是 gpt-6-astra。API 本身不另收费，按所选模型的 token 价和内置工具价计；OpenAI 托管沙箱按标准容器费率，与模型用量分开。
以前要自建 Agent 循环：自己管 tool loop、上下文截断、中途恢复、以及代码执行环境。本文只写 Agents API 把哪一层收走，以及沙箱、数据驻留和空闲回收仍把哪些责任留在你这边。
AI Coding 交流群
如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。
发生了什么
文档用四个对象描述产品：Agent（模型、指令、工具、MCP）、Environment（可选沙箱，用来跑命令、改文件、装 skills）、Session（可接任务、可续跑的一次实例）、Events / items（输入和过程中产出）。托管 harness 负责：在沙箱执行命令和代码、套用 skills、经工具或 MCP 取外部数据、中途转向、把先前工作压缩进上下文窗口、把活分给子 Agent、以及从中断处恢复。
执行环境有三类：OpenAI 托管沙箱、自建沙箱、或不用沙箱。托管沙箱是 Linux，预装 Python、Node.js 和一批 CLI，工作目录 /workspace。可配 packages、setup_commands、files、env、skills、plugins、environment_template_id，以及 network.access（默认 enabled，可 disabled，或 restricted 到 1–100 个精确域名，不要通配符、协议、路径或端口）。自建路径由你在本机或云厂商里跑 codex exec-server，文档点名的提供方包括 Modal、Cloudflare、Vercel、Daytona、Blaxel、E2B、Runloop、DigitalOcean、OCI。
硬限制写在文档里，不是脚注：Agents API 目前只支持美国数据驻留，不支持 Zero Data Retention；选自建沙箱也不会让它变成 ZDR 合格。运行时保留名如 PATH、CODEX_*、OPENAI_API_KEY 会被拒绝。setup 命令非零退出则会话起不来。活动与 keep-alive 停满一小时，沙箱可能被删，超时不可配。/workspace/outputs 在一轮结束后变成不可变产物。packages 和 files 在 setup 之前生效；托管 stdio MCP 目前还要求网络 access 为 enabled。模板只复用配置，不能拿来“克隆一份还在跑的磁盘”。
公开测试面向所有开发者，没有单独的 Agents API 席位费。社区转述官方口径是：Bring your own sandbox or connect a sandbox provider，处理器、显卡、内存档位按工作负载选。这解释了为什么 overview 把 Environment 做成可选：短问答可以无沙箱，要写文件、跑测试才需要托管或自建环境。应用仍然要自己决定 Agent 能调用哪些工具，OpenAI 不会因为托管了 harness 就替你审核 MCP 指向的主机。
一条从创建会话到产物的场景
输入是一次 sessions.create：指定模型（文档示例为 gpt-6-astra）、instructions、工具列表（示例含 programmatic tool calling、HTTP MCP、web_search），以及 multi_agent.enabled 和 max_concurrent_subagents（示例为 4）。环境选 openai_hosted 时，OpenAI 先配沙箱再接受用户输入；选 self_hosted 时，你要先让 exec-server 连上，并声明 workspace_directory 与 skills 目录。
会话就绪后，应用只发送 input、消费 stream 或 webhook。Agent 在 /workspace 写代码、跑测试、经 MCP 查文档，需要时再派子 Agent。中途可以再发任务或转向。交付物是会话事件、工作区文件，以及 /workspace/outputs 里冻结的产物。反馈不在本地 REPL，而在事件流：完成、要更多输入、或环境还没 connected——文档要求在 live 文件操作前等到 connected。
为什么这会改变工作流
自建 Agent 的成本通常不在第一次 tool call，而在循环本身：上下文爆了要自己摘要，进程挂了要自己续跑，代码执行要自己找沙箱。Agents API 把这层收成托管服务，应用从“实现 harness”退到“定义 Agent + 选环境 + 收事件”。对要做长任务（查 GitHub issue、对照发行说明、在沙箱里写分析脚本）的产品，这把编排从业务代码里拿出去。
代价是执行地点和合规绑在一起。托管沙箱快，但容器费、一小时空闲回收、美国驻留和禁止 ZDR 都是硬条件。自建沙箱能把文件和密钥留在 Vercel/E2B/你的 VPC，OpenAI 仍跑模型循环，因此“代码在我这边”不等于“请求日志也是 ZDR”。网络 restricted 模式只认精确主机名，stdio MCP 在托管环境下还要求网络 access 为 enabled——工具能连出去，不等于默认锁死。
限制与人接管点
这是公开测试，不是 GA。会话和已发布产物在不用时可能被删。模板只存配置，不存一份活的工作区；网络策略不能比模板放得更宽。人要接管的点包括：选托管还是自建（以及能不能接受非 ZDR）；给 network.access 白名单而不是默认全开；setup 失败时读退出码而不是重试 create；空闲超时前是否主动 keep-alive；子 Agent 并发上限是否和账单匹配。容器费与 token 费分开，新账号按文档提示应先估算容器支出再拉起实例。
也不要把 Agents API 会话、SDK session、Responses conversation 和 sandbox 当成同一个资源。官方写明它们不同，清理规则也不同。删会话才能请求清理托管环境。模型仍按该模型 API 价计，换 gpt-6-astra 以外的模型要看当时平台是否允许，不能从示例推断所有模型都能跑这套 harness。文档里的示例任务（目录树脚本、发行说明对比、事故响应、Slack 机器人、只读 SQL 分析、GitHub issue 调查、带政策 skills 的文档审查）只说明 harness 覆盖的工作类型，不是开箱即用的产品模板。
人如果要把密钥打进沙箱，应走文档允许的 env 字段，且避开被拒绝的保留名；不要把 OPENAI_API_KEY 再注入环境指望 Agent 用同一把钥匙去调别的 API。restricted 域名列表最多 100 个精确主机名，加协议或端口会不符合规则。文件操作必须等环境 connected，否则 live 读写会打在尚未就绪的工作区上。
如何试用
用平台 SDK 的 beta 命名空间创建会话，请求头带 OpenAI-Beta: agents=v1。先走 overview 里的托管沙箱 quickstart，确认事件流和 /workspace/outputs，再改自建 exec-server。需要对照字段时看 OpenAI-hosted sandboxes 文档；架构和对象模型在 Agents API overview。社区帖与 cookbook 日期与 9 月 10 日公告一致，但以 developers.openai.com 文档为准。
信息来源
- OpenAI：Introducing the Agents API（2026-09-10）
- OpenAI 文档：Agents API overview
- OpenAI 文档：OpenAI-hosted sandboxes
- OpenAI 文档：Agents 指南
开发必备：API 全流程管理神器 Apifox
介绍完上文的内容，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、调试、设计、测试、Mock、自动化测试于一体的工具，Apifox 是目前提升研发效率的首选。
如果你正在开发项目，不妨试试其极其友好的界面设计，它完全兼容 Postman 和 Swagger 数据格式，导入数据非常方便，，即使是新手也能很快上手，点击这里即可注册使用。
值得一提的是，除了个人和常规团队使用，针对有高安全合规要求、或需要在内网环境协作的企业，Apifox 还提供了深度定制的私有化部署方案。
获取专属报价与部署方案
详细的私有化部署系统架构与安全白皮书
针对您公司规模的专属报价单
免费的 1v1 专属产品演示 (Demo) 机会
