Connectez-vous et configurez un agent pour Teams et Microsoft 365

Après avoir publié votre agent, rendez-le disponible pour les utilisateurs dans Teams et Microsoft 365. De cette façon, vous-même, vos collègues et l’ensemble de l’organisation pourront interagir avec lui. Vous devez publier l’agent au moins une fois avant que les utilisateurs puissent interagir avec l’agent dans Teams et Microsoft 365.

Vous pouvez :

• Personnalisez l'apparence de votre agent dans Teams et Microsoft 365 Copilot.
• Installez l’agent pour vous-même dans Teams et Microsoft 365 Copilot.
• Partagez le lien d’installation de l’agent avec d’autres utilisateurs.
• Afficher l’agent dans le magasin d’applications Teams.
  • Affichez l’assistant aux utilisateurs partagés en l’ajoutant à la section Créé avec Power Platform du magasin d’applications Teams.
  • Partager l’agent avec l’organisation en le soumettant à l’approbation de l’administrateur pour qu’il figure dans la section Créé pour votre organisation dans le magasin d’applications Teams.
• Ajouter l’agent à un canal d’équipe.
• Télécharger le manifeste de l’application pour votre agent pour le distribuer dans votre client Teams.

Lorsque vous ajoutez un agent à Teams, certaines de vos données, telles que le contenu de l’agent et le contenu de la conversation instantanée de l’utilisateur final, sont partagées avec Teams. Vos données peuvent circuler en dehors de des limites de conformité et des limites géographiques ou régionales de votre organisation. Pour plus d’informations, voir Comprendre les autorisations et les informations auxquelles accèdent les applications Teams.

Prérequis

• Tous les utilisateurs de l’agent de votre organisation peuvent utiliser Microsoft 365 Copilot.

• Les créateurs d’agents ont les autorisations nécessaires pour créer et accéder à un environnement Copilot Studio.

• Partager votre agent avec d’autres utilisateurs afin qu’ils puissent installer et discuter avec l’agent dans Teams et Microsoft 365 Copilot.

• Votre organisation doit autoriser l’ajout d’applications Power Platform à Teams avant que vous ou d’autres utilisateurs ne puissiez :

  • Installer directement un agent dans Teams, ou
  • Trouvez un agent dans la section Built with Power Platform de l’App Store de Teams.

  Collaborez avec votre administrateur pour gérer les applications Microsoft Power Platform dans le centre d'administration Microsoft Teams s'il est désactivé pour votre organisation.

• Les administrateurs gèrent les agents qui apparaissent dans la section Construit pour votre organisation (approuvés par un administrateur) séparément sur la page Gérer les applications du centre d’administration Teams.

• Avant d’installer un agent pour vous-même ou de le partager avec d’autres, publiez l’agent au moins une fois.

Connecter un agent aux canaux Teams et Microsoft 365 Copilot

Après avoir publié votre agent au moins une fois, vous pouvez le connecter aux canaux Teams et Microsoft 365 Copilot afin que les utilisateurs puissent discuter avec lui dans Teams et Microsoft 365 Copilot.

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Si vous souhaitez que votre agent soit disponible à la fois dans Microsoft 365 Copilot et Teams, sous Activer Microsoft 365, assurez-vous que Rendre l’agent disponible dans Microsoft 365 Copilot est sélectionné.

   Remarque

   Si vous ne sélectionnez pas Make agent disponible dans Microsoft 365 Copilot, votre agent est disponible uniquement dans Teams.

3. Sélectionnez Ajouter un canal.

   

Personnaliser l’apparence d’un agent pour Teams et Microsoft 365 Copilot

Avant de rendre un agent disponible à d’autres utilisateurs, fournissez la bonne description et l’apparence. Ces informations aident les utilisateurs à comprendre la raison d’être et le branding de l’agent.

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Modifier les détails pour changer l’icône, la couleur et les descriptions de l’agent. Ces attribut sont affichés dans le magasin d’applications Teams et dans l’onglet À propos de l’application après l’installation de l’agent par l’utilisateur. Consultez les consignes relatives au format des icônes d’application pour Teams.

   Important

   Les utilisateurs qui ont déjà installé l’agent depuis un lien partagé ou depuis la section Built with Power Platform de l’App Store Teams ne voient pas de modifications dans les détails d’un agent. Les utilisateurs doivent réinstaller l’agent pour recevoir les mises à jour.

   Pour les agents déjà approuvés par un administrateur, vous devez soumettre à nouveau l’agent pour approbation.

