UpdateAtiAgentRegisterInfo - 修改Agent注册信息-云解析DNS(DNS)-阿里云帮助中心

更新Agent注册信息

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。	eyJhbGciOiJIUzI1NiIsInR5cC.....
AgentRegisterInfoId	string	否	AgentRegisterInfoId Agent 注册 ID。由阿里云 ATS 平台自动生成，在阿里云 ATS 平台具有全局唯一性。在 Agent 注册过程中自动生成，通过 API 注册、查询流程中，该 ID 必须全程携带，需调用接口 ListAtiAgentRegisterInfos 查询目标 Agent 后从应答内容获取 AgentRegisterInfoId	2074753647748672512
AgentDisplayName	string	否	Agent 显示名称	测试Agent
AgentHost	string	否	Agent 主机地址	example.com
AgentVersion	string	否	Agent 版本	1.0.0
AgentDescription	string	否	Agent 能力描述	支付服务
RegistrantId	string	否	实名认证注册人 ID	2072277378616354816
Endpoints	array<object>	否	各个协议的接入点。	https://example.com/mcp
	object	否	各个协议的接入点。
AgentUrl	string	否	该 Agent 端点的实际服务地址，即 Agent 在线运行的 HTTPS 入口。必填字段，最大 500 字符。例如：https://my-agent.example.com/mcp 作用：调用方通过 DNS 发现到这个 Agent 后，拿到这个 URL 就可以直接发起连接。这是 Agent 真正"在线"的地址。	https://my-agent.example.com/mcp
Protocol	string	否	查询 Agent 端点遵循的通信协议标准，决定调用方如何与该 Agent 交互：协议说明 MCP：Model Context Protocol，Anthropic 推出的 Agent 工具调用协议 A2A：Agent-to-Agent Protocol，Google 推出的跨 Agent 通信协议 OpenAPI：标准 RESTful API 规范（Swagger/OpenAPI）作用：其他 Agent 或客户端看到这个协议标识后，就知道该用什么方式与它对话。比如 MCP 协议走 MCP SDK，A2A 走 A2A SDK，OpenAPI 走标准 HTTP 请求。	mcp
Transports	array	否	传输方式
	string	否	该 Agent 端点支持的通信传输机制，与协议（protocol）联动： 1、协议：MCP，可选传输方式：STREAMABLE-HTTP、SSE，说明：MCP 协议支持流式 HTTP 和 Server-Sent Events 2、协议：A2A，可选传输方式：STREAMABLE-HTTP、SSE，说明：A2A 协议同样支持这两种 3、协议：OpenAPI，可选传输方式：REST、HTTP，说明：传统 REST API 通信方式	[\"STREAMABLE-HTTP\",\"SSE\"]
MetadataUrl	string	否	一个可选的 URL 地址，指向该 Agent 的元数据描述文件（通常是 JSON 格式）。作用：让其他 Agent 或客户端在连接前，可以通过这个 URL 自动发现该 Agent 的能力描述，包括： Agent 支持哪些功能（functions）输入/输出格式版本信息其他能力声明	// https://my-agent.example.com/.well-known/agent.json { "name": "智能客服助手", "version": "1.2.0", "protocol": "MCP", "description": "提供产品咨询、订单查询、售后服务的智能客服Agent", "capabilities": { "tools": [ { "name": "order_query", "description": "查询订单状态" }, { "name": "product_search", "description": "搜索产品信息" }, { "name": "refund_request", "description": "发起退款申请" } ], "resources": [ { "uri": "faq://knowledge-base", "description": "FAQ知识库" } ] }, "endpoint": { "url": "https://my-agent.example.com/mcp", "transport": ["STREAMABLE-HTTP", "SSE"] }, "policy": { "authentication": "mTLS", "rateLimit": "100/min" } }
AgentSubHost	string	否	Agent 端点子域名。仅共享域名模式需要，用于在共享的父域名下唯一标识 Agent。	agent.example.com
DomainMode	string	否	Agent 域名模式，用于确定访问主机名与身份主机名的关系。独立域名模式下两者相同；共享域名模式下需使用额外的子域名作为身份主机名。	INDEPENDENT

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	唯一请求识别码。	536E9CAD-DB30-4647-AC87-AA5CC38C5382
Success	boolean	请求是否成功，`true`：成功，`false`：失败	true
AccessDeniedDetail	object	访问被拒绝详细信息，只有 RAM 校验失败才会返回此字段。
AuthAction	string	尝试执行的未授权操作。	CreateUser
AuthPrincipalDisplayName	string	授权主体显示名称。	2015555733387XXXX
AuthPrincipalOwnerId	string	授权主体所有者 ID。	10469733312XXX
AuthPrincipalType	string	身份类型	SubUser
EncodedDiagnosticMessage	string	加密后的完整诊断信息。	AQEAAAAAaNIARXXXXUQwNjE0LUQzN0XXXXVEQy1BQzExLTMzXXXXNTkxRjk1Ng==
NoPermissionType	string	导致鉴权失败的原因。具体取值为： ExplicitDeny：显示拒绝 ImplicitDeny：隐式拒绝	ImplicitDeny
PolicyType	string	策略类型。	DlpSend

示例

正常返回示例

JSON格式

{
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "Success": true,
  "AccessDeniedDetail": {
    "AuthAction": "CreateUser",
    "AuthPrincipalDisplayName": "2015555733387XXXX",
    "AuthPrincipalOwnerId": "10469733312XXX",
    "AuthPrincipalType": "SubUser",
    "EncodedDiagnosticMessage": "AQEAAAAAaNIARXXXXUQwNjE0LUQzN0XXXXVEQy1BQzExLTMzXXXXNTkxRjk1Ng==",
    "NoPermissionType": "ImplicitDeny",
    "PolicyType": "DlpSend"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。