請參閱 OpenAI Cookbook 中由應用程式管理和透過 webhook 管理沙盒的範例。
如需瞭解執行器的設定方式與連線需求,請參閱自架沙盒。
選擇沙盒的佈建模式:
- 由應用程式管理: 依照本指南,從應用程式啟動及停止沙盒。
- 透過 webhook 管理: 部署處理常式,在收到 OpenAI webhook 時啟動沙盒或重新連線至沙盒。
如需比較這兩種模式,請參閱沙盒生命週期。
透過 webhook 管理
使用控制器驗證收到的 OpenAI webhook 請求,並將佈建工作加入佇列。控制器應與工作節點的沙盒分開部署,各工作階段的執行器會在工作節點的沙盒中執行。依照部署並連接處理常式的步驟註冊端點與簽章金鑰。
收到 environment_connection 請求時,啟動工作節點或重新連線至該節點。工作階段失敗時,請釋放該節點。請明確設定工作節點和控制器各自的逾時時間。若要在閒置時停止運算資源,必須透過策略協調停止資源與接收新工作的時機。詳情請參閱生命週期行為。
由應用程式管理
開始之前
請先備妥 OpenAI 專案 API 金鑰、Daytona API 金鑰及 Codex CLI 套件。
設定 DAYTONA_API_KEY,並使用 OPENAI_API_KEY 傳送應用程式的請求。將 OPENAI_EXECUTOR_API_KEY 設為環境金鑰。只將這把金鑰傳入沙盒,作為 CODEX_API_KEY 的值。
1. 設定 Daytona 環境
建立自架工作階段並儲存其環境 ID。使用 Daytona SDK 或 API 建立隔離的沙盒,讓沙盒使用已設定的工作目錄。在沙盒中安裝 Codex CLI,再使用該環境 ID 和環境金鑰啟動沙盒的執行器。
執行器會主動連線至 OpenAI,並長時間維持連線,但 Daytona 在判斷沙盒是否閒置時不會偵測到這條連線。請設定 auto_stop_interval=0,以免沙盒在智慧體工作期間停止。另請設定沙盒的存續時間上限,以免執行中斷後,運算資源仍無限期運作。
若經常使用沙盒,請將 Codex 和 ripgrep 納入 Daytona 快照,讓沙盒能更快建立連線。
2. 執行工作階段
Daytona 執行器建立連線後,依照執行及繼續工作階段中的 HTTP 範例傳送輸入,並以串流方式接收結果。完成後,請刪除工作階段,並另外停止供應商的沙盒。
請先啟動沙盒,再提交輸入。回合會等待環境建立連線。連線建立後,工作階段會透過事件串流中的 agent.session.environment.connected 回報連線成功。
請以 agent.session.turn.completed 判斷回合是否成功完成。回合失敗或取消後,也可能出現 agent.session.idle,因此不能僅憑工作階段閒置就判定回合成功。若在事件發生後立即查詢工作階段,短時間內仍可能取得先前的狀態。