Ajouter un agent Agent2Agent (A2A) en tant qu’agent connecté (Microsoft Copilot)

Utilisez des assistants connectés pour permettre à votre assistant principal de déléguer des tâches spécifiques à des assistants spécialisés. Cet article vous montre comment connecter un agent distant disponible via le protocole Agent2Agent (A2A), afin que votre agent principal puisse lui confier les tâches.

Note

Le framework utilisé pour construire cet agent utilise une facturation basée sur l’utilisation. L’utilisation, la création, le test et l’évaluation des agents peuvent consommer des crédits Copilot. En savoir plus dans Aperçu de la facturation basée sur l’utilisation.

Le protocole A2A est une norme ouverte pour la communication et la collaboration entre agents. Parce que c'est une norme ouverte, vous pouvez connecter des agents hébergés en dehors de Copilot Studio et construits sur d'autres frameworks, tant qu'ils implémentent l'A2A. Copilot Studio découvre l’agent distant depuis sa carte agent, puis utilise le protocole A2A pour lui déléguer des tâches à l’exécution.

Vous ajoutez tous les agents connectés depuis la même boîte de dialogue Ajouter un agent connecté . Pour un aperçu des agents connectés et du fonctionnement du routage, voir Aperçu des agents connectés. Pour connecter un autre agent Copilot Studio, voir Ajouter un agent Copilot Studio comme agent connecté. Pour connecter un agent Microsoft Foundry, voir Ajouter un agent Foundry comme agent connecté.

Prerequisites

  • Un agent créé avec l’infrastructure Microsoft Copilot pour servir d’agent principal. Voir Créer un assistant (version préliminaire).
  • Un agent distant qui implémente le protocole Agent-à-Agent et est accessible depuis Copilot Studio via Internet public.
  • L’URL de la carte agent de l’agent distant, généralement https://<your-agent-host>/.well-known/agent-card.json.
  • Les détails d’authentification que l’agent distant exige, le cas échéant. Copilot Studio prend en charge l’absence d’authentification, la clé API et OAuth 2.0.
  • Pour OAuth 2.0, permission d’ajouter une URI de redirection à l’enregistrement de l’application qu’utilise le fournisseur d’identité de l’agent distant. Copilot Studio génère l’URL de redirection au cours de l’assistant de configuration, et vous devez l’enregistrer avant de créer la connexion.

Note

Étant donné que les connexions A2A utilisent l’infrastructure de connecteur personnalisée, vous pouvez également les utiliser pour vous connecter à des agents A2A s’exécutant localement ou dans un réseau virtuel.

Ajouter un agent Agent2Agent (A2A)

