Rendez votre agent détectable
Un Agent Card clair donne aux clients A2A un point de départ fiable : à qui appartient l'agent, où il se trouve, et quels bindings de protocole et versions il parle.
Ce qu'un générateur d'Agent Card crée pour votre agent IA
Un Agent Card est la description d'interface publique d'un agent A2A. Avant qu'un autre agent puisse décider d'appeler votre service, il lui faut plus qu'une URL : il lui faut un compte-rendu fiable de l'objectif de l'agent, de son contrat technique, de ses skills et de ses exigences d'accès.
Ce générateur d'Agent Card transforme ces détails d'implémentation en JSON lisible au format A2A v1.0, tout en gardant la prise de décision proche du formulaire. Utilisez-le après avoir construit la logique centrale de l'agent et avant de le déployer ou de le référencer — le point où un fichier JSON écrit à la main casse généralement.
Décrivez une interface utilisable
Capturez l'interface préférée, les modes de contenu, le comportement de streaming et le support des notifications push dont un autre agent a besoin avant de passer un appel.
Fixez des attentes d'accès
Documentez si le service est public, utilise une clé API, ou nécessite OAuth 2.0, afin que les intégrations puissent choisir le bon flux d'authentification — sans jamais placer d'identifiant dans la Agent Card.
Transformez les skills en contrats clairs
Nommez le travail que votre agent peut effectuer, ajoutez les tags requis par v1.0 ainsi que des exemples utiles, et rendez ses limites compréhensibles pour les personnes, les marketplaces et les clients IA.
Comment fonctionne le Générateur d'Agent Card
Des détails du service à un Agent Card publiable
Le Générateur d'Agent Card transforme les détails du service en un document JSON clair et publiable. Suivez ce court flux de travail avant d'envoyer l'Agent Card en production.
- 1
Commencez par le vrai service
Ajoutez l'endpoint A2A public, le binding de protocole, les détails du fournisseur, la version de l'agent, et les types de contenu que votre serveur accepte et renvoie.
- 2
Définissez les limites des capacités et skills
Sélectionnez uniquement les capacités que votre implémentation supporte, puis décrivez un skill représentatif dans un langage simple et spécifique.
- 3
Vérifiez le JSON généré
Utilisez l'aperçu en direct pour repérer les champs manquants, les URL d'espace réservé, ou les descriptions qui ne reflètent pas fidèlement le service déployé.
- 4
Validez et publiez
Faites passer la Agent Card par le validateur, puis placez le document révisé sur /.well-known/agent-card.json sur le domaine de votre service.
Qui utilise le Générateur d'Agent Card
Conçu pour tous ceux qui créent, publient ou révisent des Agent Cards
Le Générateur d'Agent Card aide les développeurs, les équipes de plateforme et les relecteurs à créer des métadonnées d'agent A2A cohérentes sans partir d'un fichier JSON vide.
Développeurs IA et indépendants
Remplacez un agent-card.json écrit à la main par un point de départ complet et conforme à la spécification lors du lancement d'un agent compatible A2A.
Prompt engineers et product managers
Rédigez un document de découverte crédible à partir d'une description de service sans toucher à la syntaxe JSON, puis remettez-le à l'ingénierie pour révision.
Équipes plateforme et DevOps
Standardisez la façon dont les agents internes décrivent les endpoints, l'authentification et les skills avant qu'ils n'entrent dans un catalogue d'agents d'entreprise ou un pipeline CI.
Éditeurs de marketplace
Préparez des métadonnées de fournisseur, des tags de skills et des déclarations de sécurité que les relecteurs et les systèmes de classement peuvent réellement analyser.
FAQ
Questions sur le générateur d'Agent Card
Réglez bien l'essentiel avant qu'un client A2A ne trouve votre endpoint.
Qu'est-ce qu'un A2A Agent Card ?
Un A2A Agent Card est un document de découverte JSON pour un agent IA. Il communique l'identité, les informations du fournisseur, les interfaces supportées, les capacités, les skills, les modes de contenu acceptés, et les exigences de sécurité aux clients potentiels — l'équivalent agent à agent d'un README plus un aperçu d'API.
Pourquoi utiliser un générateur d'Agent Card plutôt que d'écrire du JSON à la main ?
Les Agent Cards écrites à la main manquent régulièrement de champs requis, utilisent des noms de champs antérieurs à v1.0, ou contiennent des erreurs de syntaxe. Le générateur produit la forme actuelle A2A v1.0 — supportedInterfaces, provider.organization, tags de skill requis — et valide au fur et à mesure que vous tapez, de sorte que les erreurs structurelles n'atteignent jamais la production.
Quelle version A2A cible la Agent Card générée ?
Le générateur émet la structure A2A v1.0 : un tableau ordonné supportedInterfaces avec protocolBinding et protocolVersion par interface, une version d'agent de niveau supérieur, et des capabilities incluant extendedAgentCard. Les Agent Cards avec des champs url ou preferredTransport de niveau supérieur sont antérieures à v1.0.
Le JSON généré nécessite-t-il une révision avant la production ?
Oui. Le générateur crée un document de départ pratique, pas un substitut à votre contrat déployé. Confirmez que les endpoints, bindings de protocole, skills et authentification correspondent au service que les utilisateurs atteindront réellement.
Où dois-je publier un Agent Card ?
Publiez le JSON révisé sur le même domaine que votre service A2A à https://votre-domaine/.well-known/agent-card.json, le chemin well-known enregistré par la spécification A2A. De nombreuses intégrations plus anciennes vérifient aussi /.well-known/agent.json, donc servir les deux est une stratégie de transition sûre.
Prêt à publier
Retournez au Générateur d'Agent Card avant de publier.
Terminez les détails, révisez le JSON généré, et utilisez la validation en direct avant de publier votre Agent Card.