請參閱 OpenAI Cookbook 中由應用程式管理和透過 webhook 管理沙盒的範例。
如需執行器的設定方式與連線需求,請參閱自行託管的沙盒。
選擇沙盒的佈建模式:
- 由應用程式管理: 依照本指南,在應用程式中啟動和停止沙盒。
- 透過 webhook 管理: 部署處理常式,在收到 OpenAI webhook 時啟動沙盒或重新連線至沙盒。
如需比較這兩種模式,請參閱沙盒生命週期。
開始之前
你需要 OpenAI 專案的 API 金鑰、Blaxel 的 API 金鑰與工作區,以及 Codex CLI 套件。
設定 BL_API_KEY 和 BL_WORKSPACE,並使用 OPENAI_API_KEY 傳送應用程式的請求。將 OPENAI_EXECUTOR_API_KEY 設為環境金鑰。只將這把環境金鑰傳入沙盒,變數名稱為 CODEX_API_KEY。
在佈建程式碼中指定沙盒所在的區域。如果需要使用下文介紹的 Agent Drive 來保留檔案,請選擇 us-was-1。
1. 設定 Blaxel 環境
建立自行託管的工作階段,並儲存其環境 ID。使用 Blaxel SDK 或 API 建立隔離的沙盒,讓沙盒使用已設定的工作目錄。在沙盒中安裝 Codex CLI,再使用該環境 ID 和環境金鑰啟動沙盒的執行器。
Blaxel 的 Node 映像檔採用 Alpine Linux,因此安裝 ripgrep 時請使用 apk。以 CODEX_API_KEY 傳遞環境金鑰時,只將金鑰傳給執行器程序。設定 keep_alive=True,以免執行器運作期間沙盒的執行個體數量縮減為零。為設定流程、執行器和沙盒分別設定逾時上限,可避免已無人使用的資源無限期運作。
若經常使用沙盒,可建置已預先安裝 Codex 和 ripgrep 的 Blaxel 映像檔,讓沙盒更快建立連線。
2. 執行工作階段
Blaxel 執行器連線後,依照執行與繼續工作階段中的 HTTP 範例傳送輸入,並以串流方式接收結果。完成後,請刪除工作階段,並另行停止 Blaxel 沙盒。
請先啟動沙盒,再提交輸入。回合會等待環境建立連線。連線建立後,工作階段會在事件串流中發出 agent.session.environment.connected 事件。
請使用 agent.session.turn.completed 確認回合已成功完成。回合失敗或取消後,也可能出現 agent.session.idle 事件,因此不能僅憑工作階段處於閒置狀態就判定回合成功。
選用:跨工作階段保留檔案
使用 Blaxel Agent Drive 可跨沙盒和工作階段保留檔案。在各個沙盒中掛載同一個磁碟機,即可共用檔案。Agent Drive 必須在 us-was-1 區域使用,且不會傳輸對話記錄或工作階段狀態。