Code 沙箱使用指南

December 17, 2025 · View on GitHub

概述

Code 沙箱是一个安全的 Python 代码执行环境，允许 AI 助手在隔离的环境中运行 Python 代码，执行数据分析、可视化、计算等任务。当前版本支持阿里云 FC（Function Compute）沙箱。

功能特性

✅ 安全的 Python 代码执行环境
✅ 支持文件上传和管理
✅ 支持数据分析和可视化
✅ 可配置的超时时间
✅ 自动处理执行结果和错误信息
✅ 支持图片生成和展示

配置说明

前置要求

在使用 Code 沙箱之前，您需要：

阿里云账号：拥有阿里云账号并开通函数计算服务
登陆AgentRun控制台，并新建一个代码解释器（其中网络模式选择：公网模式）
获得沙箱凭证：
- aliyun_id：阿里云账号 ID
- interpreter_id：代码解释器 ID
- interpreter_name：代码解释器名称

配置步骤

1. 通过 Web UI 配置

登录系统后，进入 Settings → Code沙箱
填写以下配置项：
- 启用沙箱：开启/关闭沙箱功能
- 沙箱类型：当前仅支持 aliyun-fc（阿里云FC沙箱）
- 阿里云ID (aliyun_id)：您的阿里云账号 ID
- 解释器ID (interpreter_id)：代码解释器的 ID
- 解释器名称 (interpreter_name)：代码解释器的名称
- 默认超时时间 (timeout_default)：代码执行的默认超时时间（秒），默认值为 50 秒
点击保存完成配置

2. 通过 API 配置

使用 POST 请求创建或更新配置：

示例请求

curl -X POST 'http://{API_ENDPOINT}/v1/config/code_sandbox' \
  -H 'Authorization: Bearer YOUR_BEARER_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "aliyun-fc",
    "aliyun_id": "your-aliyun-id",
    "interpreter_id": "your-interpreter-id",
    "interpreter_name": "your-interpreter-name",
    "enabled": true
  }'

查询当前配置：

curl -X GET 'http://{API_ENDPOINT}/v1/code_sandbox' \
  -H 'Authorization: Bearer YOUR_BEARER_TOKEN'

使用方式

在对话中使用

Code 沙箱会在 AI 助手需要执行代码时自动启用。当用户请求涉及：

数据分析
数据可视化
数学计算
excel附件处理
其他需要代码执行的任务

AI 助手会自动调用 Code 沙箱工具来执行相应的 Python 代码。