帮你快速理解、总结文档立即下载
文档中心>WorkBuddy Enterprise>WorkBuddy Managed Agents>OpenAPI>版本管理相关接口>基于源版本创建 Agent 版本

基于源版本创建 Agent 版本

最近更新时间：2026-10-29 18:19:32
我的收藏

本页目录：

接口描述

以某个已有版本为源复制出新版本，用于快速派生配置。
POST /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions/from-source

输入参数

路径参数

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

查询参数

无

请求体

字段
类型
说明
AgentId
string
AgentId Agent 业务 ID（必填）。
SourceVersionId
string
SourceVersionId 源版本 ID（必填），同 Agent 下未 DISABLED 的任意版本。
IsTest
boolean
IsTest 新版本类型：true=test，false=prod；未传默认创建 test 版本。
Model
string
Model 可选，覆盖源版本的 Model。
Description
string
Description 可选，覆盖源版本的 Description。
Manifest
string
Manifest 可选，完整 v2.0 manifest JSON 字符串；传入则整体覆盖源版本 manifest。
SandboxTemplateId
string
SandboxTemplateId 可选，覆盖源版本的沙箱模板 ID；仅沙箱后端版本有意义。

输出参数

（201，业务出参包装在 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。

示例

输入示例

POST /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/versions/from-source
Authorization: Bearer pt_<YOUR_APP_KEY>
Content-Type: application/json

{
  "AgentId": "736918300000000001",
  "Description": "负责每日数据汇总",
  "IsTest": false,
  "Manifest": "{\\"version\\":\\"2.0\\",\\"prompt\\":\\"你是数据分析助手。\\"}",
  "Model": "hunyuan-turbos-latest",
  "SandboxTemplateId": "1200345678901234567",
  "SourceVersionId": "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.DebugAgentVersionForbidden
调试 Agent 不支持创建 test / prod 版本
FailedOperation.VersionInUseByRouting
版本仍被路由配置引用，无法废弃；请先从路由中移除
InternalError.VersionOperationFailed
版本操作失败
InvalidParameter.AgentIDRequired
缺少 AgentId
InvalidParameter.InvalidRequestBody
请求体不合法
InvalidParameter.ManifestRequired
缺少 Manifest
InvalidParameter.VersionIDRequired
缺少 VersionId
MissingParameter.UinRequired
公共参数中缺少 Uin
ResourceNotFound.Agent
Agent 不存在
ResourceNotFound.Version
版本不存在
ResourceUnavailable.RuntimeAPIUnavailable
未配置 agentos 运行时 API
UnauthorizedOperation.UnprovisionedTenant
租户未开通，或企业不存在
中国站