L’assistant vous guide à travers trois ou quatre étapes, selon la méthode d’authentification que vous choisissez :

  • Si vous choisissez Aucun ou la clé API : connectez-vous à un agent A2A, connectez-vous à l’agent A2A, puis relisez et ajoutez.
  • Si vous choisissez OAuth 2.0 : Connectez-vous à un agent A2A, ajoutez une URL de redirection, connectez-vous à l’agent A2A, puis examinez et ajoutez.

  1. Connectez-vous à Copilot Studio.

  2. Choisissez et ouvrez l’assistant que vous souhaitez utiliser comme assistant principal.

  3. Dans la barre de navigation de l’agent, sélectionnez l’onglet Build .

  4. Dans le panneau des composants, sélectionnez Assistants connectés pour ouvrir la boîte de dialogue Ajouter un assistant connecté.

  5. Dans la boîte de dialogue, sélectionnez Ajouter, puis sélectionnez Ajouter un agent A2A.

  6. À l’étape Connect to an A2A agent, saisissez les détails de l’agent distant :

    • URL de la carte d’agent : l’URL de la carte agent de l’agent distant, par https://agent.example.com/.well-known/agent-card.jsonexemple. Copilot Studio lit la carte pour découvrir le point de terminaison et les capacités de l'agent.
    • Nom : le nom affiché pour l’auteur de l’agent. Si la carte d’agent inclut un nom, Copilot Studio remplit ce champ pour vous.
    • Description : une description claire du moment où cet agent A2A doit être utilisé, entre 30 et 1 000 caractères. Si la carte de l’agent inclut une description, Copilot Studio remplit ce champ pour vous. L’orchestrateur utilise cette description pour décider quand acheminer une requête vers l’agent, donc rendez-la précise et évitez les chevauchements avec vos autres outils et agents. En savoir plus sur la rédaction de métadonnées efficaces.

    Note

    Si le nom et la description ne sont pas remplis automatiquement, l'agent distant peut ne pas avoir de carte d'agent, la carte peut être à une URL différente de celle que vous avez saisie, ou Copilot Studio pourrait ne pas pouvoir y accéder. Vérifiez d’abord l’URL, puis essayez d’ouvrir la carte agent dans votre navigateur. Si la carte n’est pas disponible, saisissez manuellement un nom et une description.

  7. Sous Authentication, sélectionnez comment Copilot Studio s’authentifie auprès de l’agent distant, puis complétez les détails de la méthode que vous avez choisie :

    Vous ne pouvez pas continuer tant que les détails d’authentification ne sont pas complets.

  8. Sélectionnez Suivant.

  9. Si vous sélectionnez OAuth 2.0, l’étape Ajouter l’URL de redirection apparaît. Copilot Studio crée le connecteur pour l’agent A2A, et la plateforme génère une URL de redirection pour celui-ci. Enregistrez cette URL auprès de votre fournisseur d’identité avant de créer la connexion :

    1. Attendez que le champ URL de Redirection se remplisse. Le connecteur doit exister avant que l’URL ne soit générée.
    2. Sélectionnez le bouton de copier à côté du champ pour copier l’URL.
    3. Dans votre inscription à l’application OAuth, ajoutez l’URL comme URI de redirection, puis enregistrez l’inscription à l’application.
    4. Sélectionnez Suivant.

    Important

    Si vous n’enregistrez pas d’abord l’URL de redirection, la première tentative d’autorisation de la connexion échoue. L’URL de redirection est générée par connecteur, donc elle est spécifique à cet agent A2A et ne peut pas être réutilisée depuis un autre connecteur. Si vous avez besoin de l’URL à nouveau plus tard, sélectionnez l’agent A2A sous Agents connectés dans le panneau composants pour la rouvrir.

  10. À l’étape Connect to the A2A agent, choisissez la connexion que cet agent utilise pour atteindre l’agent distant :

    • Sélectionnez une connexion existante parmi la liste des connexions disponibles.
    • Si aucune connexion n’est disponible, créez une nouvelle connexion. Si l’agent distant utilise l’authentification par clé API, vous entrez la valeur de la clé API lors de la création de la connexion.

  11. Sélectionnez Suivant.

  12. Sur l’étape Réviser et ajouter , vérifiez le nom, la description et l’URL de la carte de l’agent, puis sélectionnez Ajouter à l’agent.

  13. Confirmez que l’agent connecté apparaît sous Agents connectés dans le panneau des composants.

Si vous revenez modifier les paramètres d’authentification sur l’étape Connect to an A2A agent, Copilot Studio supprime le connecteur qui avait été construit à partir des paramètres précédents. Vous devez enregistrer une nouvelle URL de redirection et choisir à nouveau une connexion.

Note

Vous êtes responsable de revoir et tester attentivement les agents connectés dans le contexte de vos cas d’usage spécifiques, et de prendre toutes les décisions et personnalisations appropriées. Lorsque vous vous connectez à des assistants en dehors de Copilot Studio, vous êtes responsable de l’utilisation de ces assistants. Les considérations incluent la garantie de :

  • Les flux de données, la gestion des données et le partage de données entre agents sont adaptés à votre cas d’utilisation et répondent aux exigences et lois pertinentes.
  • Les agents respectent des normes appropriées en matière de qualité, de fiabilité, de sécurité et de caractère digne de confiance.
  • Des autorisations, limites et approbations appropriées sont prévues, si cela convient à votre cas d’usage.
  • Une observabilité, une identité et une traçabilité appropriées, ainsi que des fonctions de surveillance humaine sont en place.

Configurer l’authentification par clé API

Lorsque vous sélectionnez la clé API, sélectionnez où Copilot Studio envoie la clé en sélectionnant un type de paramètre :

  • En-tête : la clé est envoyée sous forme d’en-tête de requête. Nom de l’en-tête, saisissez le nom de l’en-tête attendu par l’agent distant, comme x-api-key.
  • Chaîne de requête : la clé est envoyée sous forme de paramètre de chaîne de requête. Dans Libellé du paramètre, saisissez le nom du paramètre de la chaîne de requête attendu par l’agent distant.

Vous entrez la valeur de la clé API elle-même lors de la création de la connexion, pas à cette étape. Ainsi, la clé est stockée avec la connexion et n’est pas visible dans la configuration de l’agent.

