DescribeAtiAgentRegisterInfo - - Centre de documentation Alibaba Cloud

Consulte les détails des informations d'enregistrement de l'agent.

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

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. Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement la valeur de RequestId comme valeur de ClientToken. La valeur de RequestId peut être différente pour chaque requête.	eyJhbGciOiJIUzI1NiIsInR5cC....
AgentRegisterInfoId	string	Oui	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

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	536E9CAD-DB30-4647-AC87-AA5CC38C5382
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 l'authentification par nom réel. L'identifiant de l'agent sert d'identifiant unique qui lie l'agent au titulaire authentifié.	019f3672-9705-7a7a-88fd-9a6a211aa5f2
AgentDisplayName	string	Le nom d'affichage de l'agent.	TestAgent
AgentHost	string	Le nom de domaine du point de terminaison par lequel l'agent fournit des services externes.	example.com
AgentVersion	string	La version de l'agent.	1.0.1
AgentDescription	string	La description des capacités de l'agent.	Service de paiement
Status	string	L'état de l'agent. Valeurs valides : Draft : Le formulaire d'enregistrement de l'agent est en cours de remplissage et n'a pas été officiellement soumis. À l'état de brouillon, seules les opérations de modification et de consultation des détails sont prises en charge. Private CA Pending Issuance : L'enregistrement de l'agent a été officiellement soumis. Alibaba Cloud a terminé le pré-contrôle ACME DNS-01, a soumis les informations d'enregistrement et a généré les enregistrements DNS pour le CNNIC. En attente de l'approbation et de l'émission de l'autorité de certification privée par le CNNIC et de la finalisation du scellement TL. DNS Pending Verification : Le CNNIC a approuvé et émis le certificat de l'autorité de certification privée et a finalisé le scellement TL, mais les enregistrements DNS de l'utilisateur n'ont pas été vérifiés. En attente que l'utilisateur ajoute les enregistrements DNS correspondants dans la résolution de nom de domaine et termine la vérification. Active : Tous les processus sont terminés. Le certificat de l'autorité de certification privée a été émis, le TL a été scellé et les enregistrements DNS ont été vérifiés. L'agent est activé et peut être découvert et vérifié en termes de confiance sur l'ensemble du réseau. Expired : Le certificat d'identité de l'agent a expiré et l'utilisateur n'a pas renouvelé le certificat pendant la période de validité. Revoked : Le certificat de l'agent a été révoqué, les enregistrements DNS ont été nettoyés, et l'agent ne peut plus être découvert ni vérifié en termes de confiance. Il ne peut pas être restauré à l'état actif.	Active
AtiName	string	Le nom ATI, qui est un identifiant globalement unique dans le système de confiance ATI. Exemple : ati://v1.0.0.www.example.com ati:// — Le préfixe de protocole qui identifie cette ressource dans le système ATI. v1.0.0 — Le numéro de version de l'agent. www.example.com — Le nom de domaine (FQDN) lié à l'agent.	ati://v1.0.0.www.example.com
RegistrantId	string	L'identifiant du titulaire authentifié.	2072277378616354816
RegistrantName	string	Le nom du titulaire.	Zhang xx
CreateTimestamp	integer	L'heure de création (horodatage).	1527690629357
UpdateTimestamp	integer	L'heure de mise à jour (horodatage).	1527690629357
TrustCardUrl	string	[Obsolète]	Obsolète
Endpoints	object
Endpoint	array<object>	Les points d'accès pour chaque protocole.
	array<object>	Les points d'accès 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 interagissent avec l'agent. Valeurs valides : MCP : Model Context Protocol, un protocole d'appel d'outils d'agent introduit par Anthropic. A2A : Agent-to-Agent Protocol, un protocole de communication inter-agents introduit par Google. OpenAPI : Spécification d'API RESTful standard (Swagger/OpenAPI). Objectif : Lorsque d'autres agents ou clients voient cette identité de protocole, ils savent quelle méthode utiliser pour invoquer l'agent. Par exemple, le protocole MCP utilise le SDK MCP, A2A utilise le SDK A2A, et OpenAPI utilise des requêtes HTTP standard.	MCP
