列出 Skill

cursor 分页列出技能，按 created_at 倒序。支持按来源过滤（自建或阿里云百炼官方）。仅 active 状态可挂载到智能体。

前提

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

接口

GET /skills

Query 参数

请求示例

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

for skill in client.skills.list(source="customer", limit=20):
    print(skill.id, skill.name)

CursorPage<Skill> page = client.skills().list(SkillListParam.builder()
    .source("customer").limit(20).build());
for (Skill s : page.getData()) System.out.println(s.getId() + " " + s.getName());

响应示例

{
  "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 对象字段