更新时间:2026-09-07 GMT+08:00
沙箱概述
什么是沙箱
智能体沙箱为AI Agent提供安全隔离的执行环境,支持多种执行环境类型,满足不同Agent任务的运行需求。每个沙箱实例运行在独立的虚拟化环境中,拥有独立的文件系统、网络空间和进程环境,实例间完全隔离,防止恶意代码逃逸和横向攻击。
功能特性
- 安全隔离:每个沙箱实例运行在独立的虚拟化环境中,进程、文件系统、网络相互隔离,防止恶意代码逃逸和横向攻击。
- 多种沙箱类型:提供代码解释器沙箱及自定义沙箱,适配不同Agent任务场景。
- 弹性伸缩:Serverless架构,按需创建和释放,支持快速启动和大规模并发。
- 灵活网络配置:支持VPC模式和公网模式,VPC模式可访问私有网络资源,公网模式开箱即用访问公网服务。
- 持久化存储:支持外挂对象存储和文件存储,数据独立于实例生命周期,多实例可共享存储。
- 可观测性:提供实例运行状态监控和操作日志,支持全链路操作追踪。
核心概念
沙箱模板与沙箱实例
使用沙箱时,您必须要了解模板和实例两个概念:
- 沙箱模板:可复用的沙箱环境参数配置,避免每次创建沙箱时重复配置,包含镜像、资源规格、网络配置、存储挂载、环境变量等参数。系统提供内置模板,也支持创建自定义模板。
- 沙箱实例:基于模板创建的运行态沙箱,是实际执行任务的环境。
一个模板可以创建多个实例,两者的关系如下图所示:
图1 沙箱模板与沙箱实例的关系
API Key
API Key是调用AgentSphere API和SDK的认证凭证。用户通过API Key鉴权后,才能创建、连接和管理沙箱实例。API Key用于外部调用鉴权,不注入实例内部。一个API Key可操作多个实例,一个实例也可被多个API Key操作(取决于权限配置)。
图2 API Key与沙箱实例的关系