OpenAI Cookbook では、アプリケーション管理型とWebhook 管理型の実装例を確認できます。
エグゼキューターの設定手順と接続要件は、セルフホスト型サンドボックスを参照してください。
プロビジョニング方式を選びます。
- アプリケーション管理型： このガイドに沿って、アプリケーションからサンドボックスを起動・停止します。
- Webhook 管理型： OpenAI からの Webhook を受けて、サンドボックスを起動するか、既存のサンドボックスに再接続するハンドラーをデプロイします。
2 つの方式の違いは、サンドボックスのライフサイクルを参照してください。
事前準備
OpenAI プロジェクトの API キー、Modal のトークン ID とシークレット、Codex CLI パッケージが必要です。
アプリケーションからのリクエストには OPENAI_API_KEY を使用します。OPENAI_EXECUTOR_API_KEY には環境キーを設定し、そのキーだけを CODEX_API_KEY としてサンドボックスに渡します。
1. Modal 環境のセットアップ
セルフホスト型セッションを作成し、その環境 ID を保存します。Modal の SDK または API を使い、設定済みの作業ディレクトリを指定して、隔離されたサンドボックスを作成します。サンドボックスに Codex CLI をインストールしてから、その環境 ID と環境キーを使ってエグゼキューターを起動します。
2. セッションの実行
Modal のエグゼキューターが接続されたら、セッションの実行と継続にある HTTP の例に沿って入力を送信し、結果をストリーミングで受け取ります。作業が終わったら、セッションを削除し、それとは別に Modal のサンドボックスを停止します。
参考資料
- Modal のサンドボックスに関するドキュメントを参照してください。
- Modal Python SDK リファレンスを参照してください。
- Modal JavaScript/TypeScript SDK リファレンスを参照してください。