WorkBuddy Enterprise 列出技能

接口描述
按来源（内置 / 自建 / 企业授权）查询技能列表，支持按技能 ID 批量反查。
GET /v2/enterprises/{enterpriseId}/managedagent/skills
输入参数
路径参数
参数
类型
说明
enterpriseId
string
WorkBuddy 企业 ID
查询参数
参数
类型
说明
page
integer
页码，从 1 开始，缺省 1
pageSize
integer
每页条数，缺省 20，上限 100
skillId
string
按技能 ID 过滤
keyword
string
关键字搜索（模糊匹配）
publishStatus
string
按发布状态过滤（DRAFT / PUBLISHED / ALL）
status
string
按状态过滤
source（必填）
string
技能来源，必填：BUILTIN（内置）/ CUSTOM（自建）/ AUTHORIZED（企业授权）
accountId
string
授权方标识；仅 source=AUTHORIZED 时生效。不传：后端用 enterpriseId 自动推导全部已获授权范围内的 skill；传了：在自动推导基础上收窄到该 accountId 对应的单个授权方
agentId
string
可选；仅 source=AUTHORIZED 时生效。Agent 绑定 OneID 租户时，授权集合会收窄到该租户（此时传入的 accountId 必须与绑定值一致）
请求体
无（GET / DELETE 不带请求体，条件走路径与查询参数）
输出参数
（200，业务出参包装在 code / data / msg / requestId 中）
DescribeSkillListResp DescribeSkillList 响应体（TCAPI Data 字段）。
字段
类型
说明
totalCount
integer
Total 符合条件的技能总数
skillSet
﻿SkillItem[]
Items 技能列表
counts
﻿SkillCounts﻿
Counts 全局计数（不受 keyword 影响）
示例
输入示例
GET /v2/enterprises/{enterpriseId}/managedagent/skills?page=1&pageSize=20
Authorization: Bearer pt_<YOUR_APP_KEY>
输出示例
{
  "code": 0,
  "data": {
    "counts": {
      "builtin": 1,
      "custom": 0,
      "total": 2
    },
    "skillSet": [
      {
        "createTime": "2026-10-20T09:30:00Z",
        "description": "负责每日数据汇总",
        "displayName": "数据分析助手",
        "downloadUrl": "https://example.com/download/pkg-001.zip",
        "enabled": true,
        "icon": "https://example.com/avatar/agent-001.png",
        "name": "数据分析助手",
        "skillId": "1200345678901234567",
        "skillVersion": "1.0.0",
        "source": "BUILTIN",
        "updateTime": "2026-10-20T09:30:00Z"
      }
    ],
    "totalCount": 1
  },
  "msg": "OK",
  "requestId": "3c6d138e-1234-5678-9abc-def012345678"
}
错误码
说明：
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见错误响应与公共错误码。
错误码
说明
FailedOperation.ConsoleCallFailed
调用控制台接口失败
InternalError.Unknown
内部错误
InvalidParameter.EnterpriseIDRequired
缺少 EnterpriseID
InvalidParameter.InvalidRequestBody
请求体不合法
InvalidParameter.SourceRequired
缺少 Source
InvalidParameterValue.InvalidSource
Source 取值不合法

参数	类型	说明
page	integer	页码，从 1 开始，缺省 1
pageSize	integer	每页条数，缺省 20，上限 100
skillId	string	按技能 ID 过滤
keyword	string	关键字搜索（模糊匹配）
publishStatus	string	按发布状态过滤（DRAFT / PUBLISHED / ALL）
status	string	按状态过滤
source（必填）	string	技能来源，必填：BUILTIN（内置）/ CUSTOM（自建）/ AUTHORIZED（企业授权）
accountId	string	授权方标识；仅 source=AUTHORIZED 时生效。不传：后端用 enterpriseId 自动推导全部已获授权范围内的 skill；传了：在自动推导基础上收窄到该 accountId 对应的单个授权方
agentId	string	可选；仅 source=AUTHORIZED 时生效。Agent 绑定 OneID 租户时，授权集合会收窄到该租户（此时传入的 accountId 必须与绑定值一致）

字段	类型	说明
totalCount	integer	Total 符合条件的技能总数
skillSet	SkillItem[]	Items 技能列表
counts	SkillCounts	Counts 全局计数（不受 keyword 影响）

错误码	说明
`FailedOperation.ConsoleCallFailed`	调用控制台接口失败
`InternalError.Unknown`	内部错误
`InvalidParameter.EnterpriseIDRequired`	缺少 EnterpriseID
`InvalidParameter.InvalidRequestBody`	请求体不合法
`InvalidParameter.SourceRequired`	缺少 Source
`InvalidParameterValue.InvalidSource`	Source 取值不合法

列出技能

本页目录：

接口描述

输入参数

路径参数

查询参数

请求体

输出参数

示例

输入示例

输出示例

错误码