Agents API

OpenAI 正式推出了 Agents API 公开测试版。这一举措标志着 OpenAI 将其内部用于驱动 Codex 和 ChatGPT for Work 的核心智能体框架基础设施化，并以 API 的形式向外部开发者开放。通过该 API，开发者可以构建能够管理长上下文、高效调用工具并协调子智能体的复杂智能体，而无需自行维护底层的运行时环境。

核心架构：四大概念

Agents API 的设计围绕四个核心组件展开，简化了智能体应用的开发流程：

1. Agent (智能体)：定义模型（如 gpt-6-astra）、系统指令、可用工具以及 MCP 服务器配置。
2. Environment (环境)：可选的沙箱环境，智能体在此访问文件、加载技能或执行命令。支持 OpenAI 托管、自托管或合作伙伴沙箱。
3. Session (会话)：一个持久的智能体实例，负责处理任务并响应输入。会话状态由 API 自动管理。
4. Events & Items (事件与条目)：发送给智能体的输入及其产生的输出流，支持实时跟踪进度。

关键特性：内置的高级智能体能力

OpenAI 在 API 层面封装了构建可靠智能体所需的复杂逻辑：

• 长会话管理：当会话接近上下文限制时，API 会自动压缩早期上下文，开发者无需编写复杂的摘要或截断逻辑。
• 高效工具使用：
  • 按需加载：仅在需要时加载工具定义，减少 Token 消耗并保留模型缓存。
  • 程序化调用：支持并行运行工具调用并链接操作，智能体可在代码中过滤结果，仅将相关数据返回上下文。
• 多智能体协调 (Sub-agents)：主智能体可将复杂任务拆解，委托给独立的子智能体处理。每个子智能体拥有独立上下文，主智能体负责协调并整合结果。
• 灵活的沙箱选择：
  • OpenAI 托管：使用与 Codex 相同的基础设施。
  • 自托管：通过 codex exec-server 在自有基础设施上运行，所有连接均为出站。
  • 合作伙伴集成：支持 Blaxel, Cloudflare, E2B, Vercel 等 9 家合作伙伴的一流集成。

极简集成：一次 API 调用

开发者可以通过简单的 SDK 调用启动一个具备多智能体协调能力的复杂任务：

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](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。",
});

性能对比：Agents API vs SDK vs Responses API

⚠️ 限制与注意事项

• 数据驻留：目前数据仅限美国境内处理。
• 零数据保留 (ZDR)：不支持 ZDR 选项，这对于某些受严格监管的行业可能是一个障碍。
• 计费模式：API 本身无额外费用，开发者需为消耗的 Token、工具调用及容器运行时间付费。