WorkBuddy Enterprise 修改 Agent A2

接口描述
开启或关闭 Agent 的 A2A 对外互通，并维护对外宣告的能力列表。
PUT /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/a2a-config
输入参数
路径参数
参数
类型
说明
enterpriseId
string
WorkBuddy 企业 ID
agentId
string
等价于请求体字段 AgentId
查询参数
无
请求体
﻿ModifyAgentA2AConfigRequest 请求体。
字段
类型
说明
a2aEnabled
boolean
是否开启 A2A 对外互通。
a2aSkillSet
﻿A2ASkillInput[]
对外宣告的能力列表；不传表示不改，传空数组表示清空。
输出参数
（200，业务出参包装在 code / data / msg / requestId 中）
字段
类型
说明
agentId
string
Agent 业务 ID，创建后由服务端生成，后续接口都用它定位 Agent。
agentName
string
Agent 名称。
description
string
Agent 描述。
avatarUrl
string
头像地址，为空表示未设置。
isDebug
boolean
是否为调试 Agent：从调试入口创建，不进入正式下发流程。
routingSet
﻿RoutingItem[]
版本流量路由；未配置路由时返回空数组。
createdTime
string
创建时间，UTC RFC3339。
modifiedTime
string
最后修改时间，UTC RFC3339。
activeSessionCount
integer
当前活跃会话数（状态为 ACTIVE / CREATING / MIGRATING）。未统计时不返回该字段；统计结果为 0 时返回 0。
accountId
string
绑定的 OneID 企业账号 ID；未绑定时不返回该字段，绑定后不可修改。
creatorId
string
创建人标识：能解析到成员时下发成员名，否则下发用户 ID。
creatorName
string
创建人展示名；未解析到时为空。
a2aConfig
﻿A2AConfig﻿
A2A 对外互通配置与注册状态；未开启时 a2aEnabled 为 false。
ownership
﻿OwnershipOutput﻿
资产归属范围；未配置时不返回该字段。
clientEnabled
boolean
当前调用方在客户端是否可见：true 可见，false 不可见；仅创建人查询时返回。
示例
输入示例
PUT /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/a2a-config
Authorization: Bearer pt_<YOUR_APP_KEY>
Content-Type: application/json
﻿
{
  "A2AEnabled": true,
  "A2ASkillSet": [
    {
      "A2ASkillId": "skill_order_query",
      "Description": "负责每日数据汇总",
      "Examples": [
        "string"
      ],
      "InputModes": [
        "string"
      ],
      "Name": "数据分析助手",
      "OutputModes": [
        "string"
      ],
      "Tags": [
        "string"
      ]
    }
  ],
  "AgentId": "736918300000000001"
}
输出示例
{
  "code": 0,
  "data": {
    "a2aConfig": {
      "a2aEnabled": true,
      "a2aEndpoint": "https://a2a.example.com/card/736918300000000001",
      "a2aPublicRef": "ref_7f3c1a2b9d",
      "a2aStatus": "DRAFT"
    },
    "accountId": "1200345678901234567",
    "activeSessionCount": 2,
    "agentId": "736918300000000001",
    "agentName": "数据分析助手",
    "avatarUrl": "https://example.com/avatar/agent-001.png",
    "clientEnabled": true,
    "createdTime": "2026-10-20T09:30:00Z",
    "creatorId": "<REDACTED_USER>",
    "creatorName": "<REDACTED_USER>",
    "description": "负责每日数据汇总",
    "isDebug": false,
    "modifiedTime": "2026-10-20T09:30:00Z",
    "ownership": {
      "enforceMode": "default_off",
      "ownershipType": "all",
      "scopes": [
        {
          "scopeId": "1200345678901234567",
          "scopeName": "数据分析助手",
          "scopeType": "user"
        }
      ]
    },
    "routingSet": [
      {
        "versionId": "2087791755109965825",
        "weight": 1
      }
    ]
  },
  "msg": "OK",
  "requestId": "3c6d138e-1234-5678-9abc-def012345678"
}
错误码
说明：
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见错误响应与公共错误码。
错误码
说明
FailedOperation.RoutingInvalidVersion
路由项必须引用同一 Agent 下未停用的 prod 版本
InternalError.AgentOperationFailed
Agent 操作失败
InvalidParameter.AgentIDRequired
缺少 AgentId
InvalidParameter.InvalidRequestBody
请求体不合法
MissingParameter.UinRequired
公共参数中缺少 Uin
ResourceInUse.AgentIDConflict
Agent ID 冲突
ResourceNotFound.Agent
Agent 不存在
ResourceUnavailable.RuntimeAPIUnavailable
未配置 agentos 运行时 API
UnauthorizedOperation.UnprovisionedTenant
租户未开通，或企业不存在

修改 Agent A2A 配置

本页目录：

接口描述

输入参数

路径参数

查询参数

请求体

输出参数

示例

输入示例

输出示例

错误码

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

字段	类型	说明
a2aEnabled	boolean	是否开启 A2A 对外互通。
a2aSkillSet	A2ASkillInput[]	对外宣告的能力列表；不传表示不改，传空数组表示清空。

错误码	说明
`FailedOperation.RoutingInvalidVersion`	路由项必须引用同一 Agent 下未停用的 prod 版本
`InternalError.AgentOperationFailed`	Agent 操作失败
`InvalidParameter.AgentIDRequired`	缺少 AgentId
`InvalidParameter.InvalidRequestBody`	请求体不合法
`MissingParameter.UinRequired`	公共参数中缺少 Uin
`ResourceInUse.AgentIDConflict`	Agent ID 冲突
`ResourceNotFound.Agent`	Agent 不存在
`ResourceUnavailable.RuntimeAPIUnavailable`	未配置 agentos 运行时 API
`UnauthorizedOperation.UnprovisionedTenant`	租户未开通，或企业不存在