Connecter et configurez un agent pour Microsoft Teams

Une fois votre agent publié, vous pouvez le mettre à la disposition des utilisateurs dans Teams. De cette façon, vous-même, vos collègues et l’ensemble de l’organisation pourront interagir avec lui. Vous devez publier le agent au moins une fois avant que les utilisateurs puissent interagir avec le agent dans Teams.

Vous pouvez :

• Personnalisez l’apparence de votre agent dans Teams
• Installez le agent pour vous-même dans Teams
• Partager le lien d’installation de agent avec d’autres utilisateurs
• Affichez le agent dans l’App Store Teams.
  • Affichez le agent aux utilisateurs partagés en l’ajoutant à la section des extensions agent de l’App Store Teams.
  • Partager le agent avec l’organisation en soumettant le agent pour approbation par l’administrateur afin qu’il soit présenté dans la section Conçu pour votre organisation de l’App Store Teams.
• Ajoutez le agent à un canal d’équipe.
• Téléchargez le manifeste de l’application pour votre agent pour le distribuer dans votre locataire Teams.

Lorsque vous ajoutez un agent à Teams, certaines de vos données, telles que le contenu agent et le contenu du chat 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

• Partager votre agent avec d’autres utilisateurs afin qu’ils puissent installer et discuter avec les agent dans Teams.
• Votre organisation doit autoriser l’ajout d’applications à Teams avant que vous ou d’autres utilisateurs puissiez installer directement une extension agent dans Teams ou la trouver dans la section Microsoft Power Platform extensions agent de l’App Store Teams. Collaborez avec votre administrateur pour Gérer les applications Microsoft Power Platform dans le centre d’administration Microsoft Teams si cette option est désactivée pour votre organisation.
• Les agents qui apparaissent dans la section Conçu pour votre organisation (approuvés par un administrateur) sont gérés séparément par les administrateurs dans la page Gérer les applications de Teams Centre d’administration.
• Avant d’installer un agent pour vous-même ou de le partager avec d’autres, vous devez publier le agent au moins une fois.

Connecter et agent sur la chaîne Microsoft Teams

Après avoir publié votre agent au moins une fois, vous pouvez le Connecter sur le canal Microsoft Teams pour permettre aux utilisateurs de discuter avec lui dans Teams.

Note

Nous vous recommandons d’activer les paramètres de sécurité pour les agents conçus pour Teams ou pour une utilisation interne par les employés, afin d’empêcher les personnes extérieures à votre organisation d’utiliser ces agents. ...

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Activer Teams.

   

   Note

   Si vous ne voyez pas cette option, alors le canal Microsoft Teams est déjà activé.

Personnaliser l’apparence d’un agent pour Teams

Il est important de fournir la description et l’apparence appropriées pour un agent avant de le mettre à disposition d’autres utilisateurs, car cela les informe de l’objectif et de l’image de marque du agent, le cas échéant.

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionner Modifiez les détails pour modifier l’icône, la couleur et les descriptions de agent. Ces attributs sont visibles dans l’App Store Teams et dans l’onglet À propos de l’application une fois que l’utilisateur a installé agent. Consultez les consignes relatives au format des icônes d’application pour Teams.

   Important

   Les modifications apportées aux détails d’un agent ne sont pas disponibles pour les utilisateurs qui ont déjà installé le agent à partir d’un lien partagé ou de la section extensions agent de l’App Store Teams. Les utilisateurs doivent réinstaller le agent pour obtenir les mises à jour.

   Pour les agents qui ont été approuvés par un administrateur, vous devez soumettre à nouveau le 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

   Vous devez fournir ces informations pour informer les utilisateurs de votre agent. Pour plus d’informations, voir Créer une déclaration de confidentialité et les conditions d’utilisation dans Microsoft Teams.

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

Note

La personnalisation des icônes dans cette section s’applique uniquement à l’avatar agent pour les agents qui sont approuvés par l’administrateur et ne s’applique pas aux utilisateurs qui installent agent avec un lien d’installation direct ou à partir de la section des extensions agent de l’App Store Teams. Vous pouvez personnaliser l’avatar agent sur Personnaliser l’apparence et la convivialité du agent.

Installer un agent en tant qu’application dans Teams

