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

Databricks 沙盒

在 Databricks 無伺服器沙盒中執行智慧體工具。

使用 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.。最後,範例會停止執行器,並刪除工作階段和沙盒。