Domain name for API request: adp.intl.tencentcloudapi.com.
Query the Skill list
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: DescribeSkillSummaryList. |
| Version | Yes | String | Common Params. The value used for this API: 2026-05-20. |
| Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
| SpaceId | Yes | String | Space ID. Required. |
| FavoriteOnly | No | Boolean | Query only the Skills favorited by the current user |
| FilterList.N | No | Array of Filter | Filter criteria (multiple Filters are in an AND relationship, while multiple Values within the same Filter are in an OR relationship): -SkillIdList: List of skill IDs, string array, exact match - ProviderType: Skill provider type, enumerated value array, exact match (SKILL_PROVIDER_TYPE_OFFICIAL=1/SKILL_PROVIDER_TYPE_THIRD_PARTY=2/SKILL_PROVIDER_TYPE_CUSTOM=3/SKILL_PROVIDER_TYPE_CUSTOM_SHARED=4) -CategoryKey: Category identifier, string array, exact match. - AnalysisStatus: Security detection status, enumeration value array, exact match. (SKILL_ANALYSIS_PENDING=0/SKILL_ANALYSIS_RUNNING=1/SKILL_ANALYSIS_AVAILABLE=2/SKILL_ANALYSIS_UNAVAILABLE=3/SKILL_ANALYSIS_FAILED=4) - RiskLevel: Risk level, enumerated value array, exact match (SKILL_RISK_NONE=0/SKILL_RISK_LOW=1/SKILL_RISK_MEDIUM=2/SKILL_RISK_HIGH=3) - SkillStatus: Publishing status in the Skill dimension. Enumerated value array. Exact match. OR between multiple values. Only meaningful when Perspective is EDITOR or ALL. (SKILL_STATUS_INITIALIZED=0/SKILL_STATUS_AUDITING=1/SKILL_STATUS_PENDING_RELEASE=2/SKILL_STATUS_RELEASED=3) - ShareStatus: Shared status, enumeration value array, exact match. This parameter is valid only when ProviderType includes SKILL_PROVIDER_TYPE_CUSTOM/SKILL_PROVIDER_TYPE_CUSTOM_SHARED. (SHARE_STATUS_UNSHARED=0/SHARE_STATUS_SHARED=1/SHARE_STATUS_APPROVING=2) -Perspective: Perspective enum, string single value. The length of Values must be 1. Multi-value is deemed as illegal. This parameter is valid only when ProviderType=SKILL_PROVIDER_TYPE_CUSTOM. Default if not passed: USER (USER=User perspective. Only Skills with usage permissions are returned / EDITOR=Editor perspective. Only Skills with edit permission are returned / ALL=Full perspective. Skills with any permission bit are returned) -Creator: Filter by creator. String single value. The length of Values must be 1. Multi-value is deemed as illegal. This parameter is valid only when ProviderType=SKILL_PROVIDER_TYPE_CUSTOM. Currently, only the placeholder "$self" is supported, which means only Skills created by the current caller are returned. To scale to a specified identity subsequently, add the agreement here if needed. |
| PageNumber | No | Integer | Page number, starting from 0 |
| PageSize | No | Integer | Number of items per page. Maximum value: 100. |
| Query | No | String | Fuzzy search by name/display name |
| Parameter Name | Type | Description |
|---|---|---|
| SkillSummaryList | Array of SkillSummary | Skill summary list |
| TotalCount | Integer | Total number. |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: adp.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeSkillSummaryList
<Common request parameters>
{
"SpaceId": "default_space",
"PageNumber": 0,
"PageSize": 20
}{
"Response": {
"SkillSummaryList": [
{
"ClassificationInfo": {
"BillingType": 0,
"BuiltinSource": 1,
"CategoryKey": "adp_knowledge_engine",
"CreateType": 99,
"ProviderType": 1,
"SourceLink": ""
},
"CurrentVersionInfo": {
"AnalysisInfo": {
"AnalysisStatus": 2,
"RiskDescription": "",
"RiskLevel": 0,
"SecurityReportUrl": "https://tix.qq.com/search/skill?keyword=4a6b07d90c8335b2bf1e62e70d86170c"
},
"Version": "1.0.17",
"VersionId": "1c1f9828-bef0-4060-909a-06bb260119cc"
},
"IsFavorite": false,
"Profile": {
"CreateTime": "1779183919",
"Creator": "Intelligent Agent development platform",
"Description": "Manage ADP skill plaza skills, with a focus on supporting ADP skill search, view detail, publish, update, and installing search results to a local directory. Used when users propose requirements such as ADP skill plaza, search skills, find skills, publish skills, release skills, update skills, view skill details, install skills locally, find skill, publish skill, update skill. During searching, additional Tencent Skillhub results are supplemented; ADP calls require the environment variables ADPAPIKEY and ADPSPACEID.",
"DisplayDescription": "Used for managing and discovering skills. Use when a user asks any request to complete a specific task, such as \"Can you help me do X\", \"Can you do X\", \"Help me do X\", \"How do I do X\", or \"Is there a tool/method to do X\" (for example, speech recognition, video generation), or when they need to create a skill, search for a skill, find a type of skill, install a skill locally, publish/update a skill, or view skill details. When creating a skill, cooperate with skill-creator to complete the creation and packaging first, and ask whether to publish it to the ADP Skill Plaza (that is, \"add to custom skills\")"
"DisplayName": "ADP Skill Management"
"IconUrl": "https://qidian-qbot-test-1251316161.cos.ap-guangzhou.myqcloud.com/public/adp/skill/skill_icon/skill_default.jpg",
"Name": "adp-skill-manager",
"UpdateTime": "1780458720"
},
"ShareList": [],
"SkillId": "5dd39985-a496-4fef-b753-a9bdca1b8433"
}
],
"TotalCount": 84,
"RequestId": "f9512cd3-fe81-4a11-a547-ef17996b195b"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
There is no error code related to the API business logic. For other error codes, please see Common Error Codes.
文档反馈