OpenAI 的 Agents API 現已進入公開 Beta,但它既不是更便宜的模型呼叫替代方案,也不是開箱即用的自動化平台。OpenAI 負責管理 agent harness;開發者則要自行選擇執行環境、工具,以及整套系統的操作邊界。
先講結論:這次推出了什麼,誰值得關注?
OpenAI 在 2026 年 9 月 10 日宣布推出 Agents API,開放開發者參與公開 Beta。根據官方公告,這是一套由 OpenAI 代管、用來執行雲端 agents 的方案,整合 Codex harness、模型、工具,以及開發者選定的沙盒環境。
如果你的團隊已經在打造需要長時間執行、會使用工具的 agents,Agents API 會比較有吸引力。反過來說,對於邊界清楚、執行時間有限的請求,直接使用 Responses API,再自行維護一個簡單的應用程式迴圈,可能更容易掌控。
| 問題 | 答案 |
|---|---|
| 現在可以使用嗎? | 可以,目前是公開 Beta,尚未正式 GA |
| Agents API 有額外的平台費嗎? | OpenAI 表示沒有;但模型與工具的使用仍會產生費用 |
| 所有應用程式程式碼都由 OpenAI 執行嗎? | 不是。你可以選擇由 OpenAI、合作夥伴或自行託管的環境執行 |
| OpenAI 負責管理什麼? | Agent harness,包括協調流程與長時間工作階段的處理 |
| 適合直接用於正式環境嗎? | 適合受控的試點專案;但由於仍是 Beta,必須準備回滾方案 |
架構重點:先決定工作在哪裡執行
Agents API 將推理迴圈與實際執行工作的環境分開。Harness 可以管理工作階段、上下文、工具選擇與任務委派,而沙盒則負責執行程式碼、處理檔案或產生成品。
OpenAI 的架構文件是理解這個界線的主要依據。相關發布報導列出的合作夥伴執行環境包括 Blaxel、Cloudflare、Daytona、DigitalOcean、E2B、Modal、Oracle、Runloop 和 Vercel。這些服務的價格與各地區支援能力並不相同,不能直接視為可互換。
| 執行選項 | 適合情境 | 主要取捨 |
|---|---|---|
| OpenAI 代管沙盒 | 快速製作原型,並希望由平台代管執行環境 | 對基礎架構的控制較少 |
| 合作夥伴沙盒 | 已經使用特定供應商,或有指定的部署需求 | 價格與執行行為會因供應商而異 |
| 自行託管環境 | 已有安全性、網路或基礎架構要求 | 更多可靠性與維運工作要由自己負責 |
如果網路政策、密鑰管理、資料存放地區或檔案系統控制是不可妥協的要求,就應優先考慮自行託管。若你更重視導入速度,則可以選擇代管執行,但前提是供應商提供的套件、逾時設定、持久化機制與成品處理方式都通過實際測試。
無論選擇哪種環境,密鑰、檔案、網路存取權限與持久化狀態等治理決策,仍然掌握在團隊手上。
這個 Beta 真正帶來了什麼?
Agents API 概覽及相關文件,列出多項針對單次模型回合無法輕鬆處理的長流程工作而設計的功能。
長時間工作階段與上下文壓縮
自動上下文壓縮可以協助控制長時間執行時不斷膨脹的上下文,但 OpenAI 並未承諾一個適用所有情境的壓縮比例或最長執行時間。實際效果仍應以具代表性的工作負載進行測量。
工具搜尋與平行呼叫
工具搜尋能減少每次模型上下文都要載入的工具資訊。當多個工具呼叫彼此獨立時,程式化的平行工具呼叫有機會縮短整體等待時間。不過,這兩項功能都不代表有相依關係的呼叫可以安全平行處理:如果工作流程必須先取得結果 B,才能呼叫工具 C,那麼兩者仍然必須依序執行。
多代理委派
主要 agent 可以把子任務委派給其他 agents,也能讓多個子任務平行處理。這對範圍明確的研究、分類或成品建立工作很有用,但同時也會增加失敗路徑與計費路徑。因此,應在應用程式設計階段就設定子 agent 數量上限與最大回合數。
執行環境
文件涵蓋OpenAI 代管沙盒與自行託管沙盒。做決定前,應針對確切的供應商測試套件安裝、檔案系統持久化、網路政策、憑證、逾時限制與成品處理流程。
成本怎麼算:沒有平台費,不代表免費
OpenAI 表示,Beta 期間 Agents API 本身不會額外收取平台費。但實際帳單仍可能包含模型 token、內建或外部工具,以及沙盒基礎架構的費用。
| 成本層級 | 需要編列的預算 |
|---|---|
| 模型呼叫 | 每一回合及每個子 agent 所使用的輸入與輸出 token |
| 內建工具 | 適用時產生的工具專屬使用費 |
| 沙盒 | 運算、儲存、網路或供應商收取的費用 |
| 應用程式維運 | 日誌、佇列、資料庫、監控與重試 |
獨立的 A8gent 成本分析說明了為什麼不能只看單次呼叫來估價。以每月 1,000 次分類執行、每次 3,000 個輸入 token 和 400 個輸出 token 的指定工作負載為例,該分析估算使用 gpt-5-nano 時,每月模型 token 成本約為 $0.31;使用 gpt-5.6-sol 時則約為 $27,且尚未計入託管費用。這些數字是該文章當時的計算結果,不是 Agents API 的官方報價。
多回合工作流程的成本會高於單次呼叫估算,因為後續回合會攜帶累積的上下文;實際預算應根據你自己的使用資料來設定。
比較穩妥的試點做法,是設定最大回合數、限制並行工作量、記錄每個已完成業務結果所消耗的 token,並為每次執行設下支出上限。OpenAI Cookbook 的單次執行支出控制器範例明確註明其中價格是虛構的,但它採用的預留模式仍然值得參考:每次發出請求前先預留最壞情況所需的金額,完成後再按照實際用量結算。
導入前,正式環境問題先逐一確認
由於 Beta API、整合方式與使用限制都可能變動,務必保留一套備援機制,讓系統可以停止建立新的執行工作,同時避免破壞主資料。
早期使用者 @yandt888 曾提出美國資料存放地區,以及自行託管執行與零資料保留要求之間如何配合的疑慮。這是使用者提出的實務問題,並非 OpenAI 的政策聲明;在傳送受法規規範的資料前,請先確認目前適用於你帳戶的合約條款與地區規定。
正式導入前,至少要確認以下事項:
- 執行失敗後能否繼續,而不會重複觸發外部操作。
- 工作階段記錄、檔案與成品儲存在哪裡,以及供應商服務中斷時會發生什麼事。
- 團隊能否追蹤子 agent 的決策、重現輸入內容,並在 Beta 合約變更時完成遷移。
展示影片只能當作展示來看:不可逆的操作應加上權限閘門,工具在可行時應設計成具備冪等性,另外也要使用真實整合測試提示注入與部分失敗情境。
一條比較實際的導入界線
如果真正困難的地方,是要在多個工具、工作階段或專業化 agents 之間協調需要判斷的工作,Agents API 會是值得優先評估的選項。可以先從文件分類、內部研究或成品生成等邊界明確的任務開始,再拿它與原本需要自行維護的簡單迴圈比較。
| 如果你的優先考量是…… | 可以先從……開始 |
|---|---|
| 快速使用代管式協調功能 | Agents API 試點 |
| 最大程度掌控工作流程狀態 | 自行建立協調層 |
| 嚴格要求供應商可移植性 | 與模型無關的框架或閘道 |
| 高可靠度的核准流程與稽核 | 在 agent 外圍建立工作流程引擎 |
| 成本最低且可預測的單回合呼叫 | 直接呼叫模型 API |
規劃試點時,先定義一個成功指標、一個每項任務的最高成本、一個最長執行時間,以及一個人工核准節點。如果代管式 harness 沒有明顯減少工程時間,也沒有改善失敗後的復原行為,就不應讓它變成新的 Beta 依賴。
OpenAI Agents API 常見問題
OpenAI Agents API 已經正式推出了嗎?
還沒有。OpenAI 在 2026 年 9 月 10 日宣布它進入公開 Beta,發布資料中尚未宣布正式 GA 時程。
可以使用自己的沙盒嗎?
可以。OpenAI 將自行託管環境列為選項之一,此外也支援 OpenAI 代管與合作夥伴環境。採用自行託管後,安全性、網路、持久化與維運工作就會更多地落在你的團隊身上。
支援多代理工作流程嗎?
支援。API 可以將工作委派給子 agents,也支援平行處理。請設定明確的限制,因為每增加一個 agent,都可能帶來更多延遲、token 用量與失敗模式。