Skip to main content

获取 Environment template

根据模板 ID 返回完整的环境模板配置。

接口

GET /agents/environments/templates/{template_id} 成功返回 200 和完整环境模板。

路径参数

template_id string (必选)环境模板 ID

请求示例

curl -sS "$BASE_URL/agents/environments/templates/envtmpl_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "OpenAI-Beta: agents=v1"

响应字段

id string环境模板 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。

响应示例

{
  "id": "envtmpl_xxx",
  "name": "example-template",
  "object": "agent.environment.template",
  "created_at": 1794319007,
  "updated_at": 1794319007,
  "packages": {"python": [], "system": [], "npm": []},
  "network": {"access": "disabled", "allowed_domains": []},
  "desktop": {"enabled": false},
  "capability_directories": ["/workspace/skills"],
  "skills": [],
  "plugins": [],
  "files": []
}

错误码

HTTP 状态码错误类型 / 错误码解决方案
401authentication_error / invalid_api_key在请求头携带有效的 Authorization: Bearer $DASHSCOPE_API_KEY
404not_found_error / not_found_error使用当前工作空间中存在的环境模板 ID
500server_error / server_error稍后重试;持续失败时提交工单并提供 x-request-id