# 开始使用沙箱
本文主要介绍AgentSphere沙箱的整体使用流程，帮助您了解从准备到运行任务的各环节及其关系，助您快速上手。
#### 使用流程总览
使用沙箱大致可分为三个阶段：准备、运行、清理。
图1使用流程总览   
![](https://support.huaweicloud.com/usermanual-agentsphere/zh-cn_image_0000002673947536.png "点击放大")
#### 准备阶段
- 准备沙箱模板：选择代码解释器模板或创建自定义模板，模板定义了实例的镜像、资源规格、网络配置等，是创建实例的前提。详情请参见[沙箱模板概述](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0005.html)。
  沙箱模板可以分为两大类：
  - 代码解释器模板：预装了Jupyter的运行环境，适合快速验证运行代码，无需额外配置，可直接使用。
  
  - 自建模板：基于自定义镜像进行创建，适合特殊资源规格和特定网络配置的场景。
   
- 获取API Key：创建用于调用API和SDK的认证凭证，所有创建、连接、管理沙箱实例的操作都需要通过API Key鉴权。详情请参见[API Key概述](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0018.html)。
 
#### 运行阶段
准备阶段就绪后，即可进入运行阶段：
1. **创建沙箱实例**
   基于模板创建实例，实例将继承模板中定义的镜像、资源规格、网络配置等。创建时可覆盖模板的部分配置（如环境变量等），无需为临时调整而修改模板。详情请参见[创建沙箱实例](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0013.html)。
   实例创建后自动进入运行状态，即可接受任务执行。
   
2. **连接实例并执行任务**
   调用API Key通过API/SDK方式连接沙箱实例，并在沙箱中执行任务，例如执行代码、Shell命令等。
   
3. **监控与日志**
   任务执行过程中，可随时查看实例的运行状态和资源使用情况，追踪操作记录，用于问题排查和性能分析。详情请参见[监控与日志](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0015.html)。
   
 
#### 清理阶段
任务完成后，删除沙箱实例以释放资源。详情请参见[删除沙箱实例](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0016.html)。
如果沙箱实例长时间处在闲置状态，在闲置时间超过超时时间（超时时间可在模板中配置）后，系统会自动释放或休眠。
![](https://support.huaweicloud.com/usermanual-agentsphere/public_sys-resources/caution_3.0-zh-cn.png)
删除操作不可逆，实例内置文件系统中的数据将被清除。如需保留数据，请在删除前导出或使用外挂存储。
#### 相关文档
您可能需要了解的下一步操作：
- 了解创建沙箱模板的详细配置，请参见[创建沙箱模板](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0006.html)。
- 了解创建沙箱实例的详细配置，请参见[创建沙箱实例](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0013.html)。
- 了解创建API Key的详细操作，请参见[创建API Key](https://support.huaweicloud.com/usermanual-agentsphere/agentsphere_03_0019.html)。