Agent Sandbox 模板市场提供预置的沙箱运行环境,覆盖命令执行、代码解释、浏览器自动化、桌面操作和软件工程评测等场景。市场中的模板均已完成缓存加速,您可以按任务选择市场模板,在指定 Team 下创建沙箱模板,再使用该模板创建沙箱实例,减少自行准备运行环境的工作。
模板市场、沙箱模板与沙箱实例
概念 | 说明 |
模板市场 | 浏览和选择预置运行环境的入口。 |
沙箱模板 | 在指定 Team 下创建的环境配置,用于创建沙箱实例。 |
沙箱实例 | 基于沙箱模板启动的运行环境,用于执行代码、操作浏览器或完成其他任务。 |
单击市场模板上的使用此模板,创建的是沙箱模板。执行任务前,还需要基于该模板创建沙箱实例。
选择适合的模板
在模板市场页面,您可以通过 All-in-One、Base、Code、SWE、Browser、Computer 和其它分类筛选模板,也可以选择全部浏览模板列表。
模板 | 分类 | 主要能力 | 适用场景 |
Base Runtime | Base | 提供基础沙箱运行环境,支持命令执行、文件读写和生命周期管理。 | 运行命令行工具、处理文件,以及准备通用任务环境。 |
Code Interpreter | Code | 提供代码执行环境,支持通过 | 数据分析、计算、代码验证和文件处理。 |
browser | Browser | 提供云端 Chromium 浏览器,支持通过 CDP over WebSocket 远程控制,并兼容 Puppeteer、Playwright。 | 网页访问、页面交互、浏览器自动化和网页测试。 |
All-in-One | All-in-One | 在同一沙箱中组合浏览器与 Code Interpreter 能力。 | 访问网页后处理数据、执行代码,或完成需要多种工具协作的任务。 |
Desktop | Computer | 提供 Linux 桌面环境,包含窗口管理器、终端、文件管理器和 Chrome,支持通过截图感知界面并执行鼠标、键盘操作。 | 桌面应用操作、图形界面自动化和 Computer Use 任务。 |
SWE-bench Verified | SWE | 提供 SWE-bench Verified 评测环境,包含 500 个实例对应的镜像,可按镜像 key 区分。 | 软件工程智能体的代码修复与评测。 |
如果任务只需要执行命令或读写文件,可以选择 Base Runtime;需要代码解释能力时,选择 Code Interpreter;需要同时操作网页和执行代码时,选择 All-in-One。
浏览器自动化通常选择 browser。需要操作整个桌面或桌面应用时,选择 Desktop。
模板列表会随产品更新。具体能力及可用配置,请在目标模板卡片上单击查看详情确认。
操作前准备
登录 Agent Sandbox 控制台,选择准备使用的地域。
准备一个用于创建沙箱模板的 Team。创建模板时可以选择已有 Team;如果没有可用 Team,可以通过弹窗中的创建 Team入口创建。
创建沙箱模板
步骤一:进入模板市场
在控制台顶部选择目标地域。
在左侧导航栏单击模板市场。
按分类浏览模板,并单击目标模板的查看详情了解其能力。
步骤二:使用市场模板
在目标模板卡片上单击使用此模板,填写以下信息。
参数 | 是否必填 | 说明 |
模板名称 | 是 | 为即将创建的沙箱模板设置名称。名称以字母或数字开头,支持字母、数字、连字符( |
Team | 是 | 选择该沙箱模板所属的 Team。没有可用 Team 时,单击创建 Team,完成后再选择。 |
步骤三:提交创建并查看结果
确认模板名称、Team。
单击创建,根据页面提示查看创建结果。
进入左侧导航栏的极速版 > 沙箱模板,选择对应 Team,查找刚创建的模板并检查其状态。
模板就绪后,使用该模板创建沙箱实例,开展代码执行、浏览器操作等任务。
例如,需要运行 Python 数据分析任务时,可以选择 Code Interpreter,将模板命名为 my-code-sandbox,选择目标 Team 和可用运行时,然后单击创建。模板就绪后,再基于该模板创建沙箱实例。
常见问题
使用市场模板后,是否已经有可运行的沙箱实例?
尚未。模板市场的创建流程用于创建沙箱模板。模板就绪后,还需要基于该模板创建沙箱实例。
browser 和 Desktop 如何选择?
如果通过 Playwright、Puppeteer 等工具控制网页,选择 browser。如果需要通过截图、鼠标和键盘操作桌面或桌面应用,选择 Desktop。
Code Interpreter 和 All-in-One 如何选择?
如果任务主要是执行代码和处理数据,选择 Code Interpreter。如果需要在同一沙箱中操作浏览器并执行代码,选择 All-in-One。
创建后找不到模板怎么办?
检查控制台当前地域和 Team 是否与创建时一致,再确认创建操作是否成功。如果页面显示创建失败,请根据错误提示处理后重试。
使用市场模板是否需要自行构建镜像?
使用市场中已有的预置模板时,您可以直接通过控制台完成创建,无需先自行构建和推送镜像。