更新环境模板配置;省略的字段保持原值。
接口
POST /agents/environments/templates/{template_id}
成功返回 200 和更新后的完整环境模板。省略的字段保持原值。
路径参数template_idstring (必选)环境模板 ID请求体namestring / null (可选)模板名称packages object (可选)预装包,按 npm、python、system 分组env object<string,string> (可选)环境变量;变量名和值限制与创建环境模板一致setup_commands array (可选)初始化命令,按顺序执行network object (可选)网络策略,包含 access、allowed_domains;不接受 blocked_domainsdesktop object (可选)桌面配置,只接受 enabled=false,enabled=true 返回 400capability_directories array<string> (可选)能力发现目录skills array (可选)Skill 配置,固定为 skill_referenceplugins array (可选)插件配置,当前只支持空数组,非空返回 400files array (可选)初始文件配置,固定为 file_id只传 name 时,原有 network、capability_directories 等配置保持不变。显式 null 会重置对应字段:name 清空,network 恢复默认策略,desktop 恢复 enabled=false,数组字段清空。 | 请求示例 |
响应字段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响应不返回 env 和 setup_commands。 | 响应示例 |
错误码
| 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 |
404 | not_found_error / not_found_error | 使用当前工作空间中存在的环境模板 ID |
500 | server_error / server_error | 稍后重试;持续失败时提交工单并提供 x-request-id |