Sandbox 运行时配置
本文说明 DB-GPT 应用侧 Python 和 Shell Agent 工具使用的运行时选择方式。主 Agent 和子 Agent 共用以下执行入口:
- packages/dbgpt-app/src/dbgpt_app/openapi/api_v1/tools/_execution.py
- packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/execution_layer/runtime_factory.py
运行时选择规则
运行时选择顺序如下:
- 调用方显式传入的运行时参数。
- SANDBOX_RUNTIME 环境变量。
- 默认使用 LocalRuntime。
| 配置 | 使用的运行时 |
|---|---|
| 未设置、空值或 local | LocalRuntime |
| SANDBOX_RUNTIME=docker 且 Docker 可连接 | DockerRuntime |
| SANDBOX_RUNTIME=podman 且 Podman 可用 | PodmanRuntime |
| SANDBOX_RUNTIME=nerdctl 且 Nerdctl 可用 | NerdctlRuntime |
| 配置的容器运行时或会话无法初始化 | 报错,不在本地执行 |
| 未知的运行时名称 | 配置错误 |
即使机器已经安装 Docker,也不会自动启用 Docker。Docker 是显式选择的:
export SANDBOX_RUNTIME=docker
如果不设置这个环境变量,DB-GPT 使用当前应用环境执行,不需要 Docker 镜像。
LocalRuntime 是默认值,不是故障兜底。显式选择 docker、podman 或 nerdctl 后, 必须使用指定的后端。初始化、镜像拉取、容器创建或输入文件传输失败时,直接返回 错误,不 会在宿主机上执行代码。该策略不需要额外的配置开关。
LocalRuntime
LocalRuntime 是默认运行时,目的是保证 DB-GPT 启动后即可执行 Agent 工具。
本地模式下:
- Python 使用 DB-GPT 应用当前的 Python 解释器。
- 可以直接使用当前应用环境中已安装的 pandas、numpy 等依赖。
- Shell 命令在服务所在主机执行。
- 不需要 Docker 镜像。
- 本地模式不提供容器隔离,部署时应结合操作系统权限和网络策略进行控制。
也可以显式选择本地模式:
export SANDBOX_RUNTIME=local