如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

Databricks 沙盒

在 Databricks 无服务器沙盒中运行智能体工具。

使用 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.。最后,示例会停止执行器并删除会话和沙盒。