觀點 · 資訊分享

OpenAI Agents API 沙盒可以先「熱機」：預熱免費，對話之間的閒置時間也不再收費

OpenAI 讓 Agents API 的代管沙盒可以在使用者還在打字時就先準備好環境，等請求一來直接開工；預熱本身免費，沙盒運算也改成只在 AI 真正工作的回合計費。

一句話看懂：OpenAI 讓 AI 代理用的雲端沙盒可以先「熱機」，使用者還在打字時就把環境準備好；預熱免費，對話之間的閒置時間也不再收費。

Agents API 沙盒可以預熱資訊圖卡：趁使用者還在打字就先裝好套件、放好檔案，等待時間變短，閒置也不用付錢

先用白話講：沙盒和「預熱」是什麼？

想像你請了一位師傅來家裡修東西。如果師傅每次都要等你開口後，才開始搬工具箱、找零件，你就得在旁邊乾等。比較聰明的做法，是在你描述問題的同時，師傅就先把常用工具擺好。

沙盒就是 AI 代理的工作桌：一個由 OpenAI 代管的環境，AI 可以在裡面跑程式、讀寫檔案。預熱就是先把工作桌擺好：套件先裝、檔案先放，等任務一來就直接開工。

OpenAI 在 10 月 9 日的 API 更新日誌公布兩項 Agents API 的變更：

官方文件補充了幾個關鍵數字：

官方舉的例子很實際：

如果你的 AI 代理每次開工都要先花一段時間安裝相依套件、下載檔案，這段時間以前全都算在使用者的等待裡；現在可以提前做完。

流程分三步：

呼叫 POST /v1/agents/environments 建立環境，獨立建立時 environment.type 設為 openai_hosted，並帶入要安裝的套件、檔案與設定指令
查詢環境狀態，從 pending 變成 ready 就代表準備好了（也可以改用 webhook 通知）
建立對話時帶入環境 ID：

environment: { type: "openai_hosted", environment_id: environmentId }

注意事項：

也可以在設定還沒跑完時就附加，代理會等設定完成才開始使用工作區，可透過 agent.session.environment.ready 或 agent.session.environment.failed 事件追蹤
「ready」只代表環境準備好，不代表已經有代理連上
官方文件要求的 SDK 版本：Python 3.28.0、Node.js 7.32.0、Java 4.80.0、Ruby 0.103.0 以上

做 AI 功能給客戶用時，最常被抱怨的不是答案好不好，而是「按下去要等很久」。很多時候慢不是因為模型，而是環境準備、套件安裝這些雜事。預熱把這段時間藏到使用者打字的空檔裡，體感會差很多。

計費的改變我覺得更實在。AI 代理常常是「做一下、等使用者回覆、再做一下」，以前閒置時間也在計費，對話拉得越長越吃虧。現在只算工作回合，長時間開著的代理成本比較好估。不過預熱沙盒 5 分鐘沒用就過期，設計流程時要抓好時機，別太早熱、熱完又放涼。

什麼是代管沙盒？

它是由 OpenAI 代管的工作環境，AI 代理可以在裡面跑程式、讀寫檔案。程式跑在 OpenAI 那邊，不用你自己準備主機。

預熱要怎麼用？

先呼叫 POST /v1/agents/environments 建立環境並指定要裝的套件、檔案與設定指令，等狀態變成 ready（或用 webhook 通知），再在建立對話時帶入環境 ID。也可以在設定還沒跑完時就先附加，代理會等設定完成才開始使用。

預熱好但沒用到會被收費嗎？

官方文件寫明預熱免費，包含附加前的容器用量；沒被附加的預熱沙盒 5 分鐘後自動過期。附加到對話之後，才依一般的容器價格計費。

作者

接案做系統開發、網站與主機託管。觀點裡的文章都是我自己寫的,寫的是做專案時第一手遇到的事。