請參閱 OpenAI Cookbook 中的應用程式管理範例。
本指南採用 應用程式管理 的佈建方式：由你的應用程式啟動 Devbox、連接其執行器，並在完成後將 Devbox 關閉。生命週期的運作方式請參閱沙盒生命週期。
開始之前
使用 Runloop SDK 或 API 管理 Devbox，並透過 HTTP 請求管理 Agents API 工作階段。
設定 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 保持運作。每個工作階段只能由單一主體負責佈建；對於應用程式直接管理的工作階段，請勿附加佈建 webhook 處理常式。