查询模型组列表 - ListModelGroups_模型组_云桌面API_API参考

功能介绍

查询模型组列表，支持模糊搜索。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

workspace:modelGroup:list

List

-

-

-

-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
workspace:modelGroup:list	List	-	-	-	-

URI

GET /v3/ai-agents/model-groups

表1 Query参数
参数	是否必选	参数类型	描述
offset	否	Integer	偏移量，默认0。
limit	否	Integer	分页大小，默认20。
name	否	String	分组名称（模糊匹配）。
status	否	String	分组状态（draft-草稿，active-活跃，inactive-停用，deprecated-废弃）。

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
total	Integer	总数。
items	Array of ModelGroupItemVO objects	模型组列表项。

表3 ModelGroupItemVO
参数	参数类型	描述
id	String	模型组id。
name	String	分组名称。
description	String	分组描述。
priority	Integer	分组优先级。
default_model_id	String	默认模型ID。
provider_count	Integer	关联的供应商数量。
resource_count	Integer	关联的应用对象数量（Agent实例+桌面标签）。
create_time	String	创建时间（ISO8601格式，UTC时区）。
update_time	String	更新时间（ISO8601格式，UTC时区）。

状态码：400

表4 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述，遵循三段式格式：{描述}.{原因}.{方案}。描述：简要说明发生了什么错误。原因：说明导致错误的根本原因。方案：给出修复建议或后续操作指引。

状态码：401

表5 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述，遵循三段式格式：{描述}.{原因}.{方案}。描述：简要说明发生了什么错误。原因：说明导致错误的根本原因。方案：给出修复建议或后续操作指引。

状态码：403

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误码，失败时返回。
error_msg	String	错误描述，遵循三段式格式：{描述}.{原因}.{方案}。描述：简要说明发生了什么错误。原因：说明导致错误的根本原因。方案：给出修复建议或后续操作指引。

请求示例

GET /v3/ai-agents/model-groups?offset=0&limit=20&name=文本&status=active

响应示例

状态码：200

操作成功。

{
  "total" : 2,
  "items" : [ {
    "id" : "group-uuid-001",
    "name" : "文本摘要模型组",
    "description" : "用于文本摘要任务的所有可用供应商和模型",
    "priority" : 0,
    "default_model_id" : "model-uuid-001",
    "provider_count" : 3,
    "resource_count" : 5,
    "create_time" : "2026-05-12T10:00:00Z",
    "update_time" : "2026-05-12T10:00:00Z"
  }, {
    "id" : "group-uuid-002",
    "name" : "代码生成模型组",
    "description" : "代码生成和补全模型",
    "priority" : 1,
    "default_model_id" : "",
    "provider_count" : 2,
    "resource_count" : 3,
    "create_time" : "2026-05-12T11:00:00Z",
    "update_time" : "2026-05-12T11:00:00Z"
  } ]
}

状态码

状态码	描述
200	操作成功。
400	由于包含语法错误，当前请求无法被服务器理解。
401	鉴权失败。
403	没有操作权限。

错误码

请参见错误码。

查询模型组列表 - ListModelGroups