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

E2B

將 E2B 沙盒連接至 Agents API 工作階段。

請參閱 OpenAI Cookbook 中的應用程式管理與 Webhook 管理範例。

選擇沙盒佈建模式:

  • 應用程式管理: 由應用程式直接建立並連接 E2B 沙盒。
  • Webhook 管理: 部署處理常式,讓它在收到 OpenAI webhook 時啟動沙盒或重新連接沙盒。

如需比較這兩種模式,請參閱沙盒生命週期。

開始前的準備

設定 E2B_API_KEY,並使用 OPENAI_API_KEY 傳送應用程式的請求。將 OPENAI_EXECUTOR_API_KEY 設為環境金鑰,並且只將這把金鑰以 CODEX_API_KEY 的名稱傳入沙盒。

Webhook 管理

實作控制器,用來驗證 OpenAI webhook,並為每個工作階段佈建獨立的 E2B 工作執行個體。依照部署並連接處理常式的說明,設定憑證、註冊端點並驗證簽章。

將工作階段與沙盒的對應關係儲存至持久性儲存空間。收到連線請求時,若工作執行個體已暫停,請恢復執行;若已刪除,請建立新的執行個體來取代它。暫停時會保留原有檔案,更換執行個體則不會。為控制器和工作執行個體設定執行逾時時間,並在停止使用控制器時移除 OpenAI webhook。

應用程式管理

在應用程式中使用 E2B SDK 或 API 管理沙盒:

  1. 建立自架工作階段,並儲存其環境 ID。
  2. 建立隔離的 E2B 沙盒,在其中設定該工作階段的工作目錄並安裝 Codex CLI。
  3. 使用環境 ID 和環境金鑰,在沙盒中啟動執行器。
  4. 依照執行及繼續工作階段的說明傳送輸入,並查看該回合的結果。
  5. 完成後,刪除工作階段並停止 E2B 沙盒。

請分別設定沙盒的存續時間與執行器指令的逾時時間。即使指令未設逾時時間,沙盒到期後也不會繼續執行。

參考資料