使用 Databricks 沙盒,即可在 Databricks 工作區中執行智慧體的 shell 指令並處理檔案。沙盒由你的應用程式管理。沙盒中的執行器 codex exec-server 會使用工作階段的 environment.id 和 environment.remote_url,主動向 OpenAI 建立連線。
Databricks 沙盒目前處於 Beta 測試階段。請先確認工作區位於支援的區域,再到工作區的「Previews」頁面啟用 Databricks 沙盒。
開始前的準備
- 為工作區的 Databricks 設定檔完成身分驗證,再將下方指令中的
my-workspace替換成該設定檔的名稱。 - 將
OPENAI_API_KEY設為應用程式金鑰,並將OPENAI_EXECUTOR_API_KEY設為另一把環境金鑰。兩把金鑰必須屬於同一個組織、同一個專案,以及同一個使用者帳戶或服務帳戶。只有環境金鑰會以CODEX_API_KEY的形式傳入沙盒。 - 如果你的 OpenAI 組織強制使用 IP 允許清單,請在沙盒的對外連線 IP 位址變更時更新清單。如果工作區已啟用無伺服器運算防火牆預覽功能,請遵循 Databricks 的各區域 IP 範圍指引。
執行範例
在 OpenAI Cookbook 程式碼庫的根目錄中,使用 uv 和 Python 3.11 或更新版本執行範例。請選擇尚未使用的沙盒 ID,因為範例會在清理時刪除沙盒。
uv run examples/agents_api/sandboxes/databricks/application_managed/main.py \
--profile my-workspace --sandbox-id "openai-agent-$(date +%s)"
範例會建立自架的工作階段,在沙盒中啟動執行器,並要求智慧體將問候語寫入檔案。接著,範例會讀回檔案內容,驗證成功後便會印出 Verified the agent's file write.。最後,範例會停止執行器,並刪除工作階段和沙盒。