# 概览

UCloud Sandbox 为您提供安全可靠的弹性沙箱计算服务。只需几秒钟，您就可以在云端获取和启用具备完整操作系统能力的沙箱，用于执行 AI Agent 生成的代码、进行自动化测试或运行不可信的脚本。

随着业务需求的变化，您可以实时扩展或缩减计算资源。UCloud Sandbox 支持按实际使用的资源计费，可以为您节约计算成本。

#### <center>[快速开始](/docs/agent-sandbox/product/00-quick-start.md)   |   [核心概念](/docs/agent-sandbox/coreConcept/02-concepts.md)   |   [CLI 指南](/docs/agent-sandbox/product/cli.md)   |   [常见问题](/docs/agent-sandbox/troubleshooting/00-overview.md)</center>

---

## 推荐学习路径

按「先跑起来 → 理解概念 → 深入能力」的顺序开始：

### 第一步：快速上手
1. [前置条件与认证](/docs/agent-sandbox/product/01-prerequisites.md) - 获取 API Key 并配置环境
2. [计费说明](/docs/agent-sandbox/product/fee.md) - 了解沙箱计费情况
3. [SDK 快速开始](/docs/agent-sandbox/product/00-quick-start.md) - 5 分钟创建第一个沙箱
4. [CLI 指南](/docs/agent-sandbox/product/cli.md) - 命令行工具入门
5. [切换地域](/docs/agent-sandbox/product/region.md) - 学习如何切换地域

### 第二步：理解核心概念
1. [概念速览](/docs/agent-sandbox/coreConcept/02-concepts.md) - 沙箱、模板、快照的关系
2. [产品架构](/docs/agent-sandbox/coreConcept/02-concepts.md) - 系统组件与数据流
3. [模板工作原理](/docs/agent-sandbox/coreConcept/02-how-it-works.md) - 快照机制详解

### 第三步：深入使用
1. [模板快速开始](/docs/agent-sandbox/template/01-quick-start.md) - 构建自定义模板
2. [命令执行](/docs/agent-sandbox/sdk/commands/01-overview.md) - 在沙箱中运行命令
3. [文件系统](/docs/agent-sandbox/sdk/filesystem/01-overview.md) - 文件读写与传输

---

## 核心能力

| 能力 | 说明 | 相关文档 |
|-----|------|---------|
| **代码执行** | 安全运行 Agent 生成的 Python、JavaScript 等代码 | [命令执行](/docs/agent-sandbox/sdk/commands/01-overview.md) |
| **多地域切换** | 支持在不同地域创建沙箱 | [切换地域](/docs/agent-sandbox/product/region.md) |
| **文件操作** | 在沙箱与宿主机之间传输文件 | [文件系统](/docs/agent-sandbox/sdk/filesystem/01-overview.md) |
| **自定义模板** | 预装依赖、预置文件、毫秒级启动 | [模板指南](/docs/agent-sandbox/template/01-quick-start.md) |
| **网络控制** | 灵活控制沙箱的互联网访问权限 | [网络访问](/docs/agent-sandbox/sdk/sandbox/10-internet-access.md) |
| **数据持久化** | 挂载远程存储桶 | [持久化](/docs/agent-sandbox/sdk/sandbox/04-persistence.md) |
| **E2B 兼容** | 使用现有 E2B SDK 无缝接入 | [E2B 兼容模式](/docs/agent-sandbox/product/e2b-compatibility.md) |

---

## 典型应用场景

- **AI Agent 代码执行**：安全运行 LLM 生成的代码，隔离风险
- **自动化测试**：在隔离环境中运行测试用例
- **数据分析**：提供预装分析工具的沙箱环境
- **教育培训**：为学员提供独立的实验环境

> [!NOTE]
> 更多示例请参阅 [示例库](/docs/agent-sandbox/template/12-examples.md)

---

## 常见问题

遇到问题？请查阅 [常见问题与排障](/docs/agent-sandbox/troubleshooting/00-overview.md)，涵盖：

- 认证与权限问题
- 模板构建卡住
- 命令执行超时
- 网络访问失败
- 限流与资源限制

---

## 快速链接

| 类别 | 链接 |
|-----|------|
| **入门** | [前置条件](/docs/agent-sandbox/product/01-prerequisites.md) · [SDK 快速开始](/docs/agent-sandbox/product/00-quick-start.md) · [CLI 指南](/docs/agent-sandbox/product/cli.md) |
| **概念** | [概念速览](/docs/agent-sandbox/coreConcept/02-concepts.md) · [产品架构](/docs/agent-sandbox/coreConcept/02-concepts.md) |
| **参考** | [词汇表](/docs/agent-sandbox/_glossary.md) · [常见问题](/docs/agent-sandbox/troubleshooting/00-overview.md) |