帮你快速理解、总结文档立即下载

解绑外部 Agent

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

接口描述

解除外部 Agent 与 Managed Agent 的绑定。
DELETE /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/external-bindings/{bindingId}

输入参数

路径参数

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

查询参数

参数
类型
说明
versionId
string
等价于请求体字段 VersionId

请求体

无(GET / DELETE 不带请求体,条件走路径与查询参数)

输出参数

204 无响应体。

示例

输入示例

DELETE /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}/external-bindings/{bindingId}
Authorization: Bearer pt_<YOUR_APP_KEY>

错误码

说明:
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见错误响应与公共错误码。
错误码
说明
FailedOperation.ExternalOperationFailed
外部 Agent 操作失败
InvalidParameter.AgentIDRequired
缺少 AgentId
InvalidParameter.EndpointInvalid
Endpoint 必须是绝对的 http(s) URL
InvalidParameter.EndpointRequired
缺少 Endpoint
InvalidParameter.ExternalAgentIDRequired
缺少 A2AAgentId
InvalidParameter.InvalidRequestBody
请求体不合法
InvalidParameter.Pagination
分页参数不合法
InvalidParameterValue.InvalidBindingID
BindingId 必须是正整数形式的字符串
InvalidParameterValue.InvalidVersionID
VersionId 必须是正整数形式的字符串
MissingParameter.UinRequired
公共参数中缺少 Uin
ResourceNotFound.Agent
Agent 不存在
ResourceNotFound.ExternalAgent
该外部 Agent 未绑定到当前 Agent
ResourceNotFound.Version
版本不存在
ResourceUnavailable.A2ANotConfigured
未配置 A2A 网关
UnauthorizedOperation.UnprovisionedTenant
租户未开通,或企业不存在