cursor 分页列出技能,按 created_at 倒序。支持按来源过滤(自建或百炼官方)。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
GET /skills
Query 参数
参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| int | 20 | 每页数量,最大 100 |
| string | — | 首次不传,后续传上一次响应的 |
| string |
| 来源筛选: |
请求示例
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 对象字段
字段 | 类型 | 说明 |
|---|---|---|
| string | 技能 ID,格式 |
| string | 固定为 |
| string | 从 zip 包内 |
| string | 来源: |
| string | 扫描状态: |
| string | 最新版本号,挂载到智能体时不能锁定到 |
| string | 创建/最近更新时间,ISO 8601 |
该文章对您有帮助吗?