Ajoutez un agent Copilot Studio 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 ajouter un autre agent Copilot Studio publié en tant qu’agent connecté et vérifier que la délégation fonctionne comme prévu.

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.

Vous ajoutez tous les agents connectés depuis la même boîte de dialogue Ajouter un agent connecté . Cette directive s’applique indépendamment du fait que l’agent soit construit dans Copilot Studio, hébergé dans Microsoft Foundry ou accessible via le protocole Agent2Agent (A2A). Cet article traite de la mise en relation avec un agent de Copilot Studio. Pour connecter un agent Microsoft Foundry à la place, voir Ajouter un agent Foundry comme agent connecté. Pour connecter un agent distant via le protocole A2A, voir Ajouter un agent A2A comme agent connecté. Pour connecter un agent construit avec le Microsoft 365 Agents SDK, voir Ajouter un agent Microsoft 365 Agents SDK comme agent connecté.

Prerequisites

  • Un agent créé avec le harness Microsoft Copilot comme agent principal. Voir Créer un assistant (version préliminaire).
  • Au moins un autre agent alimenté par le harnais Microsoft Copilot dans le même environnement. L’autre assistant doit être publié et configuré comme disponible pour la connexion.
  • Le créateur de l’agent principal doit soit être le propriétaire de l’agent connecté, soit avoir accès à cet agent via un partage.

Partage et accès par connecteur

Pour les agents alimentés par le harnais Microsoft Copilot, partager l'agent principal (parent) avec un utilisateur permet à cet agent d'invoquer ses agents Copilot Studio connectés au nom de l'utilisateur. Vous n’avez pas besoin de partager séparément chaque agent connecté avec cet utilisateur pour que la délégation via l’agent parent fonctionne. Le créateur a toujours besoin de l’accès décrit dans les prérequis pour ajouter un agent connecté.

Les exigences de partage varient selon les harnais :

Harness Exigences de partage pour la délégation d’agent connecté
Microsoft Copilot harnais Partagez l’agent parent avec les utilisateurs ou les groupes concernés. Chaque agent Copilot Studio connecté n'a pas besoin d'être partagé séparément avec ces utilisateurs pour que le parent puisse l'invoquer.
Harness standard (expérience classique) Selon la configuration de l’authentification, il se peut que vous deviez partager l’agent connecté séparément avec les utilisateurs finaux de l’agent parent. Pour en savoir plus, connectez-vous à un agent Copilot Studio existant.

La permission d’invoquer un agent connecté n’est pas la même chose que la permission d’accéder aux données utilisées par ses outils. L’accès à ces données reste régi par les listes de contrôle d’accès à la connexion (ACL) de l’agent connecté et les autorisations de l’identité utilisée par chaque connexion. Partager l’agent parent ne prend pas le dessus sur ces contrôles.

Important

Pour restreindre l’accès d’un agent connecté aux outils aux données auxquelles l’utilisateur appelant est autorisé à accéder, configurez ses outils pour utiliser l’authentification utilisateur. Si un outil utilise l’authentification de l’auteur de l’agent, il fonctionne avec les identifiants fournis par l’auteur et peut renvoyer des données via le parent que l’utilisateur ne peut pas accéder avec ses propres identifiants. Ne comptez pas sur le fait de laisser un agent connecté non partagé pour restreindre ces données. Vérifiez ses paramètres d’authentification et ses permissions de connexion avant de partager le parent concerné. En savoir plus dans Configurer l’authentification utilisateur pour les outils.

Ajouter un agent Copilot Studio

  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. Depuis la boîte de dialogue Ajouter un agent connecté, parcourez ou recherchez les agents Copilot Studio disponibles et sélectionnez l’agent que vous souhaitez connecter.

  6. Passez en revue les capacités de l’assistant, puis ajoutez une description claire des situations où l’assistant connecté doit être utilisé.

  7. Sélectionnez Se connecter.

  8. Confirmez que l’assistant connecté apparaît dans le panneau des composants.

Comment l’orchestrateur achemine vers les agents connectés

Après avoir ajouté un assistant connecté, le moteur d’orchestration détermine automatiquement quand déléguer à cet assistant. 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 chaque assistant connecté 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é un assistant connecté :

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

  2. Envoyez un message correspondant au domaine de l’assistant connecté.

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

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

Tester le partage et l’accès aux données

Testez également la délégation en tant qu’utilisateur final prévu, et pas seulement en tant que créateur :

  1. Partagez l’agent parent publié avec un utilisateur test sans partager séparément l’agent connecté avec cet utilisateur.

  2. En tant qu’utilisateur, envoyez une requête au parent qui nécessite l’agent connecté. Vérifiez que le parent peut l’invoquer.

  3. Pour les outils à agents connectés configurés pour utiliser l’authentification utilisateur, testez les requêtes pour les données auxquelles l’utilisateur est autorisé à accéder et les données auxquelles il n’est pas autorisé. Vérifiez que les données autorisées sont retournées et que les données restreintes ne sont pas retournées.

  4. Si des outils d’agent connecté utilisent l’authentification de l’auteur de l’agent, vérifiez que les données fournies avec ces identifiants sont appropriées à tous ceux qui peuvent utiliser l’agent parent.

  • Dernière mise à jour :