請參閱 OpenAI Cookbook 中的應用程式管理與 webhook 管理範例。
如需執行器設定與連線需求,請參閱自行託管的沙盒。
選擇佈建模式:
- 應用程式管理: 依照本指南,透過你的應用程式啟動與停止沙盒。
- Webhook 管理: 部署處理常式,在收到 OpenAI webhook 時啟動沙盒或重新連線至沙盒。
如需比較這兩種模式,請參閱沙盒生命週期。
開始之前
使用具備沙盒存取權的 Vercel 專案。Vercel Sandbox 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 範例傳送輸入,並以串流方式接收結果。完成後,請刪除工作階段,並另行停止供應商端的沙盒。