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.。结束时停止执行器,并删除示例创建的会话及沙箱。
以上内容是否对您有帮助:

TRAE-AI编程


更多建议: