請參閱 OpenAI Cookbook 中由應用程式管理沙盒和透過 webhook 管理沙盒的範例。
如需瞭解執行器的設定方式與連線需求,請參閱自架沙盒。
選擇沙盒的佈建模式:
- 由應用程式管理: 依照本指南,從應用程式啟動及停止沙盒。
- 透過 webhook 管理: 部署處理常式,讓它在收到 OpenAI webhook 時啟動沙盒或重新連線至沙盒。
如需比較這兩種模式,請參閱沙盒生命週期。
開始之前
請使用具備沙盒存取權的 Vercel 專案。Vercel 沙盒 SDK 的驗證方式取決於應用程式的執行位置:
- 在本機執行: 在環境中設定
VERCEL_TOKEN、VERCEL_TEAM_ID和VERCEL_PROJECT_ID。 - 部署在 Vercel 上: 使用 Vercel OIDC。
應用程式發出請求時,請使用 OPENAI_API_KEY。將 OPENAI_EXECUTOR_API_KEY 設為環境金鑰,並且只將這把金鑰以 CODEX_API_KEY 的名稱傳入沙盒。
1. 設定 Vercel 環境
建立自架工作階段,並儲存其環境 ID。使用 Vercel SDK 或 API 建立隔離的沙盒,讓沙盒使用已設定的工作目錄。在沙盒中安裝 Codex CLI,再使用該環境 ID 和環境金鑰啟動沙盒的執行器。
如果經常使用沙盒,請將 Codex 納入 Vercel 快照,讓沙盒能更快建立連線。
2. 執行工作階段
Vercel 執行器建立連線後,請依照執行及接續工作階段中的 HTTP 範例傳送輸入,並以串流方式接收結果。使用完畢後,請刪除工作階段,並另行停止 Vercel 提供的沙盒。