OpenAI Cookbook のアプリケーション管理と Webhook 管理の例を参照してください。
エグゼキューターのセットアップと接続要件については、セルフホスト型サンドボックスを参照してください。
プロビジョニングモードを選択します。
- アプリケーション管理： このガイドに従って、アプリケーションからサンドボックスを起動・停止します。
- Webhook 管理： OpenAI の Webhook を受けてサンドボックスを起動または再接続するハンドラーをデプロイします。
2 つのモードの比較については、サンドボックスのライフサイクルを参照してください。
事前準備
Vercel Sandbox にアクセスできる 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 と環境キーを使ってエグゼキューターを起動します。
継続的に利用する場合は、サンドボックスがより早く接続できるよう、Vercel のスナップショットに Codex を含めてください。
2. セッションの実行
Vercel のエグゼキューターが接続したら、セッションの実行と継続にある HTTP の例を使って入力を送信し、結果をストリーミングで受信します。終了したら、セッションを削除し、それとは別にプロバイダーのサンドボックスを停止します。