本文要点：OpenAI 已经把 Agents API 推进到公开测试阶段。它的底层是开源的 Codex 执行框架，开发者只要发起一次 API 调用，就能拉起一个生产级云智能体。你只需要指定任务、模型、工具和运行环境，底层调度全部交给 OpenAI 托管。运行环境共有三种选择：OpenAI 托管沙箱、自有基础设施，以及第三方沙箱合作伙伴。核心能力包括长会话上下文压缩、工具按需检索、并行工具调用，以及通过子智能体把复杂任务拆开并行执行；原生支持 MCP 模型上下文协议、自定义函数和网页搜索工具。更关键的是，API 本身不额外收费，只按 Token 消耗和工具调用计费。Codex 核心代码开源，开发者可以直读源码。目前公开测试版面向所有开发者开放，OpenAI 会持续根据反馈迭代，目标推向正式版。适合长时运行、代码执行、文件读写、任务并行这类云智能体应用。
10 个关键问题 Q&A
Q1：Agents API 是什么？
A：OpenAI 公测的智能体 API，基于 Codex 框架，托管底层基础设施，开发者可以快速搭建云智能体。
Q2：创建智能体有多简便？
A：一次 API 请求，填写任务、模型、工具、环境，直接生成可用于生产环境的智能体会话。
Q3：支持哪些运行环境？
A：OpenAI 托管沙箱、自有服务器，以及 Blaxel、Cloudflare、Vercel 等第三方沙箱。
Q4：子智能体功能作用是什么？
A：把复杂任务拆成独立子任务，多个子智能体并行执行，各自拥有独立上下文，主智能体最后汇总结果。
Q5：上下文压缩 Compaction 解决什么痛点？
A：会话接近上下文上限时自动精简历史，保留关键信息，支持跨窗口长时间运行。
Q6：支持什么工具协议？
A：原生支持 MCP 模型上下文协议、自定义函数、网页搜索等内置工具。
Q7：Codex harness 框架是否开源？
A：核心 Codex 执行框架开源，开发者可在 GitHub 查看源码，OpenAI 负责托管运维。
Q8：Agents API 如何收费？
A：API 本身不收取额外费用，仅按智能体消耗的 Token 与工具调用计费。
Q9：沙箱环境可以做哪些操作？
A：执行代码、读写文件、保存中间结果与任务产出物，还可以预装软件包、技能插件。
Q10：当前处于什么阶段？
A：公开测试版，面向全体开发者开放，OpenAI 根据反馈迭代，后续发布正式版本。
Agents API 正式发布
依托由 OpenAI 完全托管的 Codex 执行框架，直接构建并运行云智能体。
过去我们把 Codex 和面向企业的 ChatGPT 服务推向全球数百万用户，也积累了大量实践经验，逐渐摸清了长期运行的智能体要真正落地需要哪些能力。实用的智能体需要一套强大的执行框架，用来管理上下文、高效调用工具、协调子智能体；同时还需要配套基础设施，保障智能体可以稳定运行数日，拥有读写文件、执行代码、保存中间结果的运行环境。
现在，OpenAI 正式推出公开测试阶段的 Agents API。开发者可以通过一套简洁灵活的 API，直接使用支撑 Codex 的同款执行框架与基础设施。
只需一次 API 调用，即可构建云智能体
使用 Agents API，你仅需一次 API 请求，指定任务、模型、工具以及运行环境，就能创建一个可投放到生产环境的智能体。
import OpenAI from "openai";
const client = new OpenAI();
const session = await client.beta.agents.sessions.create({
agent: {
model: "gpt‑6‑astra",
tools: [
{
type: "mcp",
server_label: "observability",
transport: {
type: "http",
server_url: "https://observability.example.com/mcp",
},
},
],
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
},
vault_ids: ["vault_YOUR_VAULT_ID"],
environment: {
type: "openai_hosted",
capability_directories: ["/workspace/capabilities/skills"],
},
input:
"排查 service‑api 过去30分钟5xx错误率升高问题。" +
"将部署、报错、依赖项分析工作委派给子智能体执行。" +
"把排查结果、证据以及建议的缓解方案保存到 /workspace/outputs。",
});
执行框架由 OpenAI 托管维护。你可以自由选择智能体的计算环境：使用 OpenAI 托管沙箱、部署在自有基础设施，或是选用沙箱合作厂商的服务。Agents API 为智能体开发提供了深度优化过的执行框架和基础设施底座，你只需要专注开发属于自己智能体的工具、知识库与业务工作流即可。
Agents API 的底层，正是驱动 Codex 的同一套执行框架与基础设施。
客户如何评价 Agents API
“借助 Agents API，我们的评测得分从 0.71 提升到 0.85。API 原生提供的子智能体能力极大加快了业务工作流。在旧方案里，观测和编排子智能体十分繁琐，而这套新 API 直接把延迟降低至原来的四分之一。我们为此优化了很久，子智能体相关能力开箱即用，带来巨大提升。” ——Jack Weissenberger，Ciridae 首席技术官
合作客户包括 Ciridae、Long Lake、WithCoverage、SafetyKit、Dwelly、Hypha、deepsense.ai、Nash.ai。
选择你的智能体运行环境
不同业务负载对计算、存储、部署模式的要求各不相同，Agents API 提供了适配应用的多种沙箱选项。
我们与 Blaxel、Cloudflare、Daytona、DigitalOcean、E2B、Modal、Oracle、Runloop、Vercel 等沙箱服务商展开合作，提供一流的集成能力，覆盖多样化需求：
- 全托管环境，或是部署在你的私有虚拟网络（VPC）内部
- 多样化文件与密钥存储机制
- 可自定义 CPU、GPU、内存规格，匹配企业业务的性能、冷启动、成本诉求
Agents API 可与主流生态服务商实现深度集成。
OpenAI 托管沙箱
如果你希望快速上手、高效扩缩容，不妨使用 OpenAI 托管沙箱。该沙箱复用支撑 Codex、ChatGPT 的沙箱基础设施。
由 OpenAI 负责资源分配与运维，为智能体提供安全高性能的运行环境，用来执行代码、处理文件、生成产出物。你可以灵活配置沙箱内的文件、软件包、技能与插件，满足智能体完成任务的全部所需。
基于持续迭代的 Codex 执行框架构建
每当模型能力更新，往往意味着你需要改造自己的执行框架，这会耗费大量本该用于迭代应用的时间。Agents API 提供带版本管理的能力访问方式，并跟随每一轮模型发布同步更新。我们会随模型持续维护、迭代这套执行框架，让你的智能体在模型升级后自动获得更好性能。近期执行框架的增强能力包含下面几大模块。
保障智能体长时间会话持续工作
为支持智能体连续数小时运行，我们实现了上下文管理能力，让智能体可以在超长会话中保留关键信息。当会话即将触及上下文窗口上限时，Agents API 会针对早期上下文执行 上下文压缩（Compaction），保留智能体继续工作所必需的信息。开发者无需自己实现压缩逻辑，即可构建跨多个上下文窗口的业务流程。
帮助智能体更高效地调用大量工具
Agents API 可以帮助智能体查找并高效使用各类工具。工具搜索（Tool Search） 按需加载工具定义，减少 Token 消耗与开销，同时保留模型缓存能力。工具就绪后，程序化工具调用（Programmatic Tool Calling） 支持智能体并行发起调用、串联多步操作，在代码中过滤、合并返回结果，只把关键信息带回上下文，以此处理大批量数据。Agents API 原生支持 MCP、自定义函数，以及网页搜索等内置工具。
"agent": {
"tools": [
{
"type": "mcp",
"server_label": "openai_docs",
"transport": {
"type": "http",
"server_url": "https://developers.openai.com/mcp"
}
}
]
}
利用子智能体实现任务并行处理
借助 多智能体（Multi‑agent） 能力，Agents API 可以把复杂任务拆解为多个独立子任务，委派给子智能体并行执行。每个子智能体拥有独立上下文，专注处理分配给自己的任务；主智能体统一调度，汇总全部结果。对于适合并行处理的调研、数据分析、编码任务，该能力可以显著提速，你不需要从零搭建编排逻辑。
"agent": {
"model": "gpt‑6‑astra",
"multi_agent": {
"enabled": true,
"max_concurrent_subagents": 3,
}
}
开源技术底座
Agents API 构建于开源的 Codex 执行框架之上，开发者可以直接查看协调模型调用、工具、上下文的核心实现逻辑。OpenAI 负责运营维护这套执行框架，开发者可以前往 GitHub 仓库 openai/codex 阅读、学习源代码。
即刻开始开发
现在所有开发者都可以使用公开测试版 Agents API。使用 Agents API 本身不会产生额外服务费，你只需要为智能体实际消耗的 Token 和工具调用付费，计费规则参见定价文档。
查阅 Agents API 概览文档 了解更多细节，或者跟着 快速入门教程 上手，把驱动 Codex 的执行框架接入你自己的智能体应用当中。
公开测试阶段，OpenAI 会根据开发者反馈快速迭代，向着正式可用版本演进。欢迎反馈使用体验、遇到的阻碍，以及你构建生产级智能体所需要的功能。
如果你也在用 Agents API 做生产级智能体，欢迎来 云栈社区 交流实践，一起探讨 Codex 执行框架的落地经验。
关键名词对照表
| 英文 |
译文 |
| Agents API |
智能体 API |
| Agent |
智能体 |
| Codex harness |
Codex 执行框架 / Codex 调度框架 |
| Session |
会话 |
| Sandbox |
沙箱 |
| Artifact |
产出物 |
| Compaction |
上下文压缩 |
| Tool search |
工具搜索 |
| Programmatic Tool Calling |
程序化工具调用 |
| Multi‑agent |
多智能体 |
| Subagent |
子智能体 |
| MCP |
模型上下文协议（Model Context Protocol） |
| Public beta |
公开测试版 |
| Vault |
密钥保管库 |
发表于 4 天前
|
查看: 12|
回复: 0
