Consulte les informations de l'agent depuis la place de marché des agents pour le SDK.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
|
alidns:DescribeAtiAgentRegisterInfoMarket |
list |
*All Resource
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| ClientToken |
string |
Non |
Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer qu'il est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et sa longueur ne peut pas dépasser 64 caractères. |
eyJhbGciOiJIUzI1NiIsInR5cC.... |
| AgentHost |
string |
Non |
Le nom de domaine du point de terminaison par lequel l'agent fournit des services en externe. |
example.com |
| AgentVersion |
string |
Non |
La version de l'agent. |
5.0.1 |
| MaxResults |
integer |
Non |
Le nombre maximal d'entrées à renvoyer dans cette requête. |
100 |
| NextToken |
string |
Non |
Le jeton de pagination pour la requête suivante. |
4698691 |
|
Non |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
Schéma de la réponse. |
||
| RequestId |
string |
L'identifiant unique de la requête. |
0629502C-6224-5DC9-A8ED-2ED73A2E3931 |
| AgentRegisterInfoId |
string |
L'identifiant d'enregistrement de l'agent. Cet identifiant est généré automatiquement par la plateforme ATS d'Alibaba Cloud et est globalement unique au sein de la plateforme. Il est généré automatiquement lors du processus d'enregistrement de l'agent. Dans le processus d'enregistrement en plusieurs étapes via l'API, cet identifiant doit être transmis à toutes les étapes pour garantir que chaque étape est associée au même agent et que le processus d'enregistrement complet est mené à bien. |
2074753647748672512 |
| AgentId |
string |
L'identifiant de l'agent, qui est attribué de manière uniforme par le CNNIC après la vérification de l'identité réelle. L'AgentID sert d'identifiant unique qui lie l'agent au titulaire authentifié par son identité réelle. |
gsc01629925@5e0964fd-951c-4e45-b518-d09d4d2db8ca |
| AgentDisplayName |
string |
Le nom d'affichage de l'agent. |
TestAgent |
| AgentHost |
string |
L'adresse de l'hôte de l'agent. |
www.example.com |
| AgentVersion |
string |
La version de l'agent. |
3.9.3 |
| AgentDescription |
string |
La description des capacités de l'agent. |
Service de paiement |
| Status |
string |
L'état de l'enregistrement DNS. Valeurs valides :
|
Disable |
| TrustLevel |
string |
Le niveau de confiance. Valeurs valides :
|
Authentification de base |
| Categories |
object |
||
| category |
array |
À ignorer. |
|
|
string |
À ignorer. |
Ignorer |
|
| TrustCardContent |
string |
À ignorer. |
Ignorer |
| Endpoints |
object |
||
| Endpoint |
array<object> |
Les points de terminaison pour chaque protocole. |
|
|
array<object> |
Les points de terminaison pour chaque protocole. |
||
| Protocol |
string |
La norme de protocole de communication suivie par le point de terminaison de l'agent, qui détermine la manière dont les appelants invoquent l'agent. Valeurs valides :
Les autres agents ou clients utilisent cette identité de protocole pour déterminer comment communiquer avec l'agent. Par exemple, le protocole MCP utilise le SDK MCP, A2A utilise le SDK A2A, et OpenAPI utilise des requêtes HTTP standard. |
https |
| AgentUrl |
string |
L'adresse de service réelle du point de terminaison de l'agent, qui correspond au point d'entrée HTTPS où l'agent s'exécute en ligne. Il s'agit d'un champ obligatoire comportant un maximum de 500 caractères. Exemple : https://my-agent.example.com/mcp Les appelants peuvent initier une connexion directement via cette URL après avoir découvert l'agent via le DNS. Il s'agit de l'adresse où l'agent est réellement en ligne. |
https://www.example.com/mcp |
| Transports |
object |
||
| Transport |
array |
La méthode de transport. |
|
|
string |
Le mécanisme de transport de communication pris en charge par le point de terminaison de l'agent, qui fonctionne conjointement avec le protocole. Le tableau suivant décrit le mappage entre les protocoles et les méthodes de transport disponibles :
|
STREAMABLE-HTTP |
|
| MetadataUrl |
string |
Une URL facultative qui pointe vers le fichier de description des métadonnées de l'agent (généralement au format JSON). Cela permet aux autres agents ou clients de découvrir automatiquement la description des capacités de l'agent avant de se connecter, y compris : les fonctions prises en charge par l'agent, les formats d'entrée/sortie, les informations de version et autres déclarations de capacités. |
// https://my-agent.example.com/.well-known/agent.json { "name": "Assistant de service client intelligent", "version": "1.2.0", "protocol": "MCP", "description": "Un agent de service client intelligent qui fournit des consultations sur les produits, des recherches de commandes et des services après-vente", "capabilities": { "tools": [ { "name": "order_query", "description": "Consulter l'état de la commande" }, { "name": "product_search", "description": "Rechercher des informations sur les produits" }, { "name": "refund_request", "description": "Initier une demande de remboursement" } ], "resources": [ { "uri": "faq://knowledge-base", "description": "Base de connaissances FAQ" } ] }, "endpoint": { "url": "https://my-agent.example.com/mcp", "transport": ["STREAMABLE-HTTP", "SSE"] }, "policy": { "authentication": "mTLS", "rateLimit": "100/min" } } |
| AccessDeniedDetail |
object |
Les détails concernant le refus d'accès. Ce champ n'est renvoyé que lorsque l'authentification RAM échoue. |
|
| AuthAction |
string |
L'opération non autorisée qui a été tentée. |
AddRspDomainServerHoldStatusForGatewayOte |
| AuthPrincipalDisplayName |
string |
Le nom d'affichage du principal d'autorisation. |
2015555733387XXXX |
| AuthPrincipalOwnerId |
string |
L'identifiant du propriétaire du principal d'autorisation. |
1046973331XXXX |
| AuthPrincipalType |
string |
Le type d'identité. |
SubUser |
| EncodedDiagnosticMessage |
string |
Le message de diagnostic complet chiffré. |
AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ== |
| NoPermissionType |
string |
La raison de l'échec de l'authentification. Valeurs valides :
|
ImplicitDeny |
| PolicyType |
string |
Le type de stratégie. |
DlpSend |
| NextToken |
string |
Le jeton de pagination pour la requête suivante. |
4698691 |
| MaxResults |
integer |
Le nombre maximal d'entrées à renvoyer dans cette requête. |
500 |
Exemples
JSON format
{
"RequestId": "0629502C-6224-5DC9-A8ED-2ED73A2E3931",
"AgentRegisterInfoId": "2074753647748672512",
"AgentId": "gsc01629925@5e0964fd-951c-4e45-b518-d09d4d2db8ca",
"AgentDisplayName": "TestAgent",
"AgentHost": "www.example.com",
"AgentVersion": "3.9.3",
"AgentDescription": "Service de paiement",
"Status": "Disable",
"TrustLevel": "Authentification de base",
"Categories": {
"category": [
"Ignorer"
]
},
"TrustCardContent": "Ignorer",
"Endpoints": {
"Endpoint": [
{
"Protocol": "https",
"AgentUrl": "https://www.example.com/mcp",
"Transports": {
"Transport": [
"STREAMABLE-HTTP"
]
},
"MetadataUrl": "// https://my-agent.example.com/.well-known/agent.json\n{\n \"name\": \"Assistant de service client intelligent\",\n \"version\": \"1.2.0\",\n \"protocol\": \"MCP\",\n \"description\": \"Un agent de service client intelligent qui fournit des consultations sur les produits, des recherches de commandes et des services après-vente\",\n \"capabilities\": {\n \"tools\": [\n { \"name\": \"order_query\", \"description\": \"Consulter l'état de la commande\" },\n { \"name\": \"product_search\", \"description\": \"Rechercher des informations sur les produits\" },\n { \"name\": \"refund_request\", \"description\": \"Initier une demande de remboursement\" }\n ],\n \"resources\": [\n { \"uri\": \"faq://knowledge-base\", \"description\": \"Base de connaissances de la 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
}Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.