Environment 对象和配置字段结构。
Environment 对象
创建、获取、列表、更新和归档接口都会返回 Environment 对象。
字段 | 类型 | 说明 |
| string | Environment 唯一标识，前缀为 |
| string | 固定值 |
| string | Environment 显示名称 |
| string | null | 自然语言描述 |
| object | Environment 配置。见 Environment config |
| object | 自定义键值对。最多 16 对，key ≤ 64 字符，value ≤ 512 字符 |
| string | null | 归档时间（ISO 8601）；未归档时为 null |
| string | 创建时间（ISO 8601） |
| string | 最后更新时间（ISO 8601） |
Environment config
字段 | 类型 | 必填 | 说明 |
| string | 是 | 配置类型。可选值： |
| object | null | 否 | 网络访问策略。仅 managed 类型可用。见 Environment networking |
| object | null | 否 | 预装包配置。仅 managed 类型可用。见 Environment packages |
| string | null | 否 | 初始化脚本。仅 managed 类型可用。见 Environment setup script |
自托管类型的 config 必须为 {"type":"self_hosted"}，不支持 networking、packages 和 setup_script 字段。
{
"type": "self_hosted"
}Environment packages
key | 类型 | 说明 | 示例 |
| string | 固定值 | "packages" |
| array | null | APT 系统包名称列表 | ["ffmpeg", "imagemagick"] |
| array | null | 全局安装的 npm 包列表 | ["typescript", "prettier"] |
| array | null | 全局安装的 pip 包列表 | ["pandas", "numpy"] |
Environment setup script
setup_script 是在 Environment 初始化阶段执行的 shell 脚本。
约束 | 值 |
类型 | string |
最大长度 | 10,000 字符 |
解释器 | bash |
超时 | 10 分钟 |
执行时机 | 容器启动后、Agent 执行前 |
脚本在容器内以 root 身份执行。若脚本以非零退出码结束，Session 将进入 failed 状态。
脚本的 stdout/stderr 不会暴露给 Agent，只记录在平台日志中，用于调试。
#!/bin/bash
set -e
apt-get update && apt-get install -y jq
pip install requests
echo "Setup complete"Environment networking
字段 | 类型 | 必填 | 说明 |
| string | 是 | 固定值 |
| array | null | 否 | 允许访问的域名白名单。为 null 时允许所有出站连接 |
| boolean | 否 | 是否允许 Agent 运行时动态安装包。默认 true |
| boolean | 否 | 是否允许 Agent 连接 MCP servers。默认 true |