Sandbox Tool 类型决定 Instance 的运行环境形态和默认能力。选择正确的类型后，基于该 Tool 启动的 Instance 会继承对应的环境配置、预置能力和适用边界。
选型建议
下表按典型任务场景给出选型建议。
任务场景 | 推荐类型 | 默认能力 | 不适用场景 |
浏览器访问、网页自动化、页面交互 | browser | 预置浏览器运行环境 | 非 Web 场景，例如本地 GUI 或原生应用 |
脚本执行、代码运行、临时计算 | code-interpreter | 预置代码解释器 | 需要持久化服务或自定义依赖栈 |
移动端设备操作、移动端自动化 | mobile | 预置 Mobile 运行环境和 ADB 能力 | 桌面浏览器或服务器端任务 |
桌面级交互、OS 环境操作 | osworld | 预置桌面操作系统环境 | 纯命令行或 Headless 任务 |
自定义镜像、自定义启动命令、自定义端口 | custom | 由镜像和配置决定 | 希望开箱即用、无需维护镜像的场景 |
如果任务属于浏览器访问、代码执行、移动端或桌面交互场景，优先选择对应预置类型。仅当预置类型无法满足镜像、启动命令、端口、资源规格或探针配置要求时，再使用
custom。预置类型详解
browser
browser 用于浏览器访问、网页自动化和页面交互场景。基于该类型创建的 Instance 提供预置浏览器运行环境，适合执行页面导航、元素操作、页面截图和 Web 任务验证。适用边界：
browser 主要覆盖浏览器类 Web 场景，不适合原生应用、本地 GUI 或非浏览器桌面交互任务。code-interpreter
code-interpreter 用于脚本执行、代码运行和临时计算场景。它适合快速执行脚本、验证代码片段或完成一次性计算任务，无需先准备自定义镜像。适用边界：
code-interpreter 以预置代码解释器环境为主。如果任务依赖额外系统组件、自定义服务进程或复杂运行时，建议使用 custom。mobile
mobile 用于移动端设备操作和移动端自动化场景。基于该类型创建的 Instance 提供预置 Mobile 运行环境，支持 ADB 连接和设备控制。适用边界：
mobile 主要覆盖移动端场景，不适合桌面浏览器、服务器端任务或纯命令行任务。说明：
Instance 启动后的 ADB 操作请参见 Mobile 沙箱（ADB）。
osworld
osworld 用于桌面级交互和 OS 环境操作场景。基于该类型创建的 Instance 提供预置桌面操作系统环境，适合需要图形界面交互的任务。适用边界：
osworld 以桌面交互为主。纯命令行、脚本执行或 Headless 任务通常优先选择 code-interpreter 或 custom。自定义类型（custom）
当预置类型无法满足镜像、启动命令、端口或资源规格等需求时，可以使用
custom 类型创建自定义容器 Tool。创建时您需要自行指定镜像、启动命令、端口、资源规格和探针配置。与预置类型相比，
custom 的核心区别是：预置类型由平台提供默认镜像和环境，创建时通常只需指定类型名称。
custom 类型由用户提供镜像和运行配置，适合需要自定义依赖、服务进程或端口暴露的场景。入口命名差异
不同入口对同一类型的命名方式不同。下表中的 Cloud API 一列对应当前公开 Cloud API 的请求和返回写法；CLI 一列对应
agr tool create --tool-type 的参数写法；文档对照短名用于帮助您在说明文档中快速识别同一类型。类型 | Cloud API 请求/返回值 | CLI 创建参数值 | 文档对照短名 |
浏览器型 | browser | browser | browser |
代码执行型 | code-interpreter | code-interpreter | code-interpreter |
移动端 | mobile | mobile | mobile |
桌面交互型 | osworld | osworld | osworld |
自定义 | custom | custom | custom |
说明：
以
custom 为例：Cloud API 的 CreateSandboxTool.ToolType 请求字段和 DescribeSandboxToolList 返回对象中的 ToolType 字段都使用 SANDBOX_TOOL_TYPE_COMPUTER；agr tool create --tool-type 使用 custom。两者指向同一类型，但不能混写。相关操作
创建沙箱工具：按选型结果创建 Tool。
查询沙箱工具：查看已有 Tool 列表与详情。
网络模式：配置 Tool 的网络访问方式。
存储挂载：配置 Tool 的数据持久化方式。
