DescribeAtiAgentRegisterInfoMarket - 从Agent广场查询Agent信息-云解析DNS(DNS)-阿里云帮助中心

为sdk查询agent信息功能

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

alidns:DescribeAtiAgentRegisterInfoMarket

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。	eyJhbGciOiJIUzI1NiIsInR5cC.....
AgentHost	string	否	Agent 对外提供服务 Endpoint 域名名称	example.com
AgentVersion	string	否	Agent 版本	5.0.1
MaxResults	integer	否	本次请求所返回的最大记录条数。	100
NextToken	string	否	下一个查询开始 Token。	4698691
TrustLevel	string	否

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	唯一请求识别码。	0629502C-6224-5DC9-A8ED-2ED73A2E3931
AgentRegisterInfoId	string	AgentRegisterInfoId Agent 注册 ID。由阿里云 ATS 平台自动生成，在阿里云 ATS 平台具有全局唯一性。在 Agent 注册过程中自动生成，通过 API 注册的多步流程中，该 ID 必须全程携带，以确保各步骤关联至同一 Agent，完成完整的注册闭环。	2074753647748672512
AgentId	string	AgentID，经过 CNNIC 实名认证后，由 CNNIC 统一分配。AgentID 作为 Agent 与实名认证注册人绑定的唯一标识	gsc01629925@5e0964fd-951c-4e45-b518-d09d4d2db8ca
AgentDisplayName	string	Agent 显示名称	测试Agent
AgentHost	string	Agent 主机地址	www.example.com
AgentVersion	string	Agent 版本	3.9.3
AgentDescription	string	Agent 能力描述	支付服务
Status	string	解析记录状态。取值： Enable: 启用解析 Disable: 暂停解析	Disable
TrustLevel	string	信任级别基础认证增强认证高级认证	基础认证
Categories	object
category	array	忽略
	string	忽略	忽略
TrustCardContent	string	忽略	忽略
Endpoints	object
Endpoint	array<object>	各个协议的接入点。
	array<object>	各个协议的接入点。
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 请求。	https
AgentUrl	string	该 Agent 端点的实际服务地址，即 Agent 在线运行的 HTTPS 入口。必填字段，最大 500 字符。例如：https://my-agent.example.com/mcp 作用：调用方通过 DNS 发现到这个 Agent 后，拿到这个 URL 就可以直接发起连接。这是 Agent 真正"在线"的地址。	https://www.example.com/mcp
Transports	object
Transport	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
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" } }
AccessDeniedDetail	object	访问被拒绝详细信息，只有 RAM 校验失败才会返回此字段。
AuthAction	string	尝试执行的未授权操作。	AddRspDomainServerHoldStatusForGatewayOte
AuthPrincipalDisplayName	string	授权主体显示名称。	2015555733387XXXX
AuthPrincipalOwnerId	string	授权主体所有者 ID。	1046973331XXXX
AuthPrincipalType	string	身份类型	SubUser
EncodedDiagnosticMessage	string	加密后的完整诊断信息。	AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==
NoPermissionType	string	导致鉴权失败的原因。具体取值为： ExplicitDeny：显示拒绝 ImplicitDeny：隐式拒绝	ImplicitDeny
PolicyType	string	策略类型。	DlpSend
NextToken	string	下一个查询开始 Token。	4698691
MaxResults	integer	本次请求所返回的最大记录条数。	500

示例

正常返回示例

JSON格式

{
  "RequestId": "0629502C-6224-5DC9-A8ED-2ED73A2E3931",
  "AgentRegisterInfoId": "2074753647748672512",
  "AgentId": "gsc01629925@5e0964fd-951c-4e45-b518-d09d4d2db8ca",
  "AgentDisplayName": "测试Agent",
  "AgentHost": "www.example.com",
  "AgentVersion": "3.9.3",
  "AgentDescription": "支付服务",
  "Status": "Disable",
  "TrustLevel": "基础认证",
  "Categories": {
    "category": [
      "忽略"
    ]
  },
  "TrustCardContent": "忽略",
  "Endpoints": {
    "Endpoint": [
      {
        "Protocol": "https",
        "AgentUrl": "https://www.example.com/mcp",
        "Transports": {
          "Transport": [
            "STREAMABLE-HTTP\n"
          ]
        },
        "MetadataUrl": "// https://my-agent.example.com/.well-known/agent.json\n{\n  \"name\": \"智能客服助手\",\n  \"version\": \"1.2.0\",\n  \"protocol\": \"MCP\",\n  \"description\": \"提供产品咨询、订单查询、售后服务的智能客服Agent\",\n  \"capabilities\": {\n    \"tools\": [\n      { \"name\": \"order_query\", \"description\": \"查询订单状态\" },\n      { \"name\": \"product_search\", \"description\": \"搜索产品信息\" },\n      { \"name\": \"refund_request\", \"description\": \"发起退款申请\" }\n    ],\n    \"resources\": [\n      { \"uri\": \"faq://knowledge-base\", \"description\": \"FAQ知识库\" }\n    ]\n  },\n  \"endpoint\": {\n    \"url\": \"https://my-agent.example.com/mcp\",\n    \"transport\": [\"STREAMABLE-HTTP\", \"SSE\"]\n  },\n  \"policy\": {\n    \"authentication\": \"mTLS\",\n    \"rateLimit\": \"100/min\"\n  }\n}"
      }
    ]
  },
  "AccessDeniedDetail": {
    "AuthAction": "AddRspDomainServerHoldStatusForGatewayOte",
    "AuthPrincipalDisplayName": "2015555733387XXXX",
    "AuthPrincipalOwnerId": "1046973331XXXX",
    "AuthPrincipalType": "SubUser",
    "EncodedDiagnosticMessage": "AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==",
    "NoPermissionType": "ImplicitDeny",
    "PolicyType": "DlpSend"
  },
  "NextToken": "4698691",
  "MaxResults": 500
}

错误码

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

变更历史

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