接口描述
查询当前企业可用的内置模型列表。
GET /v2/enterprises/{enterpriseId}/managedagent/builtin-models输入参数
路径参数
参数 | 类型 | 说明 |
enterpriseId | string | WorkBuddy 企业 ID |
查询参数
参数 | 类型 | 说明 |
page | integer | 页码,从 1 开始,缺省 1 |
pageSize | integer | 每页条数,缺省 20,上限 100 |
status | string | 按状态过滤 |
name | string | 按名称过滤(模糊匹配) |
modelId | string | 按模型 ID 过滤(模糊匹配) |
vendor | string | 按模型厂商过滤(模糊匹配) |
accountId | string | 可选。传入时按 (enterpriseId, accountId) 走授权门禁并解析出对应企业的 EnterpriseID,用于调用 copilot 拉模型;未传则使用调用方 enterpriseID |
请求体
无(GET / DELETE 不带请求体,条件走路径与查询参数)
输出参数
(
200,业务出参包装在 code / data / msg / requestId 中)字段 | 类型 | 说明 |
totalCount | integer | TotalCount 符合条件的模型总数(过滤后、分页前)。 |
builtinModelSet | BuiltinModelSet 当前页的内置模型列表。 |
示例
输入示例
GET /v2/enterprises/{enterpriseId}/managedagent/builtin-models?page=1&pageSize=20Authorization: Bearer pt_<YOUR_APP_KEY>
输出示例
{"code": 0,"data": {"builtinModelSet": [{"agentCount": 2,"canDisableThinking": false,"clients": ["string"],"defaultThinkingLevel": "string","descriptionEn": "Daily data summarization","descriptionZh": "负责每日数据汇总","maxInputTokens": 1,"maxOutputTokens": 1,"modelId": "hunyuan-turbos-latest","name": "数据分析助手","serviceEndpoint": "https://a2a.example.com/inventory","status": "ENABLED","supportsImages": false,"supportsThinking": false,"supportsToolCall": false,"tags": ["string"],"thinkingLevels": ["MINIMAL"],"vendor": "string"}],"totalCount": 2},"msg": "OK","requestId": "3c6d138e-1234-5678-9abc-def012345678"}
错误码
说明:
错误码 | 说明 |
InternalError.ModelManagementFailed | 模型管理操作失败 |
InvalidParameter.InvalidRequestBody | 请求体不合法 |