Configurer l’authentification OAuth 2.0

Lorsque vous sélectionnez OAuth 2.0, choisissez un type de configuration :

  • Dynamique : Copilot Studio enregistre un client auprès du fournisseur d'identité de l'agent distant pour vous. Entrez l’URL d’autorisation et l’URL du jeton.

  • Manuel : utilisez une inscription d’application que vous avez déjà créée auprès du fournisseur d’identité de l’agent distant. Entrez les valeurs suivantes :

    • ID client : l’identifiant client de votre inscription à l’application.
    • Secret du client : le secret client de votre inscription à l’application.
    • URL d’autorisation : le point d’accès d’autorisation du fournisseur d’identité.
    • URL du jeton : le point de terminaison du jeton du fournisseur d’identité.
    • URL de rafraîchissement des jetons : le point de terminaison utilisé pour actualiser les jetons d’accès.
    • Scopes (optionnel) : les scopes à demander, séparés par des espaces.

Utilisez Dynamic lorsque le fournisseur d’identité de l’agent distant prend en charge l’enregistrement dynamique du client. Utilisez Manuel lorsque vous devez contrôler l’enregistrement de l’application, par exemple lorsque votre fournisseur d’identité exige des URI de redirection préenregistrées ou un consentement.

L’un ou l’autre type de configuration nécessite que vous enregistriez une URL de redirection auprès de votre fournisseur d’identité. Après avoir sélectionné Suivant, Copilot Studio crée le connecteur et affiche l’URL de redirection générée à l’étape Ajouter l’URL de redirection.

Retrouvez l’URL de redirection plus tard

Si vous fermez l’assistant ou perdez l’URL de redirection, vous pouvez la consulter à nouveau à tout moment :

  1. Dans l’onglet Build , sélectionnez l’agent A2A sous Agents connectés dans le panneau des composantes.

  2. Dans la boîte de dialogue Modifier l’agent A2A, copiez la valeur dans le champ URL de redirection.

Le champ URL de Redirection apparaît uniquement pour les agents A2A utilisant OAuth 2.0.

Comment l’orchestrateur achemine vers l’agent A2A

Après avoir ajouté l’agent A2A, l’exécution d’orchestration détermine automatiquement quand il faut lui déléguer. La décision de routage repose sur :

  • Le nom et la description de l’assistant connecté
  • Le message et le contexte de la conversation de l’utilisateur
  • Les instructions de votre assistant principal

Tip

Rédigez une description claire et spécifique pour l’agent A2A afin que l’orchestrateur puisse déterminer avec précision quand acheminer les requêtes vers lui. Évitez les descriptions qui se chevauchent entre les assistants connectés.

Délégation de test

Après avoir ajouté l’agent A2A :

  1. Dans la barre de navigation d’assistant, sélectionnez l’onglet Aperçu.

  2. Envoyez un message correspondant au domaine de l’agent A2A.

  3. Vérifiez que la réponse provient de l’agent A2A et qu’elle est appropriée.

  4. Envoyez un message en dehors du domaine de l’agent A2A pour confirmer que votre agent principal s’en occupe.

Si vous devez changer le nom ou la description plus tard, modifiez l’agent connecté depuis le panneau des composants. Voir Gérer les agents connectés dans un agent.

Résoudre les problèmes de connexion

Problème Que vérifier
L’autorisation de la connexion échoue avec une erreur de redirection de l’URI L'URL de redirection générée par Copilot Studio n'est pas enregistrée auprès de votre fournisseur d'identité. Copiez l’URL depuis la boîte de dialogue Modifier l’agent A2A, ajoutez-la à votre enregistrement de l’application, puis autorisez à nouveau la connexion.
Le champ URL de Redirection reste vide dans l’assistant Le connecteur est encore en cours de création. Si l’étape affiche une erreur à la place, sélectionnez Réessayer.
Le nom et la description ne se remplissent pas à partir de la carte de l’agent Vérifiez que l’URL de la carte d’agent est correcte et que Copilot Studio peut accéder à la carte. Saisissez manuellement le nom et la description si la carte n’est pas disponible.
La connexion que vous avez créée ne fonctionne plus après avoir modifié l’assistant de configuration Changer les paramètres d’authentification supprime le connecteur construit à partir des paramètres précédents. Enregistrez la nouvelle URL de redirection et choisissez à nouveau une connexion.
  • Dernière mise à jour :