Agent card
Concept
Dans le protocole A2A, une carte d'agent (agent card) est un document lisible par machine, publié à une URL bien connue, qui décrit le nom de l'agent, ses capacités, ses compétences, son point de terminaison, ses exigences d'authentification et ses formats d'entrée et de sortie afin que d'autres agents puissent le découvrir.
Également abordés
Les épisodes consacrés à Agent card abordent aussi Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming et AI Center of Excellence.
Description
Une carte d'agent est un document lisible par machine utilisé dans le protocole Agent2Agent (A2A) pour décrire un agent. Elle est publiée à une URL bien connue et contient des métadonnées telles que le nom de l'agent, sa description, sa version, ses capacités, ses compétences, son point de terminaison, les exigences d'authentification ainsi que les formats d'entrée et de sortie qu'il prend en charge. Son objectif principal est la découverte : un client ou un autre agent peut lire la carte pour savoir ce que propose un agent avant de lui envoyer une requête.
Le protocole A2A aborde l'interopérabilité entre agents en mettant l'accent sur un langage standardisé, ce qui évite d'écrire du code spécifique pour chaque interaction entre agents. La carte d'agent est l'élément de cette approche qui permet à un agent de présenter son identité et ses capacités. Plutôt que de faire des hypothèses codées en dur sur un agent distant, un agent appelant lit la carte publiée, déduit comment atteindre l'agent et détermine les types de données qu'il peut échanger.
La page Microsoft Learn consacrée à l'hébergement A2A dans Microsoft Agent Framework montre à quoi cela ressemble concrètement. Dans l'exemple d'hébergement ASP.NET Core, la carte est servie à un chemin bien connu se terminant par agent-card.json. La méthode de mappage qui expose la carte provient du package SDK A2A et non des packages d'hébergement d'Agent Framework. L'exemple de carte définit un nom, une description et une version, les modes d'entrée et de sortie par défaut, ainsi qu'une interface prise en charge comprenant une URL, une liaison de protocole et une version du protocole. La page recommande de renseigner entièrement la carte pour un usage en production, afin que les clients reçoivent des informations complètes sur l'agent qu'ils vont appeler.
La documentation décrit une limite pratique liée à l'hébergement. Un même hôte ne peut publier qu'une seule carte d'agent au chemin bien connu, ce qui signifie qu'un seul agent y est découvrable. Les autres agents hébergés à côté restent accessibles via leurs propres URL, mais les clients doivent déjà connaître ces points de terminaison, car l'emplacement commun bien connu ne les répertorie pas. Lors de la planification d'un déploiement comportant plusieurs agents, cela influence la conception de la découverte et la manière dont les informations sur les points de terminaison sont partagées avec les consommateurs. La page de documentation ne couvre pas les compétences, les détails d'authentification ni les signatures de carte ; ces aspects ne sont donc décrits ici qu'au niveau de la définition générale.
L'épisode « Agent-to-Agent (A2A) Communication - Simply Explained » aborde ce concept dans le cadre d'une discussion plus large sur l'interopérabilité. Il présente la carte d'agent comme le mécanisme par lequel les agents annoncent leur identité et leurs capacités, ce qui facilite la découverte et l'interaction. Le même épisode relie cela à la communication structurée, où les agents échangent différents types de données, ce qui favorise la collaboration et le suivi de l'état des tâches. Il souligne également que la confidentialité et la sécurité sont au cœur de la communication entre agents, et que quiconque travaille avec ces systèmes doit être conscient des risques liés au traitement des données. Comme une carte d'agent publie des informations sur un agent et sur la manière de le joindre, décider de ce qui y figure et de la façon dont l'accès est contrôlé fait partie de cette réflexion plus large sur la sécurité.
En résumé, la carte d'agent constitue la description publique d'un agent A2A. Elle est lue par les clients avant l'envoi de toute tâche, elle est servie depuis un emplacement prévisible, et elle doit être complète et exacte en production. La contrainte d'une seule carte par chemin bien connu, dans l'exemple d'hébergement ASP.NET Core, est un point de conception à prendre en compte chaque fois que plusieurs agents sont exposés depuis le même hôte.
Aperçu compilé avec l'IA à partir des épisodes M365.FM et des informations de cette page. Tu peux l'améliorer avec le bouton de modification ci-dessous.
| Type | Concept |
|---|---|
| Type | Format |
Questions fréquentes
Les questions marquées IA ont été rédigées avec l'IA à partir des informations de cette page.
Qu'est-ce qu'une carte d'agent dans le protocole A2A ? (IA)
C'est un document lisible par machine, publié à une URL bien connue, qui décrit le nom d'un agent, ses capacités, ses compétences, son point de terminaison, ses exigences d'authentification et ses formats d'entrée et de sortie afin que d'autres agents puissent le découvrir.
Où la carte d'agent est-elle servie dans l'exemple de Microsoft Agent Framework ? (IA)
Dans l'exemple d'hébergement ASP.NET Core, elle est servie à un chemin bien connu se terminant par agent-card.json, à l'aide d'une méthode de mappage provenant du package SDK A2A et non des packages d'hébergement d'Agent Framework.
Un hôte peut-il publier plusieurs cartes d'agent ? (IA)
Selon la page Microsoft Learn, un même hôte ne peut publier qu'une seule carte d'agent au chemin bien connu ; seul un agent y est donc découvrable. Les autres agents restent accessibles via leurs propres URL, que les clients doivent déjà connaître.
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Experts et entreprises pour ce sujet
Personne n'a encore indiqué ce sujet. Ajoutez-le à votre profil.
Maintenu par Mirko Peters (Microsoft MVP) · Dernière mise à jour: