OpenAI Cookbook のアプリケーション管理の例を参照してください。
このガイドでは、 アプリケーション管理 によるプロビジョニングを使用します。アプリケーションが Devbox を起動し、そのエグゼキューターを接続して、作業が完了したら Devbox をシャットダウンします。ライフサイクルの動作については、サンドボックスのライフサイクルを参照してください。
事前準備
Devbox の管理には Runloop SDK または API を使用し、Agents API セッションの管理には HTTP リクエストを使用します。
RUNLOOP_API_KEY を設定し、アプリケーションからのリクエストには OPENAI_API_KEY を使用します。OPENAI_EXECUTOR_API_KEY に環境キーを設定し、そのキーのみを CODEX_API_KEY として Devbox に渡します。
アプリケーション管理
- セルフホスト型セッションを作成し、その環境 ID を保存します。
- セッションの作業ディレクトリを持つ Runloop Devbox を作成し、その中に Codex CLI をインストールします。
- 環境 ID と環境キーを使用して、バックグラウンドでエグゼキューターを起動します。
- 入力を送信し、結果を確認します。ファイルを扱うタスクでは、ワークスペースに
brief.txtを作成し、移行計画をplan.mdに書き込むようエージェントに依頼します。 - ターンの完了を確認して必要なファイルを取得し、Devbox をシャットダウンしてセッションを削除します。
セットアップと実行には有限のタイムアウトを設定し、アプリケーションが予期せず終了した場合に備えて Devbox の存続時間にも上限を設けます。追加のターンが必要な場合は、セッションと Devbox を稼働させたままにします。セッションごとにプロビジョニングの管理主体を 1 つに限定し、アプリケーションが直接管理するセッションにはプロビジョニング用の Webhook ハンドラーを関連付けないでください。