查询可执行 Skill 列表
更新时间：2026-10-23
接口描述
分页查询当前调用身份具有执行权限、存在当前发布快照且适用于 Data Agent 的 Skill。响应中的 skillId 和 releaseId 必须成对传入对话请求的 selected_skills 或 invoked_skills。
请求结构
Plain Text
1GET /v2/workspaces/{workspaceId}/agent/skills路径参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
workspaceId |
string | 是 | 工作空间 ID |
Query 参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
appType |
string | 是 | 固定为 DATA_AGENT |
keyword |
string | 否 | 按名称或描述搜索，最大 128 个字符 |
pageNo |
integer | 是 | 页码，从 1 开始 |
pageSize |
integer | 是 | 每页数量，取值为 1～100；传 -1 表示不分页 |
请求示例
Bash
1curl -G \
2 'https://{host}/databuilder/api/databuilder/v2/workspaces/workspace_9862_0763f283d58a/agent/skills' \
3 -H 'X-App-Id: dataagent-service' \
4 -H 'Authorization: <签名串>' \
5 --data-urlencode 'appType=DATA_AGENT' \
6 --data-urlencode 'pageNo=1' \
7 --data-urlencode 'pageSize=100'响应示例
成功（HTTP 200）
JSON
1{
2 "requestId": "trace_id_string",
3 "code": "SUCCESS",
4 "message": "success",
5 "result": {
6 "pageNo": 1,
7 "pageSize": 100,
8 "totalPage": 1,
9 "total": 1,
10 "skills": [
11 {
12 "skillId": "skill_abc123",
13 "ownerType": "PERSONAL",
14 "projectId": null,
15 "ownerUserId": "user_abc123",
16 "name": "订单分析",
17 "description": "分析订单指标并生成结论",
18 "appTypes": ["DATA_AGENT"],
19 "releaseId": "release_def456",
20 "zipSha256": "64位十六进制摘要",
21 "zipSize": 10240,
22 "releasedAt": "2026-09-01T10:00:00Z"
23 }
24 ]
25 }
26}调用对话接口时使用 skillId 和 releaseId：
JSON
1{
2 "selected_skills": [
3 {
4 "skillId": "skill_abc123",
5 "releaseId": "release_def456"
6 }
7 ]
8}评价此篇文章