根据名称读取单个Skill的详细信息,包括SKILL.md正文与bundle下载链接。
接口说明
请求说明
请求参数:需要提供要读取的 Skill 名称。
返回参数:返回 Skill 的详细信息,包括名称、描述、创建者 ID、最近修改者 ID、可见性级别及范围、SKILL.md 正文、bundle.zip 的临时下载链接(无需额外鉴权,但存在有效期)、创建时间和最近修改时间。
注意事项:
BundleUrl为临时下载链接,过期后需重新调用本接口获取新的链接。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Name |
string |
是 |
要读取的 Skill 名称。 |
my-skill |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
824F80BA-1778-5D8A-BAFF-668A4D9C4CC7 |
| Skill |
object |
技能 |
|
| CreatorId |
string |
创建者 ID。 |
123456 |
| ModifierId |
string |
最近修改者 ID。 |
123456 |
| Name |
string |
Skill 名称。 |
my-skill |
| Description |
string |
Skill 描述。 |
数据分析技能 |
| Visibility |
string |
可见性级别。 |
TENANT |
| Body |
string |
SKILL.md 正文。 |
把大象装冰箱需要3步,把冰箱门打开,把大象放进去,把冰箱门关上。 |
| VisibilityScope |
object |
可见性范围。 |
|
| ProjectIds |
array |
可见的项目 ID 列表。 |
|
|
string |
项目 id 列表 |
123456 |
|
| UserIds |
array |
可见的用户 ID 列表。 |
|
|
string |
用户 ID |
123456 |
|
| GmtCreateTime |
string |
创建时间(毫秒时间戳)。 |
1780555634000 |
| GmtModifiedTime |
string |
最近修改时间(毫秒时间戳)。 |
1780555634000 |
| BundleUrl |
string |
bundle.zip 下载链接(无需鉴权的临时 URL,过期失效)。 |
https://your-bucket.oss-cn-hangzhou.aliyuncs.com/xxx.zip?Expires=...&Signature=... |
示例
正常返回示例
JSON格式
{
"RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
"Skill": {
"CreatorId": "123456",
"ModifierId": "123456",
"Name": "my-skill",
"Description": "数据分析技能",
"Visibility": "TENANT",
"Body": "把大象装冰箱需要3步,把冰箱门打开,把大象放进去,把冰箱门关上。",
"VisibilityScope": {
"ProjectIds": [
"123456"
],
"UserIds": [
"123456"
]
},
"GmtCreateTime": "1780555634000",
"GmtModifiedTime": "1780555634000",
"BundleUrl": "https://your-bucket.oss-cn-hangzhou.aliyuncs.com/xxx.zip?Expires=...&Signature=..."
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。