文档首页/ 云桌面 Workspace/ API参考/ 云桌面API/ Agent实例管理/ 查询 Agent 实例关联的模型分组列表 - ListInstanceModelGroups
更新时间:2026-07-24 GMT+08:00

查询 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

表1 路径参数

参数

是否必选

参数类型

描述

instance_id

String

Agent 实例 ID

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

偏移量,从0开始

limit

Integer

每页条数

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

total

Integer

总数。

items

Array of InstanceModelGroupItem objects

模型分组列表,按优先级升序排列。

表4 InstanceModelGroupItem

参数

参数类型

描述

group_id

String

模型分组 ID

group_name

String

模型分组名称

default_model_id

String

分组内默认模型 ID,未设置时为空

priority

Integer

分组优先级(数值越小优先级越高)

update_time

String

模型分组更新时间

providers

Array of InstanceModelProviderConfig objects

供应商配置列表(不含 API Key)

表5 InstanceModelProviderConfig

参数

参数类型

描述

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

模型列表

表6 ProviderCustomConfig

参数

参数类型

描述

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时附加。

表7 ModelInfo

参数

参数类型

描述

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

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:401

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:403

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:500

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

请求示例

响应示例

状态码

状态码

描述

200

操作成功。

400

请求参数错误。

401

鉴权失败。

403

没有操作权限。

500

服务内部错误。

错误码

请参见错误码