跳到主要内容

代码沙箱执行

需要算一算、处理数据、跑脚本时,智能体会在安全隔离的云端沙箱里执行代码——绝不在主进程 里运行用户代码。

工具作用
bash在沙箱里执行 shell 命令
sandbox_exec_shell在按会话自动创建的沙箱里执行 shell(首次调用自动建、后续复用)
sandbox_exec_python在沙箱里执行 Python(数据处理、计算、画图等)
read_file / write_file / list_dir / upload_file沙箱内文件读写与上传

用法示例

这是一份 CSV(已上传),帮我算每个品类的环比增长,画成柱状图。

智能体会用 sandbox_exec_python 读取文件、计算、生成图表,并把图表作为 artifact 给你。

安全

  • 用户提供的代码在沙箱里跑,主进程永不执行。
  • 执行命令/写文件属高风险,默认先请你确认。
  • 风险闸会额外拦截危险命令(如 rm -rf /、fork bomb、强制推送等)。
  • 沙箱有冷启动时间预算(约 1.5s 内),首次调用可能稍慢。