• 简体中文
  • 沙箱

    沙箱为智能体提供隔离的工作空间,用于安全地执行代码、管理文件和运行应用程序。

    Warning

    未绑定 Project 的对话不具备沙箱、命令或文件系统执行权限,SciLaxy 也不会隐式创建云端沙箱作为回退。请先绑定具备可用执行目标的 Project,再使用本页描述的能力。

    概述

    沙箱是按对话隔离的执行环境。当智能体需要执行代码时,任务会交给当前 Project 绑定的执行目标。

    每个沙箱包含:

    • 完整的 Linux 环境
    • 预装的 Python、Node.js 和常用工具
    • 独立的文件系统
    • 网络访问能力

    代码执行

    智能体使用 code_execute 工具在沙箱中运行 Python 代码:

    # 智能体可以执行任意 Python 代码
    import pandas as pd
    import matplotlib.pyplot as plt
    
    df = pd.read_csv('data.csv')
    df.plot(kind='bar')
    plt.savefig('chart.png')

    执行结果(包括输出、图表和文件)会自动返回给智能体和用户。

    文件操作

    沙箱支持完整的文件操作:

    • 读取 — 读取沙箱中的文件内容
    • 写入 — 创建和修改文件
    • 上传 — 将用户上传的文件传输到沙箱
    • 下载 — 从沙箱下载文件

    IDE 预览

    沙箱提供一个 Web IDE 界面,让你可以:

    • 浏览沙箱的文件系统
    • 实时查看和编辑文件
    • 预览生成的网页和应用
    • 查看终端输出

    IDE 预览会在智能体使用沙箱时自动显示在聊天界面的侧边面板中。

    可用性与生命周期

    沙箱能力跟随当前 Project 选择的执行目标。只有该目标在线且运行环境就绪时,相关工具才可用。目标不可用时,SciLaxy 会明确显示中断原因和恢复方式,不会静默切换到其他设备或云端执行。

    Info

    沙箱状态以 SciLaxy 界面显示的生命周期为准。结束执行会话前,请将需要长期保留的产物保存到绑定的 Project,或作为附件加入对话。