查询 Agent 实例关联的模型分组列表 - ListInstanceModelGroups
功能介绍
根据 Agent 实例 ID 查询其关联的所有模型分组,按优先级升序排列,支持分页。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
workspace:agentInstance:list
List
-
-
-
-
URI
GET /v3/ai-agents/instances/{instance_id}/model-groups
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| instance_id | 是 | String | Agent 实例 ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| offset | 否 | Integer | 偏移量,从0开始 |
| limit | 否 | Integer | 每页条数 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 总数。 |
| items | Array of InstanceModelGroupItem objects | 模型分组列表,按优先级升序排列。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| group_id | String | 模型分组 ID |
| group_name | String | 模型分组名称 |
| default_model_id | String | 分组内默认模型 ID,未设置时为空 |
| priority | Integer | 分组优先级(数值越小优先级越高) |
| update_time | String | 模型分组更新时间 |
| providers | Array of InstanceModelProviderConfig objects | 供应商配置列表(不含 API Key) |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 供应商配置主键 ID |
| provider_id | String | 供应商标识 |
| name | String | 供应商名称 |
| provider_type | String | 供应商类型 |
| update_time | String | 供应商更新时间 |
| api_base_url | String | 供应商 API 地址 |
| custom_config | ProviderCustomConfig object | 供应商扩展配置 |
| models | Array of ModelInfo objects | 模型列表 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| model_list_api | String | 模型列表接口地址,用于查询供应商远程模型。 |
| auth_header | String | 认证请求头名称。 |
| auth_prefix | String | 认证前缀(如Bearer)。 |
| model_id_field | String | 供应商模型列表中模型ID字段名。 |
| model_name_field | String | 供应商模型列表中模型名称字段名。 |
| headers | Map<String,String> | 自定义HTTP请求头,调用供应商API时附加。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 模型 ID(业务主键)。 |
| name | String | 模型名称。 |
| provider_model_id | String | 供应商侧模型 ID。 |
| input | Array of strings | 输入类型数组。 |
| reasoning | Boolean | 是否支持推理。 |
| update_time | String | 模型更新时间。 |
| context_window | Integer | 上下文窗口。 |
| max_tokens | Integer | 最大输出 token 数。 |
| type | String | 纳管类型(BACKEND_MANAGE后台管理/CUSTOM自定义),业务下发的都是BACKEND_MANAGE。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码,失败时返回。 |
| error_msg | String | 错误描述。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码,失败时返回。 |
| error_msg | String | 错误描述。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码,失败时返回。 |
| error_msg | String | 错误描述。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码,失败时返回。 |
| error_msg | String | 错误描述。 |
请求示例
无
响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 操作成功。 |
| 400 | 请求参数错误。 |
| 401 | 鉴权失败。 |
| 403 | 没有操作权限。 |
| 500 | 服务内部错误。 |
错误码
请参见错误码。