For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション

Modal

Modal Sandbox で Agents API セッションを実行します。

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 の例を使って、入力を送信し、結果をストリーミングで受信します。終了したら、セッションを削除し、それとは別にプロバイダーのサンドボックスを停止します。

参考資料