---
title: 云沙箱
description: 助理在安全云端环境中执行代码、处理文件——运行 Python/JS、生成文档、创建图表。真实执行，不只是代码片段。
tags:
  - LobeHub
  - 云沙箱
  - 代码执行
  - 文件生成
  - 数据处理
---

# 云沙箱

云沙箱让助理在安全隔离的云端环境中运行代码、处理文件。不只是给出代码建议，助理会直接执行 —— 返回真实输出、可下载的文档和图表，供你实时迭代。从数据分析到报告生成，从代码调试到文件转换，云沙箱让助理成为真正的执行伙伴。

## 什么是云沙箱？

一个安全隔离的云端执行环境。当你需要实际运行结果 —— 而不只是代码片段 —— 助理会在云沙箱中执行代码并返回输出。你的本地电脑不受影响，所有执行都在云端完成。

## 云沙箱能做什么

### 执行代码

助理在沙盒中运行 Python、JavaScript、TypeScript，返回真实的运行输出 —— 而不只是代码文本。常用库（如 Python 的 pandas、matplotlib，JavaScript 的 lodash）已预置。助理可按需安装其他依赖包。

### 生成文件

助理可以创建 PDF、Excel、Word、图片、图表等各类文件，并提供下载链接。直接下载，即可用于你的工作流。

### 数据处理

助理可以读取、分析、转换数据文件。上传 CSV、JSON 等格式，助理能帮你清洗、统计、可视化并导出结果。

### 运行命令

助理可以执行 Shell 命令，安装依赖、处理文件、执行复杂操作。适合需要结合脚本和系统工具的多步骤工作流。

## 启用云沙箱

云沙箱是内置技能。使用前需为助理启用。

**从助理档案** — 进入助理档案页面，点击 **+ 添加技能 **，勾选**云沙箱**。

**在会话中** — 点击对话框下方的技能图标，勾选**云沙箱**。

## 使用云沙箱

### 让助理执行代码

描述任务，助理会编写代码并在云沙箱中运行：

- 「帮我写个 Python 脚本，计算这组数据的平均值和标准差」
- 「用 JavaScript 实现快速排序算法，运行测试一下」
- 「帮我跑一下这段代码，看看输出是什么」
- 「用 pandas 分析这个 CSV，按收入排序显示前 5 行」

### 让助理生成文档

描述你需要的文档内容，助理会生成并提供下载：

- 「帮我生成一份 PDF 报告，包含这些数据的分析结果」
- 「把这段内容做成 Word 文档」
- 「创建一个 Excel 表格，整理这些信息」
- 「用这份销售数据做个柱状图，导出成 PNG」

### 让助理处理数据

提供数据或文件，助理会处理并返回结果：

- 「分析这份销售数据，画个趋势图」
- 「把这个 JSON 转换成 CSV 格式」
- 「帮我清洗这份数据，去除重复项」
- 「把这两个 CSV 按 id 列合并」

## 使用场景

**数据分析** — 上传数据集，要求汇总统计、可视化或趋势分析。获得可直接用于报告或演示的图表和表格。

**报告自动化** — 从结构化数据生成周报、发票或摘要。助理产出可直接发送的 PDF 或 Excel 文件。

**代码原型** — 在对话中测试算法、验证逻辑或调试代码片段。看到真实输出，而不是猜测。

**文件转换** — 在格式间转换（JSON ↔ CSV、Markdown → PDF）或批量处理文件。无需自己写一次性脚本。

## 了解云沙箱环境

**隔离执行** — 云沙箱运行在安全隔离的云端服务器上，与你的本地电脑完全分离。助理在沙箱中的所有操作都不会影响你的本地文件系统。

**会话级存储** — 云沙箱中的文件是临时的，与当前对话会话绑定。会话结束或长时间不活动后，沙箱中的文件可能会被清理。如需保留文件，请及时通过助理提供的下载链接保存。

**自动导出** — 助理在云沙箱中生成文件时，会自动导出并提供下载链接。无需额外操作，即可获得代码运行产生的文档、图表、数据文件等成果。

## 使用技巧

- **明确格式** — 「导出为 CSV」或「保存为 PDF」有助于助理选择正确的输出格式。
- **在同一对话中迭代** — 「把图表改成蓝色」或「给报告加个标题」—— 助理有上下文，可以精调输出。
- **及时下载重要文件** — 会话级存储意味着文件可能不会永久保留。在对话活跃时保存你需要的文件。

<Cards>
  <Card href={'/zh/docs/usage/agent/artifacts'} title={'Artifacts'} />

  <Card href={'/zh/docs/usage/getting-started/resource'} title={'资源库'} />

  <Card href={'/zh/docs/usage/agent/scheduled-task'} title={'定时任务'} />
</Cards>
