模板市场

更新时间:
复制 MD 格式

Agent Sandbox 模板市场提供预置的沙箱运行环境,覆盖命令执行、代码解释、浏览器自动化、桌面操作和软件工程评测等场景。市场中的模板均已完成缓存加速,您可以按任务选择市场模板,在指定 Team 下创建沙箱模板,再使用该模板创建沙箱实例,减少自行准备运行环境的工作。

模板市场、沙箱模板与沙箱实例

概念

说明

模板市场

浏览和选择预置运行环境的入口。

沙箱模板

在指定 Team 下创建的环境配置,用于创建沙箱实例。

沙箱实例

基于沙箱模板启动的运行环境,用于执行代码、操作浏览器或完成其他任务。

单击市场模板上的使用此模板,创建的是沙箱模板。执行任务前,还需要基于该模板创建沙箱实例。

选择适合的模板

在模板市场页面,您可以通过 All-in-One、Base、Code、SWE、Browser、Computer 和其它分类筛选模板,也可以选择全部浏览模板列表。

模板

分类

主要能力

适用场景

Base Runtime

Base

提供基础沙箱运行环境,支持命令执行、文件读写和生命周期管理。

运行命令行工具、处理文件,以及准备通用任务环境。

Code Interpreter

Code

提供代码执行环境,支持通过 run_code 运行 Python、JavaScript,并在连续调用中保留变量。

数据分析、计算、代码验证和文件处理。

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入口创建。

创建沙箱模板

步骤一:进入模板市场

  1. 在控制台顶部选择目标地域。

  2. 在左侧导航栏单击模板市场。

  3. 按分类浏览模板,并单击目标模板的查看详情了解其能力。

步骤二:使用市场模板

在目标模板卡片上单击使用此模板,填写以下信息。

参数

是否必填

说明

模板名称

是

为即将创建的沙箱模板设置名称。名称以字母或数字开头,支持字母、数字、连字符(-)和下划线(_),长度为 1~36 个字符。例如 my-code-sandbox。

Team

是

选择该沙箱模板所属的 Team。没有可用 Team 时,单击创建 Team,完成后再选择。

步骤三:提交创建并查看结果

  1. 确认模板名称、Team。

  2. 单击创建,根据页面提示查看创建结果。

  3. 进入左侧导航栏的极速版 > 沙箱模板,选择对应 Team,查找刚创建的模板并检查其状态。

  4. 模板就绪后,使用该模板创建沙箱实例,开展代码执行、浏览器操作等任务。

例如,需要运行 Python 数据分析任务时,可以选择 Code Interpreter,将模板命名为 my-code-sandbox,选择目标 Team 和可用运行时,然后单击创建。模板就绪后,再基于该模板创建沙箱实例。

常见问题

使用市场模板后,是否已经有可运行的沙箱实例?

尚未。模板市场的创建流程用于创建沙箱模板。模板就绪后,还需要基于该模板创建沙箱实例。

browser 和 Desktop 如何选择?

如果通过 Playwright、Puppeteer 等工具控制网页,选择 browser。如果需要通过截图、鼠标和键盘操作桌面或桌面应用,选择 Desktop。

Code Interpreter 和 All-in-One 如何选择?

如果任务主要是执行代码和处理数据,选择 Code Interpreter。如果需要在同一沙箱中操作浏览器并执行代码,选择 All-in-One。

创建后找不到模板怎么办?

检查控制台当前地域和 Team 是否与创建时一致,再确认创建操作是否成功。如果页面显示创建失败,请根据错误提示处理后重试。

使用市场模板是否需要自行构建镜像?

使用市场中已有的预置模板时,您可以直接通过控制台完成创建,无需先自行构建和推送镜像。