接口描述
修改指定版本的配置；仅默认版本或测试版本可改。
PUT /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions/{versionId}输入参数
路径参数
参数 | 类型 | 说明 |
enterpriseId | string | WorkBuddy 企业 ID |
agentId | string | 等价于请求体字段 AgentId |
versionId | string | 等价于请求体字段 VersionId |
查询参数
无
请求体
字段 | 类型 | 说明 |
AgentId | string | AgentId Agent 业务 ID，由路径参数注入。 |
VersionId | string | VersionId 版本 ID，由路径参数注入。 |
Manifest | string | Manifest 新的 manifest 原文；不传表示不改。 |
Model | string | Model 新的模型标识；不传表示不改。 |
Description | string | Description 新的版本描述；不传表示不改，传空串表示清空。 |
SandboxTemplateId | string | SandboxTemplateId 新的沙箱模板 ID；不传表示不改，仅沙箱后端版本有意义。 |
ConnectorSet | ConnectorSet 该版本最终绑定的连接器集合（全量覆盖语义）： 缺省 = 本次不改动连接器绑定；空数组 = 解绑全部；非空 = 解析并物化， manifest 中不在本集合内的网关形态连接器条目会被移除（解绑闭环）。 与 agent def.ConnectorRefInput 同构，version 包独立声明避免跨域 import。 EnrichConnectorMCP 物化进 manifest。 | |
ConsoleConnectors | ConsoleConnectors console 老连接器选择（v2 REST 迁移面专属），三态语义对齐 ConnectorSet。见 docs/wma-v2-legacy-console-connector-integration.md §3.7。 |
输出参数
（
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。 |
示例
输入示例
PUT /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions/{versionId}Authorization: Bearer pt_<YOUR_APP_KEY>Content-Type: application/json{"AgentId": "736918300000000001","ConnectorSet": [{"ConnectorId": "1200345678901234567"}],"ConsoleConnectors": [{"Credential": {"CredentialId": "<REDACTED>","CredentialType": "<REDACTED>"},"Name": "数据分析助手"}],"Description": "负责每日数据汇总","Manifest": "{\\"version\\":\\"2.0\\",\\"prompt\\":\\"你是数据分析助手。\\"}","Model": "hunyuan-turbos-latest","SandboxTemplateId": "1200345678901234567","VersionId": "2087791755109965825"}
输出示例
{"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"}
错误码
说明：
错误码 | 说明 |
FailedOperation.ConnectorMCPEntryNameConflict | 该版本内已存在同名 MCP server 条目 |
FailedOperation.VersionInUseByRouting | 版本仍被路由配置引用，无法废弃；请先从路由中移除 |
FailedOperation.VersionNotEditable | 仅 default / test 版本允许修改 |
InternalError.VersionOperationFailed | 版本操作失败 |
InvalidParameter.AgentIDRequired | 缺少 AgentId |
InvalidParameter.InvalidRequestBody | 请求体不合法 |
InvalidParameter.ManifestRequired | 缺少 Manifest |
InvalidParameter.NoUpdatableField | 没有可更新的字段（Manifest / Model / Description 至少传一个） |
InvalidParameter.VersionIDRequired | 缺少 VersionId |
MissingParameter.UinRequired | 公共参数中缺少 Uin |
ResourceNotFound.Agent | Agent 不存在 |
ResourceNotFound.Version | 版本不存在 |
ResourceUnavailable.RuntimeAPIUnavailable | 未配置 agentos 运行时 API |
UnauthorizedOperation.UnprovisionedTenant | 租户未开通，或企业不存在 |
