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