如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

Daytona

在 Daytona 沙盒中執行 Agents API 工作階段。

請參閱 OpenAI Cookbook 中由應用程式管理和透過 webhook 管理沙盒的範例。

如需瞭解執行器的設定方式與連線需求,請參閱自架沙盒。

選擇沙盒的佈建模式:

如需比較這兩種模式,請參閱沙盒生命週期。

透過 webhook 管理

使用控制器驗證收到的 OpenAI webhook 請求,並將佈建工作加入佇列。控制器應與工作節點的沙盒分開部署,各工作階段的執行器會在工作節點的沙盒中執行。依照部署並連接處理常式的步驟註冊端點與簽章金鑰。

收到 environment_connection 請求時,啟動工作節點或重新連線至該節點。工作階段失敗時,請釋放該節點。請明確設定工作節點和控制器各自的逾時時間。若要在閒置時停止運算資源,必須透過策略協調停止資源與接收新工作的時機。詳情請參閱生命週期行為。

由應用程式管理

開始之前

請先備妥 OpenAI 專案 API 金鑰、Daytona API 金鑰及 Codex CLI 套件。

設定 DAYTONA_API_KEY,並使用 OPENAI_API_KEY 傳送應用程式的請求。將 OPENAI_EXECUTOR_API_KEY 設為環境金鑰。只將這把金鑰傳入沙盒,作為 CODEX_API_KEY 的值。

1. 設定 Daytona 環境

建立自架工作階段並儲存其環境 ID。使用 Daytona SDK 或 API 建立隔離的沙盒,讓沙盒使用已設定的工作目錄。在沙盒中安裝 Codex CLI,再使用該環境 ID 和環境金鑰啟動沙盒的執行器。

執行器會主動連線至 OpenAI,並長時間維持連線,但 Daytona 在判斷沙盒是否閒置時不會偵測到這條連線。請設定 auto_stop_interval=0,以免沙盒在智慧體工作期間停止。另請設定沙盒的存續時間上限,以免執行中斷後,運算資源仍無限期運作。

若經常使用沙盒,請將 Codex 和 ripgrep 納入 Daytona 快照,讓沙盒能更快建立連線。

2. 執行工作階段

Daytona 執行器建立連線後,依照執行及繼續工作階段中的 HTTP 範例傳送輸入,並以串流方式接收結果。完成後,請刪除工作階段,並另外停止供應商的沙盒。

請先啟動沙盒,再提交輸入。回合會等待環境建立連線。連線建立後,工作階段會透過事件串流中的 agent.session.environment.connected 回報連線成功。

請以 agent.session.turn.completed 判斷回合是否成功完成。回合失敗或取消後,也可能出現 agent.session.idle,因此不能僅憑工作階段閒置就判定回合成功。若在事件發生後立即查詢工作階段,短時間內仍可能取得先前的狀態。

參考資料