跳到主要內容
OpenAI

2026年9月10日

產品API

Agents API 正式登場

使用由 OpenAI 全面管理的 Codex 任務執行框架,建立及運行雲端智能代理。

正在載入...

隨着 Codex 和「ChatGPT 工作」的服務規模擴展至全球數百萬名用戶,我們掌握如何讓長時間運行的智能代理在實際應用中發揮良好表現。實用的智能代理需要強大的任務執行框架,以管理上下文、有效運用工具並協調子智能代理。此外,還需要能支援智能代理可靠地持續運行數天的基礎架構,以及可處理檔案、執行程式碼及儲存中間結果的環境。

今天,我們推出公開 Beta 版 Agents API(在新視窗中開啟),透過簡單靈活的 API,將支援 Codex 的同一套任務執行框架和基礎架構帶給開發人員。

OpenAI 負責託管及維護任務執行框架。你可以選擇智能代理的運算環境:OpenAI 管理的沙盒、自有基礎架構,或我們其中一家沙盒合作夥伴提供的環境。Agents API 讓你以經過優化的智能代理任務執行框架和基礎架構為基礎,建立智能代理,並專注於令智能代理與眾不同的工具、知識和工作流程。

「採用 Agents API 後,我們的評估分數由 0.71 升至 0.85。API 的子智能代理支援非常出色,大幅加快了我們的工作流程。以往在舊有配置中觀察及協調子智能代理相當繁複,新 API 則令延遲縮短至四分之一。我們曾花費大量時間嘗試最佳化這方面,而開箱即用的子智能代理流程帶來了顯著提升。」
Ciridae 技術總監 Jack Weissenberger
應用程式向 Agents API 傳送任務,並接收事件和輸出。Agents API 運行託管的 Codex 任務執行框架,向沙盒傳送工具調用並接收工具結果。應用程式控制自行託管的運算資源。

Agents API 採用支援 Codex 的同一套任務執行框架和基礎架構,支援你的智能代理運作。

只需一次 API 調用,即可建立雲端智能代理

使用 Agents API,只要指定任務、模型、工具和環境,即可透過一次 API 調用建立可投入正式運作的智能代理:

JavaScript

1
import OpenAI from "openai";
2

3
const client = new OpenAI();
4

5
const session = await client.beta.agents.sessions.create({
6
agent: {
7
model: "gpt-6-astra",
8
tools: [
9
{
10
type: "mcp",
11
server_label: "observability",
12
transport: {
13
type: "http",
14
server_url: "https://observability.example.com/mcp",
15
},
16
},
17
],
18
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
19
},
20
vault_ids: ["vault_YOUR_VAULT_ID"],
21
environment: {
22
type: "openai_hosted",
23
capability_directories: ["/workspace/capabilities/skills"],
24
},
25
input:
26
"Investigate service-api’s elevated 5xx rate over the last 30 minutes. " +
27
"Delegate deployment, error, and dependency analysis to subagents. " +
28
"Save findings, evidence, and recommended mitigation in /workspace/outputs.",
29
});

客戶對 Agents API 的評價

1/8
「採用 Agents API 後,我們的評估分數由 0.71 升至 0.85。API 的子智能代理支援非常出色,大幅加快了我們的工作流程。以往在舊有配置中觀察及協調子智能代理相當繁複,新 API 則令延遲縮短至四分之一。我們曾花費大量時間嘗試最佳化這方面,而開箱即用的子智能代理流程帶來了顯著提升。」
Ciridae 技術總監 Jack Weissenberger

選擇智能代理環境

不同工作負載需要不同的運算、儲存和部署選項。Agents API 讓你選擇適合應用程式的沙盒。

我們正與 Blaxel、Cloudflare、Daytona、DigitalOcean、E2B、Modal、Oracle、Runloop 和 Vercel 等生態系統供應商合作(在新視窗中開啟),提供完善的整合支援,以滿足不同需求:

  • 全面託管的環境,或在你的 VPC 內部署
  • 特定的檔案和機密資料儲存機制
  • 不同的 CPU、GPU 和記憶體配置,以及切合公司工作流程的效能、冷啟動表現和成本特性。
