接口描述
分页查询某个 Agent 的版本列表，含各版本承接的会话数。
GET /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions输入参数
路径参数
参数 | 类型 | 说明 |
enterpriseId | string | WorkBuddy 企业 ID |
agentId | string | 等价于请求体字段 AgentId |
查询参数
参数 | 类型 | 说明 |
page | integer | 页码，从 1 开始，缺省 1 |
pageSize | integer | 每页条数，缺省 20，上限 100 |
VersionType | string | 按版本类型过滤（DEFAULT / TEST / PROD） |
请求体
无（GET / DELETE 不带请求体，条件走路径与查询参数）
输出参数
（
200，业务出参包装在 code / data / msg / requestId 中）DescribeAgentVersionListResponse 对应 /DescribeAgentVersionList 响应体。
字段 | 类型 | 说明 |
totalCount | integer | 符合条件的版本总数（过滤后、分页前）。 |
agentVersionSet | 版本列表。字段名带实体前缀，与 Skill 版本列表的 versionSet 区分。 |
示例
输入示例
GET /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions?page=1&pageSize=20Authorization: Bearer pt_<YOUR_APP_KEY>
输出示例
{"code": 0,"data": {"agentVersionSet": [{"createdTime": "2026-10-20T09:30:00Z","model": "hunyuan-turbos-latest","modifiedTime": "2026-10-20T09:30:00Z","sandboxTemplateId": "1200345678901234567","sessionCount": 2,"status": "ENABLED","versionId": "2087791755109965825","versionName": "prod","versionType": "DEFAULT"}],"totalCount": 1},"msg": "OK","requestId": "3c6d138e-1234-5678-9abc-def012345678"}
错误码
说明：
错误码 | 说明 |
InternalError.VersionOperationFailed | 版本操作失败 |
InvalidParameter.AgentIDRequired | 缺少 AgentId |
InvalidParameter.InvalidRequestBody | 请求体不合法 |
MissingParameter.UinRequired | 公共参数中缺少 Uin |
ResourceNotFound.Agent | Agent 不存在 |
ResourceUnavailable.RuntimeAPIUnavailable | 未配置 agentos 运行时 API |
UnauthorizedOperation.UnprovisionedTenant | 租户未开通，或企业不存在 |