3. Sélectionnez Plus pour ajouter des informations suivantes :

   • Nom du développeur
   • Site web
   • Déclaration de confidentialité
   • Conditions d’utilisation

   Fournissez ces informations pour informer les utilisateurs sur votre agent. Pour plus d’informations, consultez Créer une déclaration de confidentialité et des conditions d’utilisation dans Microsoft Teams.

4. Cliquez sur Enregistrer. Vos modifications apportées à la couleur, à l’icône et à la brève description sont désormais visibles sur le panneau de configuration.

Installer un agent dans Teams et Microsoft 365 Copilot

Après avoir publié votre agent, vous pouvez l’ajouter à votre profil Teams directement à partir de Copilot Studio.

Ajoutez d’abord votre agent à votre propre profil dans Teams, avant de le partager avec d’autres.

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Voir l’agent dans Teams.

   Si vous avez configuré votre agent pour qu’il soit disponible dans Microsoft 365 Copilot lorsque vous avez ajouté le canal, sélectionnez See agent dans Teams installe votre agent sur Teams et Microsoft 365 Copilot. Si vous n'avez pas configuré votre agent pour Microsoft 365 Copilot, votre agent s'installe uniquement sur Teams.

3. Cliquez sur Ajouter.

   

   L’assistant s’affiche dans la liste des assistants sur la gauche.

4. Pour poser une question à votre nouvel agent dans Microsoft 365 Copilot, entrez @, sélectionnez votre agent dans la liste qui s’affiche, entrez votre question et sélectionnez Enter.

Partager un lien pour que d’autres puissent installer l’agent

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Options de disponibilité.

3. Sélectionnez Copier le lien.

4. Partagez le lien avec les utilisateurs pour qu’ils installent l’agent dans Teams.

Afficher un agent dans le magasin d’applications Teams ou dans le magasin d’Microsoft 365 Agent

Une fois que vous avez publié votre agent, vous pouvez l’afficher dans le magasin d’applications Teams ou dans le magasin d’Microsoft 365 Agent afin que les utilisateurs puissent le trouver et l’installer.

Afficher aux utilisateurs partagés dans Teams

Vous pouvez partager votre assistant en l'ajoutant à la section Créer avec Power Platform du magasin d'applications Teams. Seuls les utilisateurs partagés peuvent y trouver l’agent.

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Options de disponibilité.

3. Sélectionnez Afficher à mes coéquipiers et aux utilisateurs partagés et vérifiez qui a accès à l’agent.

4. Confirmez que la case Afficher dans Construit par vos collègues est cochée et sélectionnez Mise à jour.

   Votre assistant devient disponible dans la section Créé avec Power Platform du magasin d’applications Teams, et une étiquette verte Ajouté à Teams apparaît dans la page des options de disponibilité.

   

Supprimer un assistant de la section Créé avec Power Platform

Vous pouvez supprimer un assistant de la section Créé avec Power Platform. Supprimer l’agent de cette section n’affecte pas les utilisateurs avec l’agent installé.

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Options de disponibilité.

3. Sélectionnez Afficher à mes coéquipiers et utilisateurs partagés et décochez la case Afficher dans Créations de vos collègues.

4. Sélectionnez Partager. L’assistant n’apparaît plus dans la section Créé avec Power Platform du magasin d’applications Teams.

Afficher à l’organisation

Vous pouvez partager un agent avec votre organisation en l’envoyant à l’approbation de l’administrateur afin qu’il soit présenté dans la section Créé par votre organisation de l’App Store Teams. Si vous publiez également votre assistant sur Microsoft 365, le fait de le soumettre pour approbation par l’administrateur l’applique également au Microsoft 365 Agent Store. L’utilisation de votre application dans le magasin d’applications Teams et dans le magasin d’agents Microsoft 365 est un excellent moyen de distribuer largement votre agent en partenariat avec votre administrateur pour le déployer à tous les membres de l’organisation ou à un sous-ensemble d’utilisateurs.

Les administrateurs peuvent également utiliser les stratégies de configuration de l’application pour installer automatiquement et épingler un agent pour les utilisateurs de l’organisation afin qu’ils puissent y accéder directement à partir de leur barre d’application dans Teams.

Avant d’envoyer un agent à votre organisation, assurez-vous que :

• Votre agent est prêt au lancement et conforme aux normes, règles et politiques de la société.
• Vous coordonnez avec d’autres responsables de l’agent. Une fois que vous avez soumis un agent, un autre utilisateur ne peut pas le soumettre à nouveau tant qu’un administrateur n’a pas approuvé ou rejeté la soumission précédente.
• Vous supprimez l’assistant, le cas échéant, de la section Créé avec Power Platform du magasin d’applications Teams. Sinon, si vous soumettez votre agent à l’approbation de l’administrateur, il pourrait finir par apparaître à deux endroits.