沙盒合作夥伴:Modal、Cloudflare、Daytona、Blaxel、Runloop、Vercel、Oracle、E2B 及 DigitalOcean。

Agents API 提供完善的整合支援,可與廣受採用的生態系統供應商整合。

OpenAI 託管沙盒

我們亦為希望快速起步並有效擴展規模的開發人員推出 OpenAI 託管沙盒(在新視窗中開啟)。這項服務採用支援 Codex 和 ChatGPT 的同一套沙盒基礎架構。

OpenAI 負責配置和管理沙盒,為智能代理提供安全、高效能的環境,以執行程式碼、處理檔案及產生交付成果。你可按需要靈活配置這些沙盒,加入檔案、套件、技能和外掛程式,為智能代理提供完成任務所需的資源。

採用持續演進的 Codex 任務執行框架進行開發

要善用模型的新功能,往往需要重新設計任務執行框架,佔用原可用於改善應用程式的寶貴時間。每次推出新模型時,Agents API 都會提供這些功能的版本化存取。我們會配合模型維護並持續改善任務執行框架,協助智能代理從每次升級中獲得更佳效能。近期的任務執行框架改進包括:

讓智能代理在長時間工作階段持續運作

為支援模型連續工作數小時,我們建立了上下文管理功能,協助智能代理在更長的工作階段中保留相關資訊。當工作階段接近上下文上限時,Agents API 會自動壓縮(在新視窗中開啟)較早的上下文,同時保留智能代理繼續運作所需的資訊。開發人員無需自行編寫上下文壓縮邏輯,即可建立橫跨多個上下文視窗的工作流程。

協助智能代理有效運用更多工具

Agents API 協助智能代理找出合適工具並有效運用。工具搜尋(在新視窗中開啟)會按需要載入相關工具定義,有助減少 Token 用量和成本,同時保留模型快取。工具可用後,程式化工具調用(在新視窗中開啟)可讓智能代理並行調用工具、串連相關操作,並透過程式碼篩選或合併結果,從而處理大量資料,同時只把相關結果帶回上下文。Agents API 支援 MCP、自訂函數,以及網頁搜尋等內置工具。

JSON

1
"agent": {
2
"tools": [
3
{
4
"type": "mcp",
5
"server_label": "openai_docs",
6
"transport": {
7
"type": "http",
8
"server_url": "https://developers.openai.com/mcp"
9
}
10
},
11
]
12
}

讓智能代理透過子智能代理並行處理工作

Agents API 透過多智能代理支援(在新視窗中開啟),將複雜任務拆分成獨立部分,再交由子智能代理並行處理。每個子智能代理各自維護本身的上下文,以便專注於獲派的任務;主智能代理則協調各個子智能代理的工作並整合結果。這可加快適合並行處理的研究、分析和編程任務,而你無需自行建立協調機制。

JSON

1
"agent": {
2
"model": "gpt-6-astra",
3
"multi_agent": {
4
"enabled": true,
5
"max_concurrent_subagents": 3,
6
}
7
}

An open-source foundation

The Agents API is powered by the open-source Codex harness, giving developers visibility into the core logic that coordinates model calls, tools, and context. With the Agents API, OpenAI operates and maintains that harness while developers can inspect and learn from its public codebase(在新視窗中開啟).

Start building

Agents API is available in public beta today to all developers. There are no additional fees for using the Agents API – you simply pay for the tokens and tools your agents use, as outlined on our pricing page(在新視窗中開啟).

Explore the Agents API overview(在新視窗中開啟) to learn more, or follow the quickstart(在新視窗中開啟) to get started and bring the harness behind Codex into your own agents.

During the public beta, we’ll iterate quickly based on your feedback as we work toward general availability. Let us know what’s working, where you’re running into friction, and what you need to build and run your agents in production.

作者

OpenAI