Configurer et gérer les connexions

Les agents utilisent des outils et des connaissances pour effectuer des actions au nom des utilisateurs et collecter des informations contextuelles pertinentes. Les développeurs stockent souvent ces outils et sources de connaissances dans des systèmes externes, tels que Microsoft Dataverse, Microsoft SharePoint ou d’autres API. Pour accéder à ces ressources en toute sécurité, les agents doivent s’authentifier afin d’établir des liens entre eux-mêmes et le système externe. L’agent peut utiliser soit l’authentification de l’agent, soit l’authentification utilisateur, selon le scénario.

Dans Microsoft Copilot Studio, vous utilisez des connexions pour accéder en toute sécurité aux services authentifiés pour les outils et les connaissances. Vous pouvez créer des connexions à différentes sources de données, telles que Microsoft Dataverse, Microsoft SharePoint ou des API externes.

Afficher et gérer les connexions d’agent

Dans Copilot Studio, vous pouvez afficher et configurer les connexions que votre agent utilise sur la page Connection Settings.

Sur la page des paramètres de connexion , vous pouvez configurer et gérer les connexions utilisées par votre agent. Vous pouvez afficher les connexions existantes, en créer de nouvelles et les modifier ou les déconnecter si nécessaire.

Afficher les connexions dans la page Paramètres de connexion

1. Allez sur la page de votre agent dans Copilot Studio en sélectionnant Agents, puis en sélectionnant celui que vous souhaitez voir.

   La page Vue d’ensemble de l’agent s’ouvre.

2. Sélectionnez Paramètres pour ouvrir la page Paramètres de l’agent.

3. Sélectionnez Paramètres de connexion.

Vous voyez une liste dans un tableau avec toutes les connexions associées à votre agent. Pour chaque connexion, vous pouvez consulter :

• Nom de connexion
• Outils et sources de connaissances utilisant la connexion
• Statut de la connexion

Définitions de l’état de la connexion

L’état de la connexion indique l’état actuel de la connexion. Plusieurs statuts possibles existent :

• Connecté : La connexion est active, et l’agent peut l’utiliser pour accéder à l’outil ou aux connaissances associées.
• Non connecté : Il n’y a pas de connexion active. L’agent ne peut pas accéder à l’outil ou aux connaissances associées. Vous devez établir un lien.
• Désactivé : La connexion est désactivée, possiblement par un admin, et l’agent ne l’utilise pas actuellement.
• Expiré : Les identifiants d’authentification de la connexion sont expirés et ne sont plus valides. Vous devez réauthentifier la connexion pour que l’agent puisse accéder à l’outil ou aux connaissances associées.
• Stagnante : La connexion n’est plus valide ni utilisable, généralement parce qu’elle a été coupée ou expirée. Vous devez revoir, mettre à jour ou remplacer la connexion pour que l’agent puisse accéder à l’outil ou aux connaissances associées.

Filtrer les connexions

Si vous avez plusieurs contacts avec votre agent, filtrez la liste pour trouver le lien avec lequel vous souhaitez travailler. Appliquez différents filtres pour voir les connexions selon leur statut, comme Activé, Désactivé, Connecté, Non Connecté, Expiré ou Immobile.

Sélectionnez ou créez une connexion individuelle

1. Dans Statut pour l’entrée de connexion dans la liste, sélectionnez le lien hypertexte à côté du statut pour ouvrir la page Créer ou choisir un panneau de connexion.

2. Sélectionne ... pour ouvrir la configuration de connexion .

3. Sélectionnez une connexion existante dans la liste ou sélectionnez Créer une nouvelle connexion pour en créer une nouvelle.

   Si vous sélectionnez Créer une connexion, un volet d’installation de connexion s’ouvre. Si nécessaire, il se peut qu’on vous invite à vous connecter au service ou à fournir plus d’informations pour finaliser la configuration.

4. Lorsque vous avez terminé, sélectionnez Soumettre pour enregistrer vos changements.

   Vous avez configuré la connexion et l’avez associée à votre agent. Votre agent peut utiliser la connexion pour accéder aux outils et aux connaissances.

Voir les détails et configurer les paramètres de connexion

Sous Gérer pour l’entrée de connexion dans la liste, sélectionnez Afficher les détails pour afficher plus de détails sur la connexion.

Les informations s’affichent sous deux onglets :

• Détails : affiche le nom de connexion, la description, l’état et les détails de création.
• Paramètres de connexion : affiche les paramètres de connexion, tels que les détails de l’authentification, les clés API ou d’autres informations requises, et vous permet de configurer les détails.

Partager les paramètres de connexion pour l’authentification OBO (On-Behalf-Of)

Pour certaines connexions qui supportent la connexion unique (SSO), vous pouvez configurer la connexion pour utiliser l’authentification On-Behalf-Of (OBO). Dans un flux OBO, l’utilisateur délègue à l’agent l’utilisation des paramètres de connexion de l’utilisateur avec le service en son nom. Cette méthode d’authentification est utile lorsque l’agent doit accéder à des ressources nécessitant des permissions spécifiques à l’utilisateur ou lorsque des actions doivent être effectuées dans le contexte de l’identité de l’utilisateur.

Activer le partage de paramètres pour OBO

Sous Paramètres de connexion pour l’entrée de connexion dans la liste, vous pouvez autoriser l’utilisateur à autoriser le partage de paramètres de connexion spécifiques.

1. Sous Paramètres de connexion, activez l’autorisation Autoriser le partage des paramètres.

   

2. Cochez les cases des paramètres que vous souhaitez autoriser l’utilisateur à partager.

   L’utilisateur est invité à accorder l’autorisation pour ces paramètres lorsque l’agent utilise l’authentification OBO.

Expérience utilisateur pour l´authentification OBO

Lorsque l’agent utilise l’authentification OBO, l’utilisateur est invité à accorder l’autorisation à l’agent d’utiliser ses paramètres de connexion. L’utilisateur peut choisir d’autoriser ou de refuser cette autorisation. Si l’utilisateur l’autorise, l’agent peut accéder aux ressources et effectuer des actions au nom de l’utilisateur. L’assistant se connecte au service de manière transparente à l’aide des paramètres de connexion partagée.

Invites de connexion répétées lors de l’utilisation d’OAuth 2.0 avec les outils Microsoft API Graph

Lorsque vous utilisez l’authentification OAuth 2.0 , chaque utilisateur doit se connecter et accorder son consentement. Quand vous partagez ou hébergez l’agent, les autres utilisateurs n’ont pas encore consenti, donc ils voient la carte Connect .

Pour éviter les invites répétées, essayez l’une des options suivantes pour l’authentification :

• Activez la connexion unique (SSO) de Teams avec le flux on-behalf-of (OBO) : Les utilisateurs se connectent une fois dans Teams. Aucun consentement supplémentaire n’est requis dans le chat.

• Utiliser les permissions d’application (principal de service) : Le backend appelle Microsoft Graph en utilisant les identifiants de l’application. Aucun consentement utilisateur n’est requis.

• Utilisez un SSO OAuth générique pour les agents hébergés en ligne : votre application gère la connexion et transmet le jeton à l’agent.

• Accorder le consentement administrateur pour les champs délégués : Supprime les demandes d’autorisation par utilisateur. Une première inscription reste nécessaire.

Contenu connexe

• Configurez l’authentification OBO pour les connecteurs personnalisés