如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

Blaxel

在 Blaxel 沙盒中執行 Agents API 工作階段。

請參閱 OpenAI Cookbook 中由應用程式管理和透過 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 區域使用,且不會傳輸對話記錄或工作階段狀態。

參考資料