若你的 AI 功能已經會回答,卻常卡在長任務接續、工具協調與執行環境維護,OpenAI Agents API 才是值得評估的新選項。 它把 Codex 的代理執行框架做成代管服務,讓開發團隊把更多時間放回自己的產品。只做固定格式摘要的應用,不一定需要遷移。
OpenAI 在 9 月 10 日開放 Agents API 公測。真正要評估的,是哪些基礎工作能交給服務商,以及交出去後還剩多少成本、資料與操作責任。我不建議只因為範例程式短,就認為正式上線也只差一個 API 呼叫。
Agents API、Agents SDK、Responses API 怎麼選?
先分清楚「代理怎麼持續做事」與「程式在哪裡跑」。依 Agents API 文件,OpenAI 負責執行代理、管理上下文與協調工具;開發者可選 OpenAI 代管沙箱,也可接自己的執行環境。沙箱就是供代理操作檔案、執行程式的受控工作空間。
今年 4 月的 Agents SDK 更新已提供沙箱與代理框架能力。這次的新意在於把執行框架交給 OpenAI 維運,不是第一次讓 AI 執行程式。
選用時可以按想掌握的控制程度判斷。這張表是依文件整理的選擇方向,並非互斥的功能清單:
| 選項 | 比較適合的需求 | 你要承擔的主要工作 |
|---|---|---|
| Responses API | 在現有產品中呼叫模型與工具 | 自己設計應用流程及外部系統整合 |
| Agents SDK | 在自己的程式中設計代理行為 | 部署、工具實作、狀態保存與授權決策 |
| Agents API | 希望使用代管 Codex 代理流程 | 提供工具、選擇環境、驗收與產品端控制 |
Responses API本身已有工具呼叫、多輪互動與狀態能力,不能把它簡化成「只能問一句答一句」。Agents SDK 文件則把伺服器端的部署、工具、儲存與核准決策列為開發團隊的控制範圍。需要深度配合既有系統的人,這些控制可能正是保留 SDK 的理由。
我的判斷是:若團隊正在花大量時間處理長任務接續與工具協調,值得試用;若只是固定格式的摘要或資料擷取,先沿用現有 AI API 整合即可,不必因為新 API 上線就全部改寫。還不熟代理運作的人,可以先看 AI Agent 的用途與導入判斷。
一個文件整理任務,代管服務做了哪一段?
假設你替客戶做內部文件比對:讀取指定版本的產品規格,找出與既有說明不一致的地方,產生差異報告,等待人員確認。這是適合試作的情境,因為產物能核對,而且可以先不授予寄信或修改正式資料的能力。
依 Agents API 的工作階段說明,應用程式先建立工作階段並配置工具和環境,再送入任務,接收進度或完成事件,也能在同一工作階段補充要求。換句話說,使用者看到的「幫我比較這些文件」,背後仍有準備資料、執行、等待與交付幾個狀態。
在這個例子裡,開發者要先決定每位客戶能讀哪些文件、哪份是正式版本、報告交給誰。代理可以處理比較與整理,但「這份過期文件不應再用」的規則,以及「這位客戶不能讀另一位客戶資料」的限制,不能只靠模型自己猜。
最小的成功條件也應先寫清楚:報告有列出對應文件與版本,重要差異能回到原文核對,找不到的部分標示缺資料,而不是補出一段合理敘述。這樣才分得清楚是代理完成了工作,還是只完成了一篇看起來像報告的文字。
沙箱放在哪裡,影響誰要維護什麼
OpenAI 代管沙箱適合先確認任務能不能做。需要自己的執行映像、運算資源或私有網路時,再評估其他環境。重點是把沙箱選擇和代理框架分開,不必把所有需求都綁在同一個「是否用 OpenAI」的決定裡。
Cloudflare 的上線範例會為 Codex 工作階段維持容器,接續輸入並在閒置時關閉。E2B 的工作台範例則示範由應用程式呼叫 E2B SDK,控制沙箱啟動、連線與停止。
因此,「支援某家沙箱」不是所有維運都有人包辦。更重要的是,改用自家沙箱只改變執行環境,不會改掉 OpenAI 代管代理流程這個架構。若公司要求資料不得送到外部服務,不能把這種接法當成全內部部署。
檔案保存也要分開看。產物文件指出,OpenAI 代管環境在一輪工作完成後,會把 /workspace/outputs 下的輸出發布成不可變更的產物副本,可在環境到期後下載;自管環境的檔案則要透過自己的平台取回,不會因為用了相同目錄名稱就自動進入同一套產物 API。
因此,文件整理服務應把「拿到可下載成果」列入完成條件。不要只保存工作階段編號就通知客戶結案;還要確認報告已取回、版本對得上,而且在刪除工作階段前保存需要保留的產物。暫存工作區與正式交付儲存空間,是不同責任。
Agents API 費用怎麼算?別只看 Token 單價
官方開發者公告說明,Agents API 不另收使用費,但仍按模型與工具用量計費,OpenAI 代管沙箱採容器費率。
截至 9 月 14 日,官方價格表列出:1 GB 容器每個 20 分鐘工作階段為 0.03 美元,4 GB 為 0.12 美元,且是每個容器分別計算。這項費率只涵蓋容器;模型和其他付費工具另計,合作沙箱也須看各自帳單。
用上述費率做一個假設試算:若一批工作實際產生 100 個、各 20 分鐘的 4 GB 容器計費單位,容器小計就是 100 × 0.12=12 美元。若改成 1 GB,同樣條件下是 3 美元。這些是便於理解的假設用量,不是「處理 100 份文件必定花這個錢」,更不包含 Token、搜尋或其他服務費。
模型成本則要按實際輸入、快取與輸出用量,套用所選模型費率。長文件反覆傳入、工具回傳大量內容,或失敗後重新執行,都可能讓帳單和第一次成功範例差很多。容器單價低,不足以判斷整個服務便宜。
評估時,應把模型、工具與沙箱費用加總,再除以真正完成驗收的任務數。便宜模型若不斷重試,未必省錢;子代理同時工作,也不代表總運算量變少。台灣接案團隊向客戶報價時,別只照成功範例估價,還要留下失敗重跑與人工檢查的成本。
我會特別看耗費最高的那些任務:是不是文件特別長、來回追問太多,或工具一直失敗?若只看平均值,很容易漏掉少數任務吃掉大部分預算。先決定什麼情況應停止並交由人員處理,再談包月或固定單件報價,比假設代理永遠一次完成可靠。
上線前最該測的,是拒絕與停止
OpenAI 代管沙箱文件有個值得注意的預設:除非繼承範本政策,對外網路存取是開啟的。可改成關閉,或限制指定主機;不能因為名稱有「沙箱」,就認為它預設無法連外。
網路限制還要看連線從哪裡發出。沙箱安全文件區分環境端的 MCP 與由 OpenAI 服務端連接的遠端 MCP。只關閉沙箱對外網路,不能據此推論所有工具都已無法存取外部服務,必須逐項確認工具的連線方式。
同一份文件也提醒:代理產生的程式可以讀到環境裡可用的檔案與憑證。應把應用程式 API 金鑰留在環境外,只提供執行端需要的有限權限。把金鑰從程式碼搬到環境變數,並不等於代理就讀不到它。
團隊驗收時,我建議優先測這些情境,逐項確認實際行為:
- 換成低權限帳號後,原本不能讀的客戶資料是否仍被擋住?
- 取消工作後,外部服務是否還在執行已送出的操作?
- 同一項寄信或寫入要求重試時,會不會重複執行?
- 工具回傳不可信的指令時,代理是否仍只能使用原先授權的能力?
若接入 MCP 工具,這些測試也要涵蓋工具服務端。我不建議第一個試點就放自動退款或正式資料修改;先做可由人核對、失敗不會直接傷到客戶的文件整理,確認能停止、能追查,再擴大授權。
尤其要注意「逾時」和「沒執行」不是同一件事。假設寄信服務已寄出郵件,回應卻在途中失敗,代理重試就可能再寄一次。應由你的工具服務確認是否已完成同一項工作,避免重複操作;不能只在提示詞加一句「不要重複寄信」。
取消也一樣。停止代理後,先前送到外部服務的工作可能需要另外取消或查狀態。對外有影響的操作應留下可追查紀錄,人工核准時要能看見具體收件者、資料範圍或修改內容,而非只顯示「是否允許代理繼續」。這些是應用設計建議,不是開通 API 就自動取得的保證。
值不值得遷移,先比較同一件工作
保留原本流程,用同一批經核准的測試文件比較結果:重要差異是否漏掉、出錯能否定位、總成本與等待時間如何、需要人工修正多少。不要一邊換模型、一邊換資料、一邊改整套流程,最後卻把所有改善都歸功於新 API。
對小型開發團隊,我的建議是先把產生報告這一段交給代理,下載、閱覽權限與對外發送仍由現有產品掌握。若維運負擔確實降低,結果也能穩定核對,再逐步增加任務。當你的核心需求是完全掌握執行流程或嚴格限制資料流向,就應保留自管方案的比較,而不是急著追上公測發布。
常見問題
Agents API 已經正式推出了嗎?
9 月 10 日公告的狀態是公開測試版。可以評估與試作,但仍應追蹤文件變更,不要把公測當成所有介面和行為都已固定。
使用自己的沙箱,資料就不會離開公司嗎?
不能這樣推論。程式與檔案的執行環境可以自己選,但代理流程仍由 OpenAI 代管,必須另行確認模型與工具呼叫會傳送哪些內容。
Agents API 可以直接取代原本的 Agents SDK 嗎?
不要把它當成只換套件名稱的升級。既有工具、狀態保存、授權與部署流程都要核對;適不適合遷移,取決於你想交出去多少維運工作,以及還需要多少控制權。
參考來源
- OpenAI:Introducing the Agents API(2026-09-10)
- OpenAI:The next evolution of the Agents SDK(2026-04-15)
- Cloudflare:Use Cloudflare Containers with Codex via the OpenAI Agents API(2026-09-10)
- E2B:Build an Agent Workbench on OpenAI’s Agents API(2026-09-10)
- OpenAI Developer Community:Introducing the Agents API and hosted sandboxes(2026-09-10)