接口描述
为指定 Agent 创建新版本（不能基于已有版本复制）。
POST /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions输入参数
路径参数
参数 | 类型 | 说明 |
enterpriseId | string | WorkBuddy 企业 ID |
agentId | string | 等价于请求体字段 AgentId |
查询参数
无
请求体
字段 | 类型 | 说明 |
model | string | 模型标识。 |
manifest | string | v2.0 精简 manifest 原文（JSON 对象序列化后的字符串），必填。 |
description | string | 版本变更说明。 |
isTest | boolean | 版本类型：true=test，false=prod；未传默认创建 test 版本。 |
sandboxTemplateId | string | 沙箱模板 ID，仅 backend=SANDBOX 时使用；缺省由服务端选择默认模板。 |
backend | string | 版本运行时后端：LAMP（存算分离）/ SANDBOX（沙箱），缺省 LAMP；创建后不可修改。 |
输出参数
（
201，业务出参包装在 code / data / msg / requestId 中）字段 | 类型 | 说明 |
versionId | string | 版本 ID，归属某一 Agent。 |
agentId | string | 版本所属的 Agent 业务 ID。 |
versionName | string | 版本名称（test / prod 等展示名）。 |
versionType | string | 服务端派生：DEFAULT / TEST / PROD。 |
description | string | 版本描述。 |
model | string | 版本使用的模型标识。 |
manifest | string | 版本 manifest 原文（JSON 对象序列化后的字符串）。 |
sandboxTemplateId | string | 沙箱模板 ID，仅沙箱后端版本有值。 |
status | string | 版本状态：DRAFT / ENABLED / DISABLED。该字段恒返回，不会因未设置而缺省。 |
sessionCount | integer | 该版本累计承接的会话总数（历史累计值，只增不减）。仅在查询版本详情时返回。 |
createdTime | string | 创建时间，UTC RFC3339。 |
modifiedTime | string | 最后修改时间，UTC RFC3339。 |
示例
输入示例
POST /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versionsAuthorization: Bearer pt_<YOUR_APP_KEY>Content-Type: application/json{"AgentId": "736918300000000001","Backend": "LAMP","Description": "负责每日数据汇总","IsTest": false,"Manifest": "{\\"version\\":\\"2.0\\",\\"prompt\\":\\"你是数据分析助手。\\"}","Model": "hunyuan-turbos-latest","SandboxTemplateId": "1200345678901234567"}
输出示例
{"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.DebugAgentVersionForbidden | 调试 Agent 不支持创建 test / prod 版本 |
FailedOperation.VersionInUseByRouting | 版本仍被路由配置引用，无法废弃；请先从路由中移除 |
InternalError.VersionOperationFailed | 版本操作失败 |
InvalidParameter.AgentIDRequired | 缺少 AgentId |
InvalidParameter.InvalidRequestBody | 请求体不合法 |
InvalidParameter.ManifestRequired | 缺少 Manifest |
MissingParameter.UinRequired | 公共参数中缺少 Uin |
ResourceNotFound.Agent | Agent 不存在 |
ResourceNotFound.Version | 版本不存在 |
ResourceUnavailable.RuntimeAPIUnavailable | 未配置 agentos 运行时 API |
UnauthorizedOperation.UnprovisionedTenant | 租户未开通，或企业不存在 |