Une fois votre agent publié, vous pouvez ajouter le agent à votre propre profil Teams directement depuis Copilot Studio.

Important

Le nouveau contenu d’un agent fraîchement publié n’apparaîtra pas dans les conversations actuellement en cours.

Vous pouvez taper "Recommencer" dans une conversation existante pour démarrer immédiatement une nouvelle conversation et voir les dernières mises à jour du agent.

Nous vous recommandons d’ajouter d’abord votre agent à votre propre profil dans Teams, avant de le partager avec d’autres.

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionner Open agent pour que l’invite d’installation se lance dans Teams. Sélectionnez Ajouter pour l’ajouter en tant qu’application dans Teams. Cette opération installe uniquement le agent pour vous.

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

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Options de disponibilité.

3. Sélectionnez Copier le lien.

4. Partager le lien avec les utilisateurs afin qu’ils puissent installer le agent dans Teams.

Important

Seuls les utilisateurs qui peuvent accéder au agent peuvent utiliser le lien d’installation pour installer le agent. Vous pouvez Partager le agent donner aux utilisateurs l’accès au agent.

Il n’est pas possible d’utiliser un lien d’installation dans l’application mobile Teams. Pour vous assurer que votre agent est disponible pour les utilisateurs mobiles de Teams, configurez-le pour qu’il s’affiche dans l’App Store Teams.

Afficher un agent dans l’App Store Teams

Une fois que vous avez publié votre agent, vous pouvez l’afficher dans l’App Store Teams afin que les utilisateurs puissent le trouver et l’installer.

Afficher aux utilisateurs partagés

Vous pouvez Partager votre agent en l’ajoutant au Extensions agent section de la boutique d’applications Teams. Seulement utilisateurs partagés vous pouvez y retrouver le agent.

Important

Seuls les utilisateurs partagés peuvent trouver et installer le agent dans la section extensions agent de l’App Store Teams. Le agent ne s’affiche pas pour tout le monde dans l’organisation même s’il est configuré pour permettre à tout le monde d’utiliser le agent. Pour afficher le agent à l’organisation, soumettez le agent à l’approbation d’un administrateur pour l’afficher dans la section Conçu pour votre organisation de l’App Store Teams.

Un agent ne peut apparaître dans la section extensions agent de l’App Store Teams que si le nombre total d’utilisateurs partagés ne dépasse pas les limites imposées par la politique de découverte de l’App Store Teams pour votre locataire. Pour rendre votre agent accessible à un plus grand nombre d’utilisateurs, collaborez avec votre administrateur pour montrer le agent à l’organisation.

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Options de disponibilité.

3. Sélectionner Montrez à mes coéquipiers et vérifiez qui a accès au agent.

4. Confirmez que la case à cocher Visible dans les extensions agent est sélectionnée et que Sélectionner Partager.

   Votre agent devient disponible dans la section extensions agent de l’App Store Teams, et une étiquette verte Ajouté à Teams apparaît sur la page des options de disponibilité.

Note

Si votre application n’apparaît pas dans la section agent extensions , il se peut que votre application Teams mette en cache des informations.

Essayez de vous déconnecter et de vous connecter (si vous utilisez l’application de bureau Teams) ou d’actualiser votre navigateur (si vous utilisez l’application Teams web).

Supprimer un agent de la section des extensions agent

Vous pouvez supprimer un agent de la section extensions agent . La suppression du agent n’affecte pas les utilisateurs avec le agent installé.

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Options de disponibilité.

3. Sélectionner Afficher à mes coéquipiers et décochez la case Visible dans les extensions agent .

4. Sélectionnez Partager. Le agent n’apparaît plus dans la section extensions agent de l’App Store Teams.

Afficher à l’organisation

Vous pouvez partager un Partager avec votre organisation en le soumettant à l’approbation de l’administrateur pour qu’il soit présenté dans la section Conçu pour votre organisation de l’App Store Teams. Présenter votre application dans Conçu pour votre organisation est un excellent moyen de diffuser largement votre agent en collaborant avec votre administrateur pour la déployer à tous les membres de l’organisation ou à un sous-ensemble d’utilisateurs.

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

Avant de soumettre un agent à votre organisation, assurez-vous que :

• Votre agent est prêt à être publié et conforme aux normes, règles et politiques de l’entreprise.
• Vous coordonnez avec d’autres gestionnaires de agent. Une fois que vous avez soumis un agent, un autre utilisateur ne peut pas le soumettre à nouveau jusqu’à ce qu’un administrateur approuve ou rejette la soumission précédente.
• Vous supprimez le agent, le cas échéant, de la section extensions agent de l’App Store Teams. Sinon, si vous soumettez votre agent à l’approbation de l’administrateur, il pourrait finir par apparaître à deux endroits.

Note

Une fois qu’un agent est approuvé par un administrateur, la disponibilité de agent dans la section Conçu pour votre organisation est gérée par votre administrateur. Seul un administrateur peut supprimer le agent de la section Conçu pour votre organisation .

Soumettez un agent pour la section Conçu pour votre organisation

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Options de disponibilité.

3. Confirmez que le agent n’est pas affiché aux coéquipiers ou aux utilisateurs partagés. Supprimez-le s’il indique Ajouté aux équipes.

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.

   Note

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

   Une fois approuvée, tous les utilisateurs nouveaux et existants de agent dans Teams reçoivent la mise à jour.

   Ceci s’applique uniquement aux détails agent. Vous pouvez toujours apporter des mises à jour de contenu à votre agent et le publier aussi souvent que vous le souhaitez. Vous n’avez pas besoin de soumettre à nouveau votre agent pour approbation après avoir publié de telles modifications de contenu.

   Une invite de confirmation finale apparaît.

6. Sélectionnez Oui pour continuer. Le agent est envoyé à votre administrateur pour approbation, et vous pouvez voir une note indiquant le statut de votre soumission.

   Note

   Après avoir soumis le agent à l’approbation de l’administrateur, vous ne devez pas modifier le paramètre d’accès du agent pour qu’il soit inférieur à celui de toutes les personnes de votre organisation.

   Le paramètre sur moins de tout le monde a pour conséquence que les utilisateurs de l’organisation ne peuvent pas discuter avec agent après l’avoir installé à partir de la section Conçu pour votre organisation de l’App Store Teams.

   Travaillez avec votre administrateur sur la Microsoft Teams politique d’application pour déterminer qui peut trouver et installer le agent.

7. Attendez l’approbation de votre administrateur. Vous pouvez vérifier le dernier statut en sélectionnant Rafraîchir, ou en ouvrant le Rendre le agent accessible aux autres fenêtre de la Publier page.

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

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

Note

Si votre application n’apparaît pas dans la section Créé pour votre organisaton, même si il est indiqué la mention Approuvé, votre application Teams met peut-être des informations en cache.

Essayez de vous déconnecter et de vous reconnecter (si vous utilisez l’application de bureau) ou d’actualiser votre navigateur (si vous utilisez l’application Teams web).

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

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

• Votre agent favorise la collaboration, comme le partage des dernières informations sur le rapport de vente avec le reste de l’équipe de vente.
• Vous souhaitez permettre à tous les membres de l’équipe d’interagir avec le agent dans un canal d’équipe ou via un chat privé sans avoir à installer manuellement le 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 discussions de groupe et de réunion dans Teams. Avec ces options sélectionnées, le agent a accès à l’historique des conversations du canal d’équipe, du chat de groupe ou du chat de réunion, ce qui aide le agent à fournir des réponses mieux adaptées au contexte de la conversation.

Lorsque les utilisateurs installent un agent depuis la boutique d’applications 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 le agent : ... ...

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

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

Important

Le agent doit être configuré pour permettre à tous les membres de l’organisation de discuter avec lui. Cela garantit que tous les membres de l’équipe ont la permission de discuter avec le agent. Nous vous recommandons de ne pas modifier le paramètre de sécurité du agent après avoir activé cette fonctionnalité. Sinon, les utilisateurs pourraient voir des erreurs d’autorisation lorsqu’ils essaient d’interagir avec agent dans les canaux Teams ou les discussions de groupe.

Pour permettre aux utilisateurs d’ajouter un agent à une équipe :

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Modifier les détails.

3. Sélectionner Autorisez vos utilisateurs à ajouter ce agent à une équipe.

4. Sélectionnez Enregistrer.

Teams met en cache les informations, il peut donc s’écouler un certain temps avant que les utilisateurs ne voient l’option permettant d’ajouter le 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 précédemment soumis le agent pour approbation administrative, vous devez le soumettre à nouveau après avoir activé cette option. L’administrateur doit approuver vos modifications avant que les utilisateurs puissent ajouter le agent à leurs équipes à partir de la section Conçu pour votre organisation de l’App Store Teams.

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

La désactivation de cette option empêche les utilisateurs d’ajouter un agent à une nouvelle équipe, un nouveau groupe ou une nouvelle discussion de réunion. Si vous avez déjà ajouté un agent à une conversation, la désactivation de cette option ne le supprime pas. Vous devez supprimer manuellement le agent. ...

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

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Modifier les détails.

3. Décochez la case Autoriser vos utilisateurs à ajouter ce agent à une équipe .

4. Sélectionnez 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 le agent sans avoir à installer manuellement le agent eux-mêmes.

Note

La configuration du message d’accueil privé est disponible uniquement pour les chatbots classiques.

Lorsqu’il est activé, votre agent démarre automatiquement une conversation avec les membres de l’équipe. Pour personnaliser le message d’accueil de agent, modifiez le message d’accueil rubrique système.

Considérez à quel point le agent est pertinent pour les membres de l’équipe. Assurez-vous que le message d’accueil du agent les aide à comprendre ce qu’il faut en faire, décrit ses limites et, surtout, les met à l’aise pour interagir avec lui.

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

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Paramètres.

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

4. Sélectionnez Enregistrer.

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

Vous pouvez télécharger le manifeste de l’application Teams de agent pour apporter des modifications détaillées au manifeste directement et Partager avec votre administrateur ou vos utilisateurs dans le locataire. 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 le canal Microsoft Teams.

2. Sélectionnez Options de disponibilité.

3. Sélectionnez Télécharger le fichier .zip.

   Le manifeste est généré sous forme de fichier .zip et est enregistré en fonction des paramètres de sauvegarde de votre navigateur.

Déconnecter un agent de Teams

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

Les agents déconnectés n’apparaissent pas dans la section extensions agent de l’App Store Teams et ne peuvent pas ê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.

Après avoir déconnecté un agent qui a été approuvé par un administrateur, il continue d’apparaître dans le Conçu pour votre organisation section de la boutique d’applications Teams. Vous devez demander à votre administrateur de le supprimer.

1. Ouvrez le panneau de configuration pour le canal Microsoft Teams.

2. Sélectionnez Déconnecter de Teams.

3. Consultez les informations sur la déconnexion de votre agent et Sélectionner Déconnecter pour continuer.

Vous pouvez toujours reconnecter votre agent en sélectionnant Activer Teams dans le Rendre le agent accessible aux autres fenêtre sur le Publier page.

Ouvrir le panneau de configuration pour le canal Microsoft Teams

1. Ouvrez votre agent dans Copilot Studio.

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

3. Sélectionnez la mosaïque Microsoft Teams. Le panneau de configuration apparaît.

Limitations connues

• Configuration de l’accueil privé n’est pas pris en charge pour les agents utilisant le canevas de création unifié mis à niveau.
• Définition de l’icône d’avatar agent sur la page de détails n’apparaît pas pour les agents approuvés par un administrateur. Les agents approuvés par un administrateur utilisent l’icône de l’application comme avatar agent.
• Les équipes ont limitation de débit sur les agents. En fonction des besoins de votre entreprise, vous souhaiterez peut-être garder votre contenu agent concis pour les agents ajoutés à Teams.
• Actuellement, si votre agent prend en charge l’authentification de l’utilisateur final, l’utilisateur ne peut pas se déconnecter explicitement. Ce comportement fait échouer la certification si vous publiez votre agent dans le tableau de bord du vendeur. Microsoft Teams AppSource Cette limitation ne s’applique pas à l’utilisation personnelle ou locataire du agent. En savoir plus sur la façon de publier votre application sur le Teams Store et sur la AppSource politique de certification.
• Une fois que vous avez déconnecté votre agent du canal, il faudra peut-être quelques minutes avant que le agent ne devienne inaccessible pour les utilisateurs de Teams. Microsoft Teams
• Les discussions de groupe et les discussions 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.