Skip to main content

列出 Environment template

分页列出当前工作空间的环境模板。

接口

GET /agents/environments/templates 成功返回 200 和列表信封。

查询参数

limit integer (可选)每页数量,默认 20;建议使用 1..100order string (可选)排序方向,asc 或 desc,默认 descafter string (可选)上一页的 last_id;不包含游标项before string (可选)上一页的 first_id,用于反向翻页,不能与 after 同时使用同时传 after 和 before 返回 400。游标无效或模板不存在时返回 404。

请求示例

curl -sS "$BASE_URL/agents/environments/templates?limit=20&order=desc" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "OpenAI-Beta: agents=v1"

响应字段

object string列表对象类型,固定为 listdata array当页环境模板;空时为 []first_id string / null当页首项 ID。空页为 nulllast_id string / null当页末项 ID。空页为 null。后续 after 使用该值has_more boolean当前检索方向是否还有下一页data[] 中每个环境模板包含 id、object、name、created_at、updated_at、packages、network、desktop、capability_directories、skills、plugins、files,字段含义与获取环境模板一致。

响应示例

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

错误码

HTTP 状态码错误类型 / 错误码解决方案
400invalid_request_error / invalid_request_error按查询参数说明修正 limit、order、after、before
401authentication_error / invalid_api_key在请求头携带有效的 Authorization: Bearer $DASHSCOPE_API_KEY
404not_found_error / not_found_error使用当前集合中有效的游标
500server_error / server_error稍后重试;持续失败时提交工单并提供 x-request-id