SearchAtiAgentRegisterInfoMarket - Alibaba Cloud DNS - Alibaba Cloud Documentation Center

Searches for agents in the Agent Marketplace.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
ClientToken	string	No	Ensures the idempotency of the request. Generate a unique parameter value from your client to ensure uniqueness across different requests. ClientToken supports only ASCII characters and cannot exceed 64 characters in length. If you do not specify this parameter, the system automatically uses the RequestId of the API request as the ClientToken. The RequestId may differ for each API request.	eyJhbGciOiJIUzI1NiIsInR5cC.....
PageSize	integer	Yes	The number of entries per page for a paged query. Maximum value: 100. Default value: 20.	10
PageNumber	integer	Yes	The current page number. Minimum value: 1. Default value: 1.	1
Keyword	string	No	The keyword for searching. Matches against the agent name, domain name, and description.	example.com
Protocol	string	No	The communication protocol that the agent endpoint follows, which determines how callers interact with the agent. Valid values: MCP: Model Context Protocol, an agent tool calling protocol developed by Anthropic. A2A: Agent-to-Agent Protocol, a cross-agent communication protocol developed by Google. OpenAPI: Standard RESTful API specification (Swagger/OpenAPI). Other agents or clients use this protocol identifier to determine how to communicate with the agent. For example, MCP uses the MCP SDK, A2A uses the A2A SDK, and OpenAPI uses standard HTTP requests.	mcp
TrustLevel	string	No	Queries agents based on the trust level.	基础认证
Status	string	No	Queries agents based on the agent status.	活跃
MaxResults	integer	No	The number of entries per batch query.	20
NextToken	string	No	The pagination token for the next query.	4698691

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	The request ID.	6856BCF6-11D6-4D7E-AC53-FD579933522B
PageNumber	integer	The current page number. Minimum value: 1. Default value: 1.	1
PageSize	integer	The number of entries per page for a paged query. Maximum value: 100. Default value: 20.	20
TotalPages	integer	The total number of pages.	11
TotalItems	integer	The total number of entries.	2
Agents	object
Agent	array<object>	Agent
	array<object>	Agent
AgentId	string	The agent ID. After CNNIC real-name verification, CNNIC assigns a unified agent ID. The agent ID serves as the unique identifier that binds the agent to the verified registrant.	ag-6c6392b1d226d6e60f7020ce
AgentDisplayName	string	The display name of the agent.	TestAgent
AgentHost	string	The endpoint domain name through which the agent provides services.	example.com
AgentVersion	string	The agent version.	1.0.0
Status	string	The agent status.	活跃
TrustLevel	string	The trust level. Basic verification Enhanced verification Advanced verification	基础认证
Protocols	object
Protocol	array	The agent communication protocol.
	string	The communication protocol standard that the agent endpoint follows, which determines how callers interact with the agent. Valid values: MCP: Model Context Protocol, an agent tool calling protocol developed by Anthropic. A2A: Agent-to-Agent Protocol, a cross-agent communication protocol developed by Google. OpenAPI: Standard RESTful API specification (Swagger/OpenAPI). Other agents or clients use this protocol identifier to determine how to communicate with the agent. For example, MCP uses the MCP SDK, A2A uses the A2A SDK, and OpenAPI uses standard HTTP requests.	MCP
CreateTimestamp	integer	The creation time (timestamp).	1763086989000
UpdateTimestamp	integer	The modification time (timestamp).	1666962469000
AgentDescription	string	The capability description of the agent.	PaymentService
TrustCardUrl	string	Ignore.	Ignore
AccessDeniedDetail	object	The details of the access denial. This field is returned only when RAM authentication fails.
AuthAction	string	The unauthorized operation that was attempted.	CreateUser
AuthPrincipalDisplayName	string	The display name of the authorization principal.	2015555733387XXXX
AuthPrincipalOwnerId	string	The owner ID of the authorization principal.	10469733312XXX
AuthPrincipalType	string	The identity type.	SubUser
EncodedDiagnosticMessage	string	The encrypted complete diagnostic message.	AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==
NoPermissionType	string	The reason for the authentication failure. Valid values: ExplicitDeny: explicit deny. ImplicitDeny: implicit deny.	ImplicitDeny
PolicyType	string	The policy type.	DlpSend
MaxResults	integer	The number of entries per batch query.	500
NextToken	string	The pagination token for the next query.	4698691

Examples

Success response

JSON format

{
  "RequestId": "6856BCF6-11D6-4D7E-AC53-FD579933522B",
  "PageNumber": 1,
  "PageSize": 20,
  "TotalPages": 11,
  "TotalItems": 2,
  "Agents": {
    "Agent": [
      {
        "AgentId": "ag-6c6392b1d226d6e60f7020ce",
        "AgentDisplayName": "测试Agent",
        "AgentHost": "example.com",
        "AgentVersion": "1.0.0",
        "Status": "活跃",
        "TrustLevel": "基础认证",
        "Protocols": {
          "Protocol": [
            "MCP"
          ]
        },
        "CreateTimestamp": 1763086989000,
        "UpdateTimestamp": 1666962469000,
        "AgentDescription": "支付服务",
        "TrustCardUrl": "忽略"
      }
    ]
  },
  "AccessDeniedDetail": {
    "AuthAction": "CreateUser",
    "AuthPrincipalDisplayName": "2015555733387XXXX",
    "AuthPrincipalOwnerId": "10469733312XXX",
    "AuthPrincipalType": "SubUser",
    "EncodedDiagnosticMessage": "AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==",
    "NoPermissionType": "ImplicitDeny",
    "PolicyType": "DlpSend"
  },
  "MaxResults": 500,
  "NextToken": "4698691"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.