查询智能体版本列表 - ListCoreAgentVersions

agentarts:managedAgent:listCoreAgentVersions

List

managedAgent *

g:ResourceTag/<tag-key>

-

-

agent_id

是

String

参数解释：

智能体ID，用于唯一标识一个智能体实例。获取方式：通过创建智能体接口返回的agent_id字段获取，或通过查询智能体列表接口获取，具体参见查询智能体列表。

约束限制：

不涉及。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

默认取值：

不涉及。

limit

否

Integer

参数解释：

每页返回的记录数。

约束限制：

不涉及。

取值范围：

10-100，单位：条。

默认取值：

10

offset

否

Integer

参数解释：

分页查询偏移量，表示从第几条记录开始查询，从1开始。

约束限制：

不涉及。

取值范围：

1-1000。

默认取值：

1

sort

否

String

参数解释：

排序字段，格式为field:order。

约束限制：

不涉及。

取值范围：

• created_at:asc：按创建时间升序排列。

• created_at:desc：按创建时间降序排列。

默认取值：

created_at:desc。

items

Array of AgentVersionItem objects

参数解释：

智能体版本摘要列表，按版本号倒序排列，元素个数0-100个。

取值范围：

不涉及。

total

Integer

参数解释：

该智能体的版本总数。

取值范围：

0-100000。

version

String

参数解释：

版本号。创建时为v1，每次更新自动递增。

取值范围：

匹配小写字母开头、数字结尾的版本号格式，如v1、v2。

created_at

String

参数解释：

该版本的创建时间，UTC时间格式，格式为YYYY-MM-DDTHH:mm:ssZ。例如：2024-05-20T14:30:00Z。

取值范围：

不涉及。

updated_at

String

参数解释：

该版本的更新时间，UTC时间格式，格式为YYYY-MM-DDTHH:mm:ssZ。例如：2024-05-20T14:30:00Z。

取值范围：

不涉及。

updated_by

String

参数解释：

执行此次更新的用户ID。

取值范围：

长度为0-128个字符。

name

String

参数解释：

该版本的智能体名称。

取值范围：

长度为2-40个字符。

description

String

参数解释：

该版本的智能体描述信息。

取值范围：

长度为0-4096个字符。

environment_id

String

参数解释：

该版本关联的环境ID。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。

取值范围：

固定值：AgentArts.03000400。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。

取值范围：

固定值：AgentArts.03000401。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000403表示禁止访问（认证后权限不足）。

取值范围：

固定值：AgentArts.03000403。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

coded_authorization_message

String

参数解释：

当API无访问权限时报错信息。

取值范围：

长度为1-1024个字符。

details

Array of ManagedAgentErrorDetail objects

参数解释：

依赖的下游服务错误信息列表。

取值范围：

最小数量0，最大数量10。

error_code

String

参数解释：

错误码。

取值范围：

长度为18个字符。

error_msg

String

参数解释：

错误信息。

取值范围：

长度为1-1024个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000404表示资源不存在。

取值范围：

固定值：AgentArts.03000404。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。

取值范围：

固定值：AgentArts.03000429。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。

取值范围：

固定值：AgentArts.03000500。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

200

查询成功，返回智能体版本列表。

400

请求参数错误。

401

未授权。

403

禁止访问。

404

资源不存在。

429

请求过于频繁。

500

服务器内部错误。