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

获取技能详情

GET
https://api.dumate.cn/api/v1/skills/{skillId}

本接口用于查询指定技能(Skill)的详细信息,可通过 releaseId 指定发布版本。

权限说明

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

请求参数

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

待查询的技能(Skill)标识。

必选
Query 参数
releaseId string

指定查询的技能(Skill)发布版本标识。传入时返回该指定发布版本的信息;不传时返回当前版本的信息。

可选
请求结构
GET /api/v1/skills/{skillId} 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/48a2243e-9877-4b1b-6732-77faaa312635" \
--header 'Authorization: Bearer <YOUR_API_KEY>'

返回响应

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

技能(Skill)标识。

可选
name string

技能(Skill)名称。

可选
description string

技能(Skill)描述。

可选
icon string

技能(Skill)图标地址。

可选
version string

技能(Skill)展示版本。

可选
releaseId string

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

可选
packageId string

技能包标识。

可选
labels array

技能(Skill)标签列表。

可选
显示子属性 隐藏子属性
items string
zipStorePath string

技能包压缩文件在对象存储中的路径。

可选
unzipStorePath string

技能包解压后在对象存储中的目录路径。

可选
zipStoreUrl string

技能包压缩文件的下载地址,带签名鉴权参数且有时效性。

可选
builtin boolean

是否为内置技能(Skill)。

可选
security object {2}

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

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

安全检测状态。

可选
confidence string

安全检测结论。

可选
createTime integer

创建时间,Unix 秒时间戳。

可选
updateTime integer

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

可选
createBy string

创建者。

可选
updateBy string

最近更新者。

可选
响应示例
{
  "id": "48a2243e-9877-4b1b-6732-77faaa312635",
  "name": "find-skills",
  "description": "Helps users discover and install agent skills when they ask questions like \"how do I do X\", \"find a skill for X\", \"is there a skill that can...\", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.",
  "icon": "",
  "version": "1.0.0",
  "releaseId": "028a685b-5755-4d7b-8088-6899cfb7425a",
  "packageId": "cb0d58cb-1e04-403e-64f7-894bc48d415f",
  "labels": [],
  "zipStorePath": "dumate-enterprise/package/<SPACE_ID>/skills/48a2243e-9877-4b1b-6732-77faaa312635/cb0d58cb-1e04-403e-64f7-894bc48d415f.zip",
  "unzipStorePath": "dumate-enterprise/package/<SPACE_ID>/skills/48a2243e-9877-4b1b-6732-77faaa312635/cb0d58cb-1e04-403e-64f7-894bc48d415f/",
  "zipStoreUrl": "https://dumate-web-enterprise.bj.bcebos.com/dumate-enterprise/package/<SPACE_ID>/skills/48a2243e-9877-4b1b-6732-77faaa312635/cb0d58cb-1e04-403e-64f7-894bc48d415f.zip?authorization=<BOS_AUTHORIZATION>",
  "builtin": false,
  "security": {
    "status": "done",
    "confidence": "safe"
  },
  "createTime": 1788421042,
  "updateTime": 1788421042,
  "createBy": "",
  "updateBy": ""
}