Soumettez un agent pour approbation administrative

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Options de disponibilité.

3. Vérifiez que l’agent n’est pas affiché aux coéquipiers ou aux utilisateurs partagés. Supprimez-le s’il dit Ajouté à Teams.

4. Sélectionnez Afficher à tous les membres de mon organisation.

5. Passez en revue les conditions d’envoi et sélectionnez Envoyer pour approbation par l’administrateur.

   Remarque

   Assurez-vous que vous révisez le contenu et qu’il est prêt à être examiné par un administrateur. Vous devez soumettre de nouvelles demandes d'approbation pour mettre à jour l’icône et les descriptions des agents précédemment approuvés.

   Une fois qu’un agent est approuvé, tous les utilisateurs nouveaux et existants de l’agent dans Teams et Microsoft 365 Copilot recevoir la mise à jour.

   Une nouvelle approbation n’est requise que si vous modifiez les détails de l’assistant. Vous pouvez mettre à jour le contenu pour votre assistant et le publier aussi souvent que vous le souhaitez. Vous n’avez pas besoin de soumettre à nouveau votre agent pour approbation après la publication de ces modifications de contenu.

   Une invite de confirmation finale apparaît.

6. Cliquez sur Oui pour continuer. L’agent est envoyé à votre administrateur pour approbation et vous pouvez voir une note indiquant le statut de votre envoi.

   Remarque

   Après avoir soumis l’agent pour approbation administrative, ne modifiez pas les paramètres d’accès de l’agent pour qu’ils soient inférieurs à ceux de tous les membres de votre organisation.

   Si l’accès est défini sur une option autre que Tout le monde, les utilisateurs de l’organisation ne pourront pas discuter avec l’assistant après l’avoir installé à partir du magasin d’applications Teams ou du Microsoft 365 Agent Store.

   Collaborez avec votre administrateur sur la stratégie d’application Microsoft Teams pour déterminer qui peut trouver et installer l’agent.

7. Attendez l’approbation de votre administrateur. Vous pouvez consultez le dernier statut en sélectionnant Actualiser ou en ouvrant la fenêtre Rendre l’agent accessible aux autres depuis la page Publier.

8. Une fois que votre administrateur a approuvé l’agent, le statut est mis à jour sur Approuvé. Vous pouvez ouvrir directement l’agent et partager le lien de la version approuvée avec d’autres utilisateurs.

9. Vous pouvez également demander à votre administrateur d’utiliser les stratégies de configuration de l’application pour installer automatiquement et épingler un agent pour les utilisateurs de l’organisation afin qu’ils puissent y accéder directement depuis leur barre d’application dans Teams.

Autoriser les utilisateurs à ajouter un agent à une équipe dans Teams

Dans Teams, les utilisateurs peuvent ajouter un agent à une équipe spécifique. Une fois un agent disponible pour une équipe, les membres de l’équipe peuvent @mentionner le copilote dans n’importe quel canal d’équipe et tous les coéquipiers voient la réponses de l’agent. Cette fonctionnalité est utile dans des situations telles que les exemples suivants :

• Votre agent prend en charge la collaboration, par exemple en partageant les dernières informations du rapport de vente avec le reste de l’équipe commerciale.
• Vous souhaitez autoriser tous les membres de l’équipe à interagir avec l’agent dans un canal d’équipe ou via un chat privé sans avoir à installer manuellement l’agent eux-mêmes.

Deux options déterminent si les utilisateurs peuvent ajouter un agent à n’importe quelle équipe dont ils font partie, ou aux conversations de groupe et de réunion dans Teams. Lorsque vous sélectionnez ces options, l’agent accède à l’historique des conversations depuis le canal d’équipe, le groupe ou le chat de réunion, ce qui aide l’agent à fournir des réponses mieux adaptées au contexte de la conversation.

Lorsque les utilisateurs installent un agent depuis la App Store Teams ou en utilisant le lien d’installation, ils peuvent voir l’une des options suivantes, en fonction de la portée collaborative que vous avez définie pour l’agent :

• Ajouter l’agent à un canal d’équipe
• Ajouter l’agent aux discussions de groupe et de réunion dans Teams

Les membres de l’équipe peuvent également supprimer un agent d’une équipe.

Pour autoriser les utilisateurs à ajouter un agent à une équipe :

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Modifier les détails.

