更新A2A智能体。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：UpdateA2aAgent

要执行的操作，取值：UpdateA2aAgent。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

Id string 必选示例值：a-yegj2ehvk0y0puxl****

A2A智能体的ID。

Source string 必选示例值：Runtime

A2A智能体的注册来源。

Runtime：通过智能体运行时的地址，将智能体运行时中的A2A智能体注册至A2A智能体空间。

Standard：通过导入注册A2A智能体的JSON文件或者AgentCard地址，将A2A智能体注册至A2A智能体空间。

A2aSpaceId string 必选示例值：as-yeglyhjytc3srhse****

A2A智能体空间的ID。

AgentCard string 可选示例值：ei6****

AgentCard的JSON文本。Source选择Standard，且通过JSON文件注册A2A智能体时必填。

RuntimeConfig object 可选示例值：--

待注册A2A智能体所属智能体运行时的配置信息，Source选择Runtime时必填。

RuntimeId string 必选示例值：r-yeh6nlafwgo2eybt****

运行时的ID。

NetworkType string 必选示例值：private

选择智能体运行时后，自动匹配智能体运行时的服务地址，支持根据业务需求选择公网或私网地址。

private：如果只需要私有网络内部通信，选择私网地址即可，私网连通不收取费用。

public：如果需要从互联网访问云资源，必须使用公网地址。

ProjectName string 可选示例值：default

A2A智能体所属项目的名称。

Tags object[] 可选示例值：--

A2A智能体的标签。

Key string 必选示例值：key1

标签的键。

Value string 必选示例值：value1

标签的值。

SetDefaultVersion boolean 可选示例值：true

是否设置为默认版本，智能体默认调用A2A智能体的默认版本。A2A智能体支持版本生命周期管理，可对不同版本进行创建、查看与删除，满足智能体迭代与兼容需求。

true：设置为默认版本。

false：不设置为默认版本。

StandardConfig object 可选示例值：--

从外部导入A2A智能体的配置，Source选择Runtime时必填。

ImportType string 必选示例值：json

Source选择Standard是支持。通过导入注册A2A智能体的JSON文件或者AgentCard地址，将A2A智能体注册至A2A智能体空间。

json：通过导入符合A2A协议规范的JSON文件，将A2A智能体注册至A2A智能体空间。请提前准备好满足A2A协议规则的JSON文件，JSON文件各字段的具体定义、取值范围及校验规则等规范要求，参见A2A协议官网文档；JSON文件示例参见A2A智能体JSON文件示例。

url：通过A2A智能体的AgentCard地址，将A2A智能体注册至A2A智能体空间。请提前获取A2A智能体的AgentCard地址。

AgentCardUrl string 可选示例值：http://api.example.com/a2a/v1

注册A2A智能体的AgentCard地址。ImportType为url时需要填写。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
403	AccessDenied	You are not authorized to perform this action.	没有执行操作的权限。
500	InternalError	The request has failed due to an unknown error.	内部错误。

AgentKit