帮你快速理解、总结文档立即下载

列出内置模型

最近更新时间:2026-10-29 18:19:32
我的收藏

接口描述

查询当前企业可用的内置模型列表。
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=20
Authorization: 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
请求体不合法