创建可复用的环境模板,保存容器、依赖、网络、初始文件和 Skill 配置。
接口
POST /agents/environments/templates
成功返回 201 和完整环境模板。请求体可以为空,此时创建使用默认配置的模板。
请求体namestring / null (可选)模板名称packages object (可选)预装包,按 npm、python、system 分组,默认三组均为空数组
属性 python array<string> (可选)Python 包system array<string> (可选)系统包npm array<string> (可选)npm 包object<string,string> (可选)环境变量;变量名需匹配 [A-Za-z_][A-Za-z0-9_]*,不能是 PATH,也不能以服务端保留前缀开头;值不能包含 NULsetup_commands array (可选)初始化命令,按顺序执行。每项包含必填的 command 和可选的 cwd,cwd 默认为 /workspace
属性 command string (可选)初始化命令cwd string (可选)工作目录,默认 /workspaceobject (可选)网络策略,默认 enabled;不接受 blocked_domains
属性 access string (可选)网络访问模式,enabled、disabled 或 restrictedallowed_domains array<string> (可选)允许的域名,仅 access=restricted 时生效object (可选)桌面配置,只接受 enabled=false,enabled=true 返回 400
属性 enabled boolean (可选)是否启用桌面array<string> (可选)能力发现目录,默认 []skills array (可选)Skill 配置,固定为 skill_referenceplugins array (可选)插件配置,当前只支持空数组,非空返回 400files array (可选)初始文件配置,固定为 file_id模板响应不返回 env 和 setup_commands。files 固定为 file_id,skills 固定为 skill_reference。 | 请求示例 |
响应字段idstring环境模板 IDobject string环境模板对象类型,固定为 agent.environment.templatename string / null模板名称created_at integer创建时间,Unix 秒updated_at integer最近更新时间,Unix 秒packages object预装包,包含 python、system、npmnetwork object网络策略,包含 access、allowed_domainsdesktop object桌面配置,包含 enabledcapability_directories array<string>能力发现目录skills arraySkill 配置,包含 type、skill_id、versionplugins array插件安全元数据。包含 type、name、description,当前为空数组files array初始文件配置,每项包含 type、path、file_id | 响应示例 |
错误码
| HTTP 状态码 | 错误类型 / 错误码 | 解决方案 |
|---|---|---|
400 | invalid_request_error / invalid_request_error | 按字段说明修正请求体 |
400 | invalid_request_error / invalid_request_error | desktop.enabled=true、非空 plugins 和 network.blocked_domains 都会被拒绝,按字段说明调整 |
401 | authentication_error / invalid_api_key | 在请求头携带有效的 Authorization: Bearer $DASHSCOPE_API_KEY |
500 | server_error / server_error | 稍后重试;持续失败时提交工单并提供 x-request-id |