3. Sélectionnez Autoriser vos utilisateurs à ajouter cet agent à une équipe.

4. Cliquez sur Enregistrer.

Teams met en cache les informations, il peut donc s’écouler un certain temps avant que les utilisateurs ne voient l’option pour ajouter l’agent à une discussion d’équipe ou de groupe. Les utilisateurs peuvent actualiser le navigateur (ou se déconnecter du client de bureau Teams et se reconnecter) pour refléter immédiatement les modifications.

Si vous avez déjà soumis l’agent pour approbation par l’administrateur, vous devez le renvoyer après avoir activé cette option. L’administrateur doit approuver ces modifications avant que les utilisateurs puissent ajouter l’agent à leurs équipes à partir de la banque d’applications Teams dans la section Créé par votre organisation.

Empêcher les utilisateurs d’ajouter un agent à une équipe, ou à des conversations de groupe et de réunion

Lorsque vous désactivez cette option, les utilisateurs ne peuvent pas ajouter d’agent à une nouvelle équipe, groupe ou chat de réunion. Cela ne supprime pas l’agent pour les utilisateurs qui l’ont déjà. Vous devez supprimer manuellement l’agent.

Pour empêcher les utilisateurs d’ajouter un agent à une équipe :

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Modifier les détails.

3. Décochez la case Les utilisateurs peuvent ajouter cet agent à une équipe.

4. Cliquez sur Enregistrer.

Configurer le comportement du message d’accueil privé

Les salutations privées d’un agent sont utiles lorsque vous souhaitez que les membres de l’équipe aient des conversations individuelles avec l’agent sans avoir à installer manuellement l’agent eux-mêmes.

Lorsque vous configurez ce comportement, votre agent engage automatiquement une conversation avec les membres de l’équipe. Pour personnaliser le message d’accueil de l’agent, modifiez la rubrique système de message d’accueil.

Tenez compte de la pertinence de l’agent pour les membres de l’équipe. Assurez-vous que la salutation de l’agent l’aide à comprendre quoi en faire, à en décrire ses limites et, surtout, à les mettre à l’aise pour interagir avec.

Pour configurer le moment où un agent envoie un message d’accueil privé :

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Paramètres.

3. Configurez les options du message d’accueil privé.

4. Cliquez sur Enregistrer.

Télécharger le manifeste de l’application Teams pour un agent (avancé)

Vous pouvez télécharger le manifeste de l’application Teams de l’agent pour apporter des modifications détaillées au manifeste directement et les partager avec votre administrateur ou les utilisateurs du client. Vous pouvez également charger directement le manifeste de l’application dans Teams si la stratégie de votre organisation vous permet de charger des applications personnalisées.

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Options de disponibilité.

3. Sélectionnez Télécharger le fichier .zip. Le manifeste est généré en fichier .zip et enregistré selon les paramètres de votre navigateur.

4. Dans Teams, sélectionnez Applications>Gérer vos applications>Charger une application.

5. Sélectionnez Charger une application personnalisée.

6. Recherchez le fichier .zip téléchargé.

Déconnecter un agent de Teams

Vous pouvez mettre votre agent hors ligne afin que les utilisateurs ne puissent plus discuter avec lui dans Teams. Lorsque votre agent est hors connexion, il ne répond à personne qui essaie de discuter avec lui. Considérez la nécessité de déconnecter votre agent avant de le faire.

Les assistants déconnectés n’apparaissent pas dans la section Créé avec Power Platform du magasin d’applications Teams ni ne peuvent être installés à partir d’un lien partagé. Si un utilisateur a déjà un tel agent installé dans Teams, il reste disponible jusqu’à ce que l’utilisateur le désinstalle.

Si vous déconnectez un agent approuvé par un admin, il continue d’apparaître dans la section Construit pour votre organisation de l’App Store Teams. Vous devez demander à votre administrateur de le supprimer.

1. Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot.

2. Sélectionnez Supprimer le canal.

3. Passez en revue les informations sur la déconnexion de votre agent et sélectionnez Déconnecter pour continuer.

Vous pouvez toujours reconnecter votre agent en sélectionnant CanalAdd dans le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot, republier, puis réinstaller l’agent dans Teams.

Ouvrez le panneau de configuration pour les canaux Teams et Microsoft 365 Copilot

1. Ouvrez votre agent dans Copilot Studio.

2. Dans la barre de menu supérieure, sélectionnez Canaux.

3. Sélectionnez la vignette Teams et Microsoft 365 Copilot. Le panneau de configuration apparaît.

Limitations connues

Les limitations connues diffèrent selon que vous utilisez Teams ou Microsoft 365 Copilot.

