使用 Databricks 沙盒,您可以在 Databricks 工作空间中运行智能体的 shell 命令并处理文件。您的应用程序负责管理沙盒。沙盒中的执行器 codex exec-server 使用会话的 environment.id 和 environment.remote_url 向 OpenAI 发起出站连接。
Databricks 沙盒目前处于 Beta 测试阶段。请先确认您的工作空间位于受支持的区域,然后在工作空间的“预览功能”页面启用 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.。最后,示例会停止执行器并删除会话和沙盒。