OpenAI Databricks 沙箱

2026-11-20 11:20 更新

Databricks Sandbox 让智能体在 Databricks 工作区执行 Shell 命令并读写文件。应用负责管理沙箱。执行器 codex exec-server 使用会话返回的 environment.id 和 environment.remote_url 主动连接 OpenAI。

Databricks Sandbox 处于测试阶段。确认工作区位于受支持的区域,然后在工作区的 Previews 页面启用 Databricks Sandbox。

开始前

  • 配置并登录目标工作区的 Databricks CLI 配置。将下例中的 my-workspace 替换为配置名称。
  • 将应用密钥存入 OPENAI_API_KEY,另将环境密钥(见自托管沙箱的认证小节)存入 OPENAI_EXECUTOR_API_KEY。两把密钥须属于同一组织、项目及用户或服务账户。沙箱只接收环境密钥,变量名为 CODEX_API_KEY。
  • 如果 OpenAI 组织设置了 IP 允许列表,沙箱出口 IP 变化时须更新列表。对于参与 Serverless Compute Firewall 预览的工作区,请参阅 Databricks 出站 IP 范围说明。

运行示例

从 OpenAI Cookbook 仓库根目录运行,环境需要 uv 和 Python 3.11 或更高版本。请使用尚未占用的沙箱 ID,示例会在清理时删除该沙箱。

## 使用工作区配置运行示例,并用当前时间生成新的沙箱 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.。结束时停止执行器,并删除示例创建的会话及沙箱。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号