云端托管环境 - 阿里云百炼

阿里云百炼托管的沙箱容器涉及基础云资源和服务，您在使用时应特别遵守《阿里云产品服务协议》第 6 条关于网络和数据安全的约定，不应安装、使用盗版软件等，并对您自行安装的软件和进行的操作所引起的结果承担全部责任。

类型

类型	说明
云端	由百炼托管的沙箱容器，开箱即用。创建后即可被会话绑定

配置字段

在环境页面点击添加环境，填写以下字段：

字段	必填	可变更	说明
名称	是	是	工作空间内唯一标识
描述	否	是	环境用途说明
托管类型	否	否	`cloud`（云端），由百炼托管。创建后无法变更
预装包	否	是	按包管理器声明（`apt` / `pip` / `npm`），环境创建时自动安装
网络策略	否	是	`unrestricted` 放行全部出站访问（仅 API 设置，控制台不显示）
作用域	否	是	`organization`（默认），工作空间成员均可使用（仅 API 设置，控制台不显示）
元数据	否	是	自定义键值对（对应 API 的 `metadata`），不影响运行行为

通过 API 创建环境时，指定沙箱类型与预装包。完整参数与响应字段详见创建 Environment。

curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/environments" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "data-sandbox",
    "description": "数据分析沙箱",
    "config": {
      "type": "cloud",
      "packages": {
        "apt": ["ffmpeg"],
        "pip": ["pandas", "numpy", "matplotlib"]
      },
      "networking": {"type": "unrestricted"}
    }
  }'

支持的包管理器

预装包按以下包管理器声明：

apt：系统包，例如 ffmpeg
pip：Python 包，例如 pandas、numpy
npm：Node.js 包

归档与删除

环境支持归档和删除两种操作：

归档：环境保留但默认不出现在列表中，已绑定的会话继续可用。
删除：硬删除，环境配置一并清除，不可恢复。如需保留配置请改用归档。

通过 API 归档环境，详见归档 Environment。

curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/environments/env_xxx/archive" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

通过 API 删除环境，详见删除 Environment。

curl -X DELETE "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/environments/env_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

​类型

​配置字段

​支持的包管理器

​归档与删除

类型

配置字段

支持的包管理器

归档与删除