列出 Skill

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

GET /skills

Query 参数

参数	类型	默认	说明
`limit`	int	20	每页数量，最大 100
`page`	string	—	首次不传，后续传上一次响应的 `next_page`
`source`	string	`customer`	来源筛选：`customer`（自建）或 `official`（阿里云百炼官方）

请求示例

curl "$AGENTSTUDIO_URL/skills?source=customer&limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应示例

{
  "data": [
    {
      "id": "skill_xxx",
      "type": "skill",
      "name": "pdf3.0",
      "description": "Use this skill whenever the user wants to do anything with PDF files...",
      "source": "customer",
      "status": "active",
      "latest_version": "1.1",
      "created_at": "2026-06-16T07:56:03+00:00",
      "updated_at": "2026-06-16T08:12:47+00:00"
    }
  ],
  "next_page": "skill_xxx",
  "request_id": "xxx"
}

响应包含 data（Skill 对象数组）与 next_page。Skill 对象字段如下：

Skill 对象字段

字段	类型	说明
`id`	string	技能 ID，格式 `skill_xxx`
`type`	string	固定为 `skill`
`name` / `description`	string	从 zip 包内 `SKILL.md` 解析得到
`source`	string	来源：`customer`（自建） / `official`（阿里云百炼官方）
`status`	string	扫描状态：`checking` / `active` / `rejected` / `deleted`，仅 `active` 可挂载
`latest_version`	string	最新版本号，挂载到智能体时不能锁定到 `latest`，必须指定具体版本号
`created_at` / `updated_at`	string	创建 / 最近更新时间，ISO 8601

​前提

​接口

​Query 参数

​请求示例

​响应示例

​Skill 对象字段

前提

接口

Query 参数

请求示例

响应示例

Skill 对象字段