接口描述
按来源（内置 / 自建）查询专家列表。
GET /v2/enterprises/{enterpriseId}/managedagent/experts输入参数
路径参数
参数 | 类型 | 说明 |
enterpriseId | string | WorkBuddy 企业 ID |
查询参数
参数 | 类型 | 说明 |
page | integer | 页码，从 1 开始，缺省 1 |
pageSize | integer | 每页条数，缺省 20，上限 100 |
expertId | string | 按专家 ID 过滤 |
keyword | string | 关键字搜索（模糊匹配） |
publishStatus | string | 按发布状态过滤（DRAFT / PUBLISHED / ALL） |
expertType | string | 按专家类型过滤（AGENT / TEAM） |
source（必填） | string | 专家来源，必填：BUILTIN（内置）/ CUSTOM（自建） |
请求体
无（GET / DELETE 不带请求体，条件走路径与查询参数）
输出参数
（
200，业务出参包装在 code / data / msg / requestId 中）DescribeExpertsResp DescribeExpertList 响应体（TCAPI Data 字段）。
字段 | 类型 | 说明 |
maxBindings | integer | MaxBindings 单个 Agent 最多可绑定的专家数（产品上限，供前端做选择限制）。 |
totalCount | integer | TotalCount 符合条件的专家总数（按 ID 批量查询时 = 实际命中数） |
expertSet | Items 专家列表 | |
counts | Counts 全局计数（不受 keyword 影响） |
示例
输入示例
GET /v2/enterprises/{enterpriseId}/managedagent/experts?page=1&pageSize=20Authorization: Bearer pt_<YOUR_APP_KEY>
输出示例
{"code": 0,"data": {"counts": {"builtin": 1,"custom": 1,"total": 2},"expertSet": [{"categoryId": "1200345678901234567","categoryName": "数据分析助手","description": "负责每日数据汇总","disabledReason": "string","displayName": "数据分析助手","downloadUrl": "https://example.com/download/pkg-001.zip","enabled": true,"expertId": "1200345678901234567","expertType": "AGENT","expertVersion": "1.0.0","icon": "https://example.com/avatar/agent-001.png","modifiedTime": "2026-10-20T09:30:00Z","name": "数据分析助手","publishStatus": "DRAFT","source": "BUILTIN","status": "ENABLED","updatedBy": "string","zipFileName": "skill-001.zip","zipMd5": "9f2c4b1e7a3d5c8b0f1a2e3d4c5b6a79","zipSha256": "9f2c4b1e7a3d5c8b0f1a2e3d4c5b6a7980fedcba0123456789abcdef01234567","zipSizeBytes": "string"}],"maxBindings": 1,"totalCount": 2},"msg": "OK","requestId": "3c6d138e-1234-5678-9abc-def012345678"}
错误码
说明：
错误码 | 说明 |
FailedOperation.ConsoleCallFailed | 调用控制台接口失败 |
InternalError.Unknown | 内部错误 |
InvalidParameter.EnterpriseIDRequired | 缺少 EnterpriseID |
InvalidParameter.InvalidRequestBody | 请求体不合法 |
InvalidParameter.SourceRequired | 缺少 Source |
InvalidParameterValue.InvalidSource | Source 取值不合法 |
