Back to Lobehub

云沙箱

docs/usage/agent/sandbox.zh-CN.mdx

2.1.564.4 KB
Original Source

云沙箱

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

什么是云沙箱?

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

云沙箱能做什么

执行代码

助理在沙盒中运行 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>