Limitations identifiées dans Teams

• Les agents qui utilisent la toile d'édition unifiée améliorée ne prennent pas en charge la configuration de salutation privée.

• Les agents approuvés par un administrateur n’ont pas la possibilité de définir l’icône d’avatar sur la page des détails. Ces agents utilisent l’icône de l’application comme avatar.

• Teams applique une limitation de taux aux agents. Selon les besoins de votre entreprise, vous souhaiterez peut-être faire en sorte que le contenu de vos assistants publié vers Teams demeure concis.

• Si votre agent supporte l’authentification utilisateur, l’utilisateur ne peut pas se déconnecter explicitement. Ce comportement ne remplit pas la certification Teams Marketplace si vous publiez votre agent dans le tableau de bord du vendeur. Cette limite ne s’applique pas à l’utilisation personnelle ou par le locataire de l’agent. Apprenez comment publier votre application sur le Teams Store et à connaître la politique de certification du Marketplace.

• Après avoir déconnecté votre agent du canal Teams, il se peut qu’il faille quelques minutes avant que les utilisateurs dans Teams ne puissent plus joindre l’agent.

• Dans les conversations et canaux de groupe Teams, les agents Copilot Studio ne peuvent pas utiliser de sources de connaissances qui nécessitent l’authentification de l’utilisateur final, telle que SharePoint. Cette limitation est par conception et permet d’empêcher l’exposition involontaire des données. Ces agents sont pris en charge uniquement dans les conversations 1:1.

• Les conversations de groupe et les conversations de réunion ne prennent pas en charge les agents configurés pour l’authentification manuelle avec l’authentification unique (SSO) pour Teams. En fonction des besoins de votre entreprise, vous pouvez soit authentifier avec Microsoft ou supprimer SSO pour Teams de votre authentification manuelle.

SystemError après avoir publié ou republié un agent

Lorsque les utilisateurs interagissent avec un agent Copilot dans Teams, ils peuvent voir le message suivant :

Désolé, il s’est passé quelque chose d’inattendu. Nous y travaillons.
Code d’erreur : SystemError

Ce problème survient lorsque Teams continue d’utiliser une version déjà publiée de l’agent après que vous ayez publié ou republié l’agent. Dans certains cas, Teams ne rafraîchit pas immédiatement la configuration mise à jour de l’agent. Ce problème provoque une erreur systématique générique lors de l’exécution de l’agent.

Workaround

Pour rafraîchir la configuration de l’agent, essayez les étapes suivantes :

1. Dans le centre d’administration Microsoft Teams, recherchez l’application agent, désactivez-la, attendez quelques secondes, puis réactivez-la.
2. Dans Copilot Studio, désactivez le canal Teams pour l’agent, enregistrez vos modifications, puis réactivez le canal.
3. Republiez l’agent pour vous assurer que la dernière version est disponible sur Teams.

Si le problème persiste, contactez Microsoft Support et fournissez l’ID Conversation, Agent ID et le time lorsque l’erreur s’est produite.

Limitations connues dans Microsoft 365 Copilot

• Thème "Démarrage de la conversation" non pris en charge : Le canal Microsoft 365 Copilot ne prend pas en charge le thème "Démarrage de la conversation", donc les salutations générales ne sont pas possibles. À la place, l’agent propose des suggestions suggestives. Vous pouvez définir des variables via des sujets déclenchés par un événement d’activité, mais cette méthode n’est pas idéale pour les salutations à cause des effets secondaires.

• Types de médias non pris en charge : Les médias comme les images GIF ne sont pas rendus.

• URL intégrées : Microsoft 365 Copilot peut supprimer des URL incorporées pour des raisons de sécurité. Les citations des réponses génératives doivent inclure des URL dans la section citation.

• Types de nœuds non pris en charge :

  • Opérations vocales
  • Remise au représentant du service à la clientèle
  • Adaptive Cards avec Action.Execute

• Types de messages non pris en charge :

  • Cartes de base (ContentFiltered erreur)
  • Vidéo (ContentFiltered erreur)
  • Image (ContentFiltered erreur)
  • Fichier
  • Discours (non envoyé)

  Remarque

  Vous pouvez utiliser Adaptive Cards pour afficher des images.

• Le déclencheur d'inactivité se déclenche, mais ne renvoie pas de messages à Microsoft 365 Copilot.

• Les agents publiés dans Microsoft 365 Copilot ne prennent pas en charge les commentaires des utilisateurs (réactions).

Informations associées

• Déployer les agents dans Microsoft Teams