文档中心/ 百度搭子/ 企业版使用指南/ API参考/ 技能管理/ 获取技能列表

获取技能列表

GET
https://api.dumate.cn/api/v1/skills

本接口用于查询技能(Skill)列表,支持按技能标识精确过滤、按名称或描述检索、排序和分页。

权限说明

使用 API Key 鉴权调用 API 流程,具体调用流程,请查看认证鉴权。

请求参数

Headers 参数
除公共头域外,无其它特殊头域
Query 参数
skillId string

按技能(Skill)标识精确过滤。

可选
keyword string

按技能(Skill)名称或描述筛选。

可选
order string

排序方向。
可选值:
asc:升序。
desc:降序。
默认值:desc。

可选
page integer

页码。

必选
pageSize integer

每页条数。

必选
请求结构
GET /api/v1/skills?page=1&pageSize=20 HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

示例代码

请求示例
curl --location --request GET "https://api.dumate.cn/api/v1/skills?page=1&pageSize=20" \
--header 'Authorization: Bearer <YOUR_API_KEY>'

返回响应

Headers 参数
除公共头域外,无其它特殊头域
返回参数
total integer

总条数。

可选
data array

技能(Skill)摘要列表。

可选
显示子属性 隐藏子属性
items object {18}
显示子属性 隐藏子属性
id string

技能(Skill)标识。

可选
name string

技能(Skill)名称。

可选
description string

技能(Skill)描述。

可选
icon string

技能(Skill)图标地址。

可选
version string

技能(Skill)展示版本。

可选
releaseId string

技能(Skill)发布版本标识。

可选
packageId string

技能包标识。

可选
type string

技能(Skill)分类。

可选
labels array

技能(Skill)标签列表。

可选
显示子属性 隐藏子属性
items string
builtin boolean

是否为内置技能(Skill)。

可选
square boolean

是否在技能广场展示。

可选
changes object

技能(Skill)配置变更信息。

可选
显示子属性 隐藏子属性
applyStatus string

技能(Skill)应用或分发状态。

可选
security object {2}

技能(Skill)安全检测结果对象。

可选
显示子属性 隐藏子属性
status string

安全检测状态。

可选
confidence string

安全检测结论。

可选
createTime integer

创建时间,Unix 秒时间戳。

可选
updateTime integer

最近更新时间,Unix 秒时间戳。

可选
createBy string

创建者。

可选
updateBy string

最近更新者。

可选
响应示例
{
    "total": 5,
    "data": [
        {
            "id": "5b9b133f-5b7e-42b1-4762-a00bc02e5141",
            "name": "legal-industry-law",
            "description": "企业合同、劳动用工、隐私合规和民商事争议的信息整理与风险识别。",
            "icon": "",
            "version": "1.0.0",
            "releaseId": "9c7c5360-81eb-4299-a26f-2b3d0b2a7344",
            "packageId": "6f01164a-ed79-485a-4b18-a160fb41ed71",
            "labels": [],
            "security": {
                "status": "done",
                "confidence": "safe"
            },
            "createTime": 1788328717,
            "updateTime": 1788328717,
            "createBy": "",
            "updateBy": ""
        },
        {
            "id": "78026aae-b08c-469f-5db0-01f348079e26",
            "name": "industry-case-analysis",
            "description": "基于公司公开资料和现场信息分析行业业务流程、数据系统、真实痛点与 DuMate Agent 落地场景。",
            "icon": "",
            "version": "1.0.0",
            "releaseId": "5559c731-a33d-43a3-9148-3524f3ca5515",
            "packageId": "9d6dd0df-1d87-455b-457e-8808f757b2cd",
            "labels": [],
            "security": {
                "status": "done",
                "confidence": "safe"
            },
            "createTime": 1788280838,
            "updateTime": 1788280839,
            "createBy": "",
            "updateBy": ""
        },
        {
            "id": "86c383fe-9989-4026-6857-cc212cb4bc77",
            "name": "manim-skill",
            "description": "Create mathematical animations with Manim Community Edition(manimce). Generates distinctive, production-grade animations that avoid generic AI slop aesthetics. Use when user wants to animate concepts, equations, illustrate proofs, visualize algorithms, create math explainers, or produce 3Blue1Brown-style videos.",
            "icon": "",
            "version": "1.0.0",
            "releaseId": "73417965-46ba-4100-9b41-4ee6eee22ef9",
            "packageId": "8087cccc-84bb-4f37-5caf-e7451112d4cc",
            "labels": [],
            "security": {
                "status": "done",
                "confidence": "safe"
            },
            "createTime": 1788190504,
            "updateTime": 1788190504,
            "createBy": "",
            "updateBy": ""
        },
        {
            "id": "6faef04e-f3b5-4ae8-5976-ac8aef9f8277",
            "name": "managing-skills",
            "description": "Install, find, update, and manage agent skills. Use when the user wants to add a new skill, search for skills that do something, check if skills are up to date, or update existing skills. Triggers on: install skill, add skill, get skill, find skill, search skill, update skill, check skills, list skills.",
            "icon": "",
            "version": "1.0.0",
            "releaseId": "6145f2fb-2024-4c6d-813a-b55b7925397b",
            "packageId": "66952f4f-c3cd-4f20-7000-12af8aea6c26",
            "labels": [],
            "security": {
                "status": "done",
                "confidence": "safe"
            },
            "createTime": 1787455495,
            "updateTime": 1787455495,
            "createBy": "",
            "updateBy": ""
        },
        {
            "id": "f1291d75-e30a-4d75-4f8b-b8a323106f03",
            "name": "openclaw-novel-write",
            "description": "OpenClaw 小说创作 Skill - 基于七步方法论的 AI 辅助写作系统",
            "icon": "",
            "version": "1.0.1",
            "releaseId": "e0576ee4-80a2-4bbe-a93c-f77702112618",
            "packageId": "62a253a9-c68b-495b-5c19-bbe848592589",
            "labels": [],
            "security": {
                "status": "done",
                "confidence": "safe"
            },
            "createTime": 1787408281,
            "updateTime": 1788408497,
            "createBy": "",
            "updateBy": ""
        }
    ]
}