WorkBuddy Enterprise 获取 Agent 版本

接口描述
查询单个版本的完整配置（模型、沙箱模板、Manifest 等）。
GET /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions/{versionId}
输入参数
路径参数
参数
类型
说明
enterpriseId
string
WorkBuddy 企业 ID
agentId
string
等价于请求体字段 AgentId
versionId
string
等价于请求体字段 VersionId
查询参数
无
请求体
无（GET / DELETE 不带请求体，条件走路径与查询参数）
输出参数
（200，业务出参包装在 code / data / msg / requestId 中）
VersionInfo 版本详情。
字段
类型
说明
versionId
string
VersionId 版本 ID，归属某一 Agent。
agentId
string
AgentId 版本所属的 Agent 业务 ID。
versionName
string
VersionName 版本名称（test / prod 等展示名）。
versionType
string
VersionType 服务端派生：DEFAULT / TEST / PROD。
description
string
Description 版本描述。
model
string
Model 版本使用的模型标识。
manifest
string
Manifest 版本 manifest 原文（JSON 对象序列化后的字符串）。
sandboxTemplateId
string
SandboxTemplateId 沙箱模板 ID，仅沙箱后端版本有值。
status
string
Status 版本状态（字符串大写枚举，CAPI 规范 1.2.2）：DRAFT / ENABLED / DISABLED。 出参无 omitempty：明确回显语义，避免消费方误判为"未设置"。
sessionCount
integer
SessionCount 该版本累计承接的会话总数（历史累计值，只增不减）。 仅 DescribeAgentVersion（详情）填充并返回；创建 / 修改 / 回滚等写接口 不返回该字段（调用量恒为 0，且云 API 出参 schema 未注册该字段， 显式输出 0 会被网关判为「返回了未定义的字段」而报错），故加 omitempty。
createdTime
string
CreatedTime 创建时间，UTC RFC3339。
modifiedTime
string
ModifiedTime 最后修改时间，UTC RFC3339。
示例
输入示例
GET /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions/{versionId}
Authorization: Bearer pt_<YOUR_APP_KEY>
输出示例
{
  "code": 0,
  "data": {
    "agentId": "736918300000000001",
    "createdTime": "2026-10-20T09:30:00Z",
    "description": "负责每日数据汇总",
    "manifest": "{\\"version\\":\\"2.0\\",\\"prompt\\":\\"你是数据分析助手。\\"}",
    "model": "hunyuan-turbos-latest",
    "modifiedTime": "2026-10-20T09:30:00Z",
    "sandboxTemplateId": "1200345678901234567",
    "sessionCount": 2,
    "status": "DRAFT",
    "versionId": "2087791755109965825",
    "versionName": "prod",
    "versionType": "DEFAULT"
  },
  "msg": "OK",
  "requestId": "3c6d138e-1234-5678-9abc-def012345678"
}
错误码
说明：
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见错误响应与公共错误码。
错误码
说明
InternalError.VersionOperationFailed
版本操作失败
InvalidParameter.AgentIDRequired
缺少 AgentId
InvalidParameter.InvalidRequestBody
请求体不合法
InvalidParameter.VersionIDRequired
缺少 VersionId
MissingParameter.UinRequired
公共参数中缺少 Uin
ResourceNotFound.Agent
Agent 不存在
ResourceNotFound.Version
版本不存在
ResourceUnavailable.RuntimeAPIUnavailable
未配置 agentos 运行时 API
UnauthorizedOperation.UnprovisionedTenant
租户未开通，或企业不存在

获取 Agent 版本详情

本页目录：

接口描述

输入参数

路径参数

查询参数

请求体

输出参数

示例

输入示例

输出示例

错误码

参数	类型	说明
enterpriseId	string	WorkBuddy 企业 ID
agentId	string	等价于请求体字段 AgentId
versionId	string	等价于请求体字段 VersionId

字段	类型	说明
versionId	string	VersionId 版本 ID，归属某一 Agent。
agentId	string	AgentId 版本所属的 Agent 业务 ID。
versionName	string	VersionName 版本名称（test / prod 等展示名）。
versionType	string	VersionType 服务端派生：DEFAULT / TEST / PROD。
description	string	Description 版本描述。
model	string	Model 版本使用的模型标识。
manifest	string	Manifest 版本 manifest 原文（JSON 对象序列化后的字符串）。
sandboxTemplateId	string	SandboxTemplateId 沙箱模板 ID，仅沙箱后端版本有值。
status	string	Status 版本状态（字符串大写枚举，CAPI 规范 1.2.2）：DRAFT / ENABLED / DISABLED。出参无 omitempty：明确回显语义，避免消费方误判为"未设置"。
sessionCount	integer	SessionCount 该版本累计承接的会话总数（历史累计值，只增不减）。仅 DescribeAgentVersion（详情）填充并返回；创建 / 修改 / 回滚等写接口不返回该字段（调用量恒为 0，且云 API 出参 schema 未注册该字段，显式输出 0 会被网关判为「返回了未定义的字段」而报错），故加 omitempty。
createdTime	string	CreatedTime 创建时间，UTC RFC3339。
modifiedTime	string	ModifiedTime 最后修改时间，UTC RFC3339。

错误码	说明
`InternalError.VersionOperationFailed`	版本操作失败
`InvalidParameter.AgentIDRequired`	缺少 AgentId
`InvalidParameter.InvalidRequestBody`	请求体不合法
`InvalidParameter.VersionIDRequired`	缺少 VersionId
`MissingParameter.UinRequired`	公共参数中缺少 Uin
`ResourceNotFound.Agent`	Agent 不存在
`ResourceNotFound.Version`	版本不存在
`ResourceUnavailable.RuntimeAPIUnavailable`	未配置 agentos 运行时 API
`UnauthorizedOperation.UnprovisionedTenant`	租户未开通，或企业不存在