文档中心

AgentKit

沙箱模板

沙箱模板概述

沙箱是 AgentKit 工具体系中最常用的一类运行环境工具，Agentkit 沙箱模板提供了多种智能体在执行任务中需要的运行环境，支持快速集成与便捷调用。本篇文档将详细为您介绍沙箱是什么、典型场景是什么、适用边界在哪里、基本原理是什么，帮助您快速了解沙箱模板，并知道下一步从哪里开始上手。

什么是沙箱模板

你可以把沙箱模板理解为：给 Agent 临时借用的一台“隔离小机器”。它更适合需要在隔离环境里运行代码、执行命令或做浏览器类操作的任务，而不是让 Agent 长期保存状态或一直跑不停。

基本原理

沙箱模板以 microVM 为基础提供安全、隔离的运行环境，并由 AgentKit 提供工具与实例的生命周期管理能力。实例支持在会话期间保留上下文（例如内存中的上下文、文件系统状态等），并在生命周期到期后自动回收或按需手动回收。与身份与权限服务融合，通过 API Key 等方式完成入站身份校验。

核心概念

概念	说明
工具（Tool）	在 AgentKit 中，工具指 Agent 在执行任务过程中可调用的“外部能力”。它通常提供一个可被模型调用的接口，并在背后承载某种运行环境或外部服务。
沙箱模板（Sandbox）	沙箱模板是一类“运行环境工具”，提供隔离的执行环境，用于运行代码、执行命令或完成浏览器类任务。它的目标是让 Agent 在需要时“借用环境完成任务”，而不是把环境长期当作服务运行。
工具实例（Tool Instance）	工具实例是沙箱工具的运行载体，可理解为“一次会话期间持续可用的沙箱环境”。实例有生命周期：支持设置生命周期时长自动回收或手动回收，最长可运行 24 小时。
会话标识（session_id）	在代码示例中，通常通过 session_id 将多次工具调用串成一次连贯会话；首次使用某个 session_id 时会创建工具实例。默认生命周期为 30 分钟（以官方示例为准），可按需调整。
入站身份认证（API Key）	沙箱工具与身份与权限服务联动时，可以选择使用 API Key 完成入站身份校验，用于保护工具调用链路的数据安全。

使用场景

说明

沙箱模板的“状态”以实例为载体管理，实例可以自动回收；会话期间上下文在内存中，结束后不再保留。

更推荐用沙箱模板的情况	不推荐用沙箱模板的情况
需要隔离运行环境。需要由 Agent 在执行过程中按需调用运行能力。希望对实例生命周期有可控的回收机制。希望把“运行环境复杂度”从业务宿主环境中剥离出去。	任务本质上是一次简单的 API 调用/信息检索，不需要运行环境。需要长期保存进程状态、长期驻留服务（沙箱实例有生命周期上限）。希望把数据长期保存在本地盘且不做持久化存储（会话结束后不保留）。

优势说明

指标说明

指标项	指标值	指标说明
冷启动耗时	100 ms	实例冷启动耗时。
大规模创建吞吐	最高 12w Sandbox / 分钟	面向 AgentRL 等高并发场景的大规模弹性创建能力。
休眠唤醒时延	典型场景 1s–10s	保持文件系统状态后快速恢复运行。

费用与安全提示

费用：如果您为沙箱模板配置了对象存储 TOS 挂载点、开通并接入全栈可观测平台查看日志、或在沙箱中触发模型调用等能力，都可能产生对应产品的费用。建议在“刚上手”阶段先用最小配置跑通流程，后续再按需打开这些能力。

数据安全侧：建议优先使用平台提供的身份鉴权能力（例如入站 API Key），避免把敏感密钥硬编码进代码仓库。若必须通过环境变量配置 AK/SK，请确保只在可信环境中配置，并做好权限最小化。

使用流程说明

在Agent中集成沙箱模板（以 VeADK 为例）：将沙箱模板集成至您的 Agent 代码中，以使得 Agent 可以调用一个隔离环境完成代码运行、浏览器等复杂任务。

最近更新时间：2026.08.10 15:39:41

这个页面对您有帮助吗？

有用

无用