AgentUrl	string	L'adresse de service réelle du point de terminaison de l'agent, qui est le point d'entrée HTTPS où l'agent s'exécute en ligne. Il s'agit d'un champ obligatoire contenant un maximum de 500 caractères. Exemple : https://my-agent.example.com/mcp Objectif : Après qu'un appelant a découvert cet agent via le DNS, il peut utiliser cette URL pour initier directement une connexion. Il s'agit de l'adresse où l'agent est réellement « en ligne ».	https://www.example.com/mcp
Transports	object
Transport	array	Les méthodes de transport.
	string	Le mécanisme de transport de communication pris en charge par le point de terminaison de l'agent, qui fonctionne en conjonction avec le protocole. Le tableau suivant décrit le mappage entre les protocoles et les méthodes de transport disponibles : 1. Protocole : MCP. Méthodes de transport disponibles : STREAMABLE-HTTP, SSE. Description : Le protocole MCP prend en charge le streaming HTTP et les Server-Sent Events. 2. Protocole : A2A. Méthodes de transport disponibles : STREAMABLE-HTTP, SSE. Description : Le protocole A2A prend également en charge ces deux méthodes. 3. Protocole : OpenAPI. Méthodes de transport disponibles : REST, HTTP. Description : Méthodes de communication traditionnelles pour les API REST.	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). Objectif : Permet à d'autres agents ou clients de découvrir automatiquement la description des capacités de l'agent via cette URL 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 de la FAQ" } ] }, "endpoint": { "url": "https://my-agent.example.com/mcp", "transport": ["STREAMABLE-HTTP", "SSE"] }, "policy": { "authentication": "mTLS", "rateLimit": "100/min" } }
RejectReason	object	La raison de l'échec de l'examen de l'enregistrement de l'agent.
Type	string	Le type d'échec de l'examen. Valeurs valides : ACME_VERIFY_FAILED : Échec de la vérification ACME. INFO_AUDIT_FAILED : Échec de l'examen des informations de l'agent.	ACME_VERIFY_FAILED
Message	string	Les informations détaillées sur l'échec de l'enregistrement de l'agent.	État non valide
IdentityCertSerialNumber	string	À ignorer.	Ignorer
ServerCertSerialNumber	string	À ignorer.	Ignorer
TrustCard	string	À ignorer.	Ignorer
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.	RemoveRspDomainServerHoldStatusForGateway
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 : ExplicitDeny : Refus explicite. ImplicitDeny : Refus implicite.	ImplicitDeny
PolicyType	string	Le type de stratégie.	DlpSend
TrustLevel	string
DomainMode	string
AgentSubHost	string

Exemples

JSON format

{
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "AgentRegisterInfoId": "2074753647748672512",
  "AgentId": "019f3672-9705-7a7a-88fd-9a6a211aa5f2",
  "AgentDisplayName": "Agent de test",
  "AgentHost": "example.com",
  "AgentVersion": "1.0.1",
  "AgentDescription": "Service de paiement",
  "Status": "Actif",
  "AtiName": "ati://v1.0.0.www.example.com",
  "RegistrantId": "\t\n2072277378616354816",
  "RegistrantName": "Zhang xx",
  "CreateTimestamp": 1527690629357,
  "UpdateTimestamp": 1527690629357,
  "TrustCardUrl": "Obsolète",
  "Endpoints": {
    "Endpoint": [
      {
        "Protocol": "MCP",
        "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\": \"Agent de service client intelligent fournissant des conseils sur les produits, le suivi des commandes et le service après-vente\",\n  \"capabilities\": {\n    \"tools\": [\n      { \"name\": \"order_query\", \"description\": \"Vérifier 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 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}"
      }
    ]
  },
  "RejectReason": {
    "Type": "ACME_VERIFY_FAILED",
    "Message": "État non valide"
  },
  "IdentityCertSerialNumber": "Ignorer",
  "ServerCertSerialNumber": "Ignorer",
  "TrustCard": "Ignorer",
  "AccessDeniedDetail": {
    "AuthAction": "RemoveRspDomainServerHoldStatusForGateway",
    "AuthPrincipalDisplayName": "2015555733387XXXX",
    "AuthPrincipalOwnerId": "1046973331XXXX",
    "AuthPrincipalType": "SubUser",
    "EncodedDiagnosticMessage": "AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==",
    "NoPermissionType": "ImplicitDeny",
    "PolicyType": "DlpSend"
  },
  "TrustLevel": "",
  "DomainMode": "",
  "AgentSubHost": ""
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.