A2A : découvrir et décrire des agents
Comprendre les cartes d’agents sans partager inutilement des données internes.
Une carte de présentation structurée
A2A décrit des objets AgentCard contenant notamment nom, description, compétences, interfaces prises en charge et exigences de sécurité. Une carte n’est pas un certificat universel de confiance ; ses affirmations doivent être contrôlées.
Découverte et accessibilité
Une carte peut être publiée à une adresse well-known telle que /.well-known/agent-card.json ou distribuée autrement. Les droits d’accès et capacités réelles dépendent du déploiement, pas seulement de l’existence du fichier.
Protocoles et tâches
Les agents interopérables doivent convenir d’une interface transport, des types de contenus acceptés, de l’état des tâches et des erreurs. L’organisation peut demander validation humaine ou authentification avant la délégation.
Menaces liées à la découverte
Les cartes distribuées par un acteur non fiable peuvent annoncer des compétences trompeuses. Contrôlez l’identité du serveur, les signatures éventuellement présentes et les périmètres de données avant d’envoyer une tâche sensible.
Une carte n’est pas une identité certifiée
Une Agent Card peut déclarer un nom, des compétences, des interfaces et des exigences de sécurité. Ces champs facilitent la découverte et la communication, mais ne prouvent pas l’honnêteté du fournisseur ou la réussite des tâches promises. Contrôlez l’URL, l’origine et les interfaces réellement accessibles avant de déléguer des données ou opérations sensibles.
Procédure de qualification d’un agent
Lisez une carte d’agent dans un environnement isolé, identifiez les capacités annoncées et tentez une tâche réversible sur des données fictives. Vérifiez le format des réponses, le traitement des erreurs et les paramètres d’autorisation. Consignez le décalage éventuel entre description et comportement observé, ainsi que les conditions de déploiement qui pourraient expliquer cette différence.
Les grandes étapes
- 01Consulter la carte
- 02Vérifier l’origine
- 03Comparer les interfaces
- 04Tester une tâche non sensible
Trois questions à poser
Qui publie la carte ?
L’authentification est-elle nécessaire ?
La capacité annoncée a-t-elle été testée ?
Consulter les textes originaux
Les versions, conditions de réutilisation et statuts des documents peuvent évoluer. Vérifiez-les sur les sites d’origine.