ALLER AU CONTENU
AGENTS IA7 minStandards en production / Ép. 10 · Niveau 10-4

Agent Card et ERC-8004 : vérifier qu’ils concordent

N’importe qui peut inscrire un agent et le faire pointer vers la carte d’un autre. Un fichier sur le domaine de la carte vous dit quelle entrée il reconnaît.

XIN
Scène nocturne en pixel art devant la porte d’une ville : un petit robot coursier tend une carte scellée lumineuse, et un gardien compare son sceau à une tablette de registre gravée dans la pierre. Un fil cyan relie la carte et la tablette, et la porte reste fermée.

EN 30 SECONDES

Relier une Agent Card à une entrée ERC-8004, c’est vérifier le lien dans les deux sens : le fichier cite la carte, et le domaine de la carte cite l’entrée. Puis huit contrôles, et on s’arrête à l’identité.

À RETENIR · 3

  • Vous reliez vous-même carte et entrée : le fichier d’enregistrement donne l’URL de la carte, et le domaine de la carte renvoie à l’entrée.
  • Le contrôle retour est optionnel dans le brouillon ERC-8004, et inutile sur un domaine partagé. Sans contrôle retour ni domaine partagé, n’importe qui peut viser votre carte.
  • Le dernier des huit contrôles, c’est de s’arrêter : vous savez qui a publié l’agent, pas qu’il a le droit d’agir.
Sur cette page

Relier la carte à l’entrée on-chain

EN BREF Aucun des deux documents ne renvoie à l’autre par une signature : c’est à vous de vérifier le lien, dans les deux sens.

LES MOTS À CONNAÎTRE

Agent Card
Un petit fichier JSON où l’agent se décrit. Il peut être signé.
Entrée ERC-8004
Une fiche on-chain du brouillon ERC-8004 : un token transférable, avec un propriétaire et un lien vers un fichier.
Fichier d’enregistrement
Le fichier visé par une entrée ERC-8004. Il liste les services de l’agent, dont l’URL de sa carte.

L’Agent Card Un petit fichier JSON où l’agent se décrit. Il peut être signé. Voir le glossaire A2A de base n’a pas de champ pour un registre on-chain. Et une Entrée ERC-8004 Une fiche on-chain du brouillon ERC-8004 : un token transférable, avec un propriétaire et un lien vers un fichier. Voir le glossaire, issue d’un brouillon qui peut encore changer (relisez la version courante avant de construire), renvoie à un fichier d’enregistrement qui liste l’URL de la carte.

RELIER CARTE ET ENTRÉE

Diagramme de séquence : 4 participants : Vous, qui vérifiez, Registre on-chain, Hôte du fichier, Domaine de l’agentDiagramme de séquence : 4 participants : Vous, qui vérifiez, Registre on-chain, Hôte du fichier, Domaine de l’agent. Étape 1 : Vous, qui vérifiez vers Registre on-chain, Qui détient l’agent 42 ? Où est son fichier ?. Étape 2 : Registre on-chain vers Vous, qui vérifiez, Propriétaire, lien, portefeuille. Étape 3 : Vous, qui vérifiez vers Hôte du fichier, Récupérer le fichier. Étape 4 : Vous, qui vérifiez vers lui-même, Trouver le service A2A. Étape 5 : Vous, qui vérifiez vers Domaine de l’agent, Vérifier la carte signée. Étape 6 : Vous, qui vérifiez vers Domaine de l’agent, Lire sa liste d’entrées. Étape 7 : Domaine de l’agent vers Vous, qui vérifiez, Même registre et même agentId.VOUS, QUI VÉRIFIEZ > REGISTREON-CHAINQui détient l’agent 42 ? Oùest son fichier ?REGISTRE ON-CHAIN > VOUS, QUIVÉRIFIEZPropriétaire, lien,portefeuilleVOUS, QUI VÉRIFIEZ > HÔTE DUFICHIERRécupérer le fichierVOUS, QUI VÉRIFIEZ > VOUS,QUI VÉRIFIEZTrouver le service A2ACet agentId et cette URL decarte ?VOUS, QUI VÉRIFIEZ > DOMAINEDE L’AGENTVérifier la carte signéeVOUS, QUI VÉRIFIEZ > DOMAINEDE L’AGENTLire sa liste d’entréesSauf même domaineDOMAINE DE L’AGENT > VOUS,QUI VÉRIFIEZMême registre et même agentId

Étape 1. Lire le registre. Obtenez propriétaire, lien et portefeuille de paiement.

Choisissez une étape pour la voir bouger
  1. Lire le registre Obtenez propriétaire, lien et portefeuille de paiement.
  2. Récupérer le fichier Téléchargez le fichier visé par le lien.
  3. Contrôle aller Il doit lister cet agentId et cette URL exacte de carte.
  4. Vérifier la carte Vérifiez la signature de la carte avec la clé épinglée (ma politique).
  5. Contrôle retour Le domaine de la carte doit citer le même registre et le même agentId, sauf s’il partage le domaine du fichier.
Un contrôle complet, tel que je le ferais. Le contrôle retour est l’Endpoint Domain Verification, optionnelle, du brouillon ERC-8004.

EN CLAIR

L’entrée dit « ma carte est ici ». Le domaine de la carte confirme « cette entrée est à moi », sauf si les deux partagent un domaine.

Pour ce contrôle retour optionnel, le domaine publie /.well-known/agent-registration.json avec le même registre et agentId. Si la carte partage le domaine du Fichier d’enregistrement Le fichier visé par une entrée ERC-8004. Il liste les services de l’agent, dont l’URL de sa carte. Voir le glossaire, le brouillon juge ce contrôle inutile : la maîtrise du domaine est déjà démontrée.

Sans l’un ni l’autre, n’importe qui peut inscrire un agent et le faire pointer vers la carte d’un autre. Autre détail : l’exemple du brouillon indique A2A 0.3.0, alors que la version actuelle est la v1.0.1, de mai 2026. Fiez-vous au protocolVersion des supportedInterfaces de la carte.

Coming up next: À quoi ressemble un faux lien, en pratique ?

Un exemple concret : une carte, deux entrées

EN BREF Une même carte authentique peut se trouver derrière deux entrées, et ici seul le contrôle retour dit laquelle son domaine reconnaît.

UN EXEMPLE CONCRET

Chiffres illustratifs

VALIDÉL’agent d’Example Ops, contrôlé de bout en bout

ENTRÉE

Carte
https://agent.example/.well-known/agent-card.json
Entrée
agentId 42 sur eip155:1:0x742...

CE QUI SE PASSE

  1. La signature de la carte se vérifie avec la clé épinglée.
  2. Le fichier d’enregistrement liste l’agentId 42 et cette URL de carte.
  3. L’agent-registration.json d’agent.example renvoie bien à l’agentId 42.

SORTIE

Résultat
relié : le domaine de la carte cite cette entrée
Reste à vérifier
mandat et appelant réel

NON RELIÉQuelqu’un d’autre inscrit l’agentId 977, qui pointe vers la même carte

ENTRÉE

Entrée
agentId 977, autre propriétaire
Carte
même URL que ci-dessus

CE QUI SE PASSE

  1. La carte se vérifie toujours : c’est la vraie.
  2. Le nouveau fichier donne l’URL de la carte : le contrôle aller passe.
  3. La liste d’agent.example ne cite que l’agentId 42.

SORTIE

Résultat
rejeter l’agentId 977 : ce n’est pas cet agent

N’importe qui peut reprendre une carte signée et pointer vers elle. Seul le domaine de la carte peut publier le fichier qui renvoie à l’entrée.

Coming up next: Alors, dans quel ordre faire tout cela ?

La checklist que j’appliquerais avant de me fier à un agent

EN BREF Huit contrôles que je ferais dans l’ordre, chacun avec une conduite en cas d’échec, et le dernier : s’arrêter, car l’identité n’est pas le droit d’agir.

1. Signature de la carte
Une signature se vérifie sur la copie canonique, avec une clé épinglée (ma politique)
Déclarations non vérifiées
2. État de la clé
La clé est active, ni expirée ni révoquée
Rejeter : la spécification interdit (MUST NOT) ces clés
3. L’entrée existe
Le registre renvoie un propriétaire et un lien pour l’agentId, sur le bon réseau
Pas d’entrée on-chain exploitable : la carte seule
4. Lien aller
Le fichier d’enregistrement liste cet agentId et cette URL de carte
Lien non établi
5. Lien retour
Même domaine, ou agent-registration.json correspond
Lien possible vers la carte d’un autre
6. Propriété stable
Aucun Transfer depuis votre dernière revue ; portefeuille conforme
Revalider : l’opérateur a pu changer
7. Réputation
Score filtré par des évaluateurs de confiance
Ignorer les scores non filtrés
8. S’arrêter ici
Vous savez qui a publié l’agent
Les contrôles de mandat et d’appelant viennent ensuite

OBJET OBTENU

Ne laissez jamais le document choisir sa propre ancre de confiance

Une carte qui désigne sa propre URL de clé, une entrée qui désigne sa propre carte, un score d’évaluateurs anonymes : chacun se vérifie sans erreur et ne prouve rien seul.

FAQ

Non. Elle montre qui a inscrit l’agent, qui détient l’inscription et vers quel fichier elle pointe. ERC-8004, encore brouillon, dit ne pas pouvoir garantir par la cryptographie que les capacités annoncées marchent et ne sont pas malveillantes : le droit d’agir vient d’un mandat (qui délègue, pour quoi, quel plafond, quelle échéance).

Sources, relues le 7 octobre 2026 : ERC-8004 (brouillon), spécification A2A v1.0.1. Ceci n’est pas un conseil juridique.

NIVEAU TERMINÉ

Ce que vous savez maintenant

  • On relie une carte et une entrée en vérifiant le lien dans les deux sens.
  • Le contrôle retour repère une entrée qui vise la carte de quelqu’un d’autre.
  • Huit contrôles dans l’ordre, et le dernier est un arrêt : l’identité, pas la permission.

Vérifiez par vous-même

Touchez ou cliquez une question pour voir la réponse.

Le fichier d’enregistrement est sur le domaine de la carte, qui n’a pas d’agent-registration.json. Rejetez-vous le lien ?

Pas pour cette raison. Sur un domaine partagé, le brouillon juge le contrôle retour inutile : le contrôle du domaine est déjà démontré.

Vous avez fini tous les niveaux publiés de cette série. Retour à la carte de la série

Adam Boudjemaa
Adam Boudjemaa

Ingénieur web3 x IA, ancien CTO d’Integra. Auteur nommé (1 sur 5) d’ERC-3643, premier auteur d’ERC-6960, co-auteur d’ERC-7410 et co-auteur d’ERC-8203, encore à l’état de brouillon.

Un projet à livrer ou un poste à pourvoir ?

Parlons de votre besoin

Mon travail entre web3 et IAMes outils open source

LinkedInTwitterGitHub
Suivre les notes techniques

Recevez les nouveaux articles sur l’IA en production et les smart contracts par email.