Générer automatiquement le fichier manifeste pour le chargement sur Microsoft Teams

Générez automatiquement le fichier manifeste et personnalisez la personnalisation de votre Microsoft Teams application afin de pouvoir la rendre Agent virtuel disponible dans votre organisation.

Avant de commencer

Rôle requis : virtual_agent_admin ou admin

Pourquoi et quand exécuter cette tâche

Remarque :

Custom Engine Agent (CEA) remplace l’ancien cadre de travail de Microsoft bot. Le CEA permet Agent virtuel d’être détectable par Microsoft Copilot, avec un accès fonctionnel complet à Now Assist dans Agent virtuel et aux conversations multitours.

Pour utiliser Copilot, activez la diffusion en continu sur votre assistant et l’application Microsoft Teams . La diffusion en continu pour Microsoft Copilot est active par défaut, tandis que la diffusion en continu pour Microsoft Teams est inactive par défaut. Confirmez que vous avez activé les deux pour accéder à l’ACE. Si la diffusion en continu n’est pas activée, le CEA peut vous laisser expirer sans préavis.

Dans la Zurich version, l’ACE est désactivé par défaut. Contactez votre ServiceNow® équipe d’assistance pour que l’ACE soit activé pour votre instance.

Un générateur de fichiers de manifeste automatisé sur la nouvelle Microsoft Teams interface utilisateur remplit automatiquement l’ID du bot et met à jour les autres paramètres (tels que la marque) en fonction de votre entrée, en tant qu’administrateur. Le générateur de fichiers manifeste permet également de télécharger le package de manifeste en une seule sélection.

• Avant de générer un fichier manifeste, vous devez créer un bot autoconfiguré (ou vous assurer qu’il a déjà été créé) dans l’instance ServiceNow . Vous pouvez ensuite générer un package de manifeste pour chaque bot autoconfiguré que vous créez.
• Après avoir enregistré le formulaire manifeste, vous pouvez télécharger le package zip du manifeste, qui contient les trois fichiers suivants :
  • manifest.json
  • color.png
  • outline.png
  Vous pouvez modifier le formulaire manifeste et le télécharger à nouveau autant de fois que vous le souhaitez.

Remarque :

Cette fonctionnalité ne s’applique que lorsque vous configurez l’intégration Agent virtuel avec Microsoft Teams. Si vous avez l’intention d’utiliser ServiceNowMicrosoft Teams des options avec ITSM ou RH, sélectionnez le lien En savoir plus à côté de Planification pour activer des intégrations ITSM et RH supplémentaires sur la page Configuration du bot. De cette façon, vous pouvez configurer le manifeste dans un module séparé au lieu de continuer à configurer le manifeste ici. Pour plus d’informations, consultez Créer et télécharger le fichier manifeste.

Procédure

1. Accédez à la Tous > Interfaces conversationnelles > Paramètres.
2. Dans Paramètres généraux, dans la section Canaux et acheminement, sélectionnez Afficher tout.
3. Sur la page Canaux et intégrations, dans la Microsoft Teams vignette, sélectionnez Gérer.
4. Dans la section Bot autoconfiguré, sélectionnez l’icône Gérer l’agent.
   Si vous n’avez pas activé l’extension de message et que vous y accédez pour la première fois, un message d’alerte Activer une nouvelle fonctionnalité s’affiche qui vous informe que la fonctionnalité d’extension de message de votre Microsoft Teams intégration peut désormais être activée.
5. Dans l’onglet Configuration , sélectionnez Modifier la configuration et renseignez les champs du formulaire.

   Tableau 1. Configurer votre bot : manifeste VA Microsoft Teams

   Champ	Description
   Nom court	Nom d’affichage court de votre application. Remarque : Assurez-vous que le nom ne dépasse pas 30 caractères.
   Nom complet	Nom complet de votre application. Utilisez le nom complet si le nom court de l’application dépasse 30 caractères. Remarque : Assurez-vous que le nom complet ne dépasse pas 100 caractères.
   ID de l'agent (Client)	Identificateur généré unique Microsoft . Ce champ est automatiquement lié à l’étape de création du bot et ne peut pas être modifié.
   Description brève	Brève description de votre expérience d’application. Utilisez une description brève lorsque l’espace est limité. Remarque : Assurez-vous que la description courte ne dépasse pas 80 caractères.
   Description complète	Description complète de votre application. Remarque : Assurez-vous que la description complète ne dépasse pas 4 000 caractères.
   Domaines valides	Liste des domaines valides pour les sites web que votre application prévoit de charger dans Microsoft Teams. Remarque : Actuellement, seul le ServiceNow domaine est pris en charge.
   Version	Version spécifique de votre application pour suivre la soumission incrémentielle du manifeste à Microsoft Teams. Par exemple, 1.0.0. Utilisez un maximum de 2 chiffres après chaque décimale. Remarque : Assurez-vous de mettre un nombre plus élevé pour chaque nouvelle version.
   Couleur d'accentuation	Couleur à utiliser comme arrière-plan pour vos icônes de contour. Remarque : La valeur doit être un code couleur HTML valide commençant par une balise de hachage (#). Par exemple, #293E40.
   Icône de couleur	Icône de votre application que vous souhaitez voir apparaître dans la plupart Microsoft Teams des scénarios. Vous pouvez sélectionner les options suivantes : Utiliser l’icône par défaut : remplace la couleur de l’icône par défaut. Utiliser une icône personnalisée : Modifie l’icône de couleur avec une couleur d’icône de votre choix. Remarque : Assurez-vous de charger uniquement les fichiers image .png qui ont moins de 192x192 pixels pour modifier la couleur de l’icône.
   Icône de contour	Icône affichée sur la barre de l’application lorsque l’application est en cours d’utilisation. Vous pouvez sélectionner les options suivantes : Utiliser l’icône par défaut : remplace l’icône de contour par l’icône de contour par défaut. Utiliser une icône personnalisée : remplace l’icône de contour par une icône de votre choix. Remarque : Assurez-vous de charger uniquement les fichiers image .png de moins de 32x32 pixels pour modifier l’icône de contour.
   Extension du message	Extension de message qui permet aux utilisateurs de rechercher et de partager les résultats via la zone de composition de message du Microsoft Teams client.

   Pour en savoir plus sur chaque champ, consultez la documentation Microsoft Teams.

6. Sélectionnez Enregistrer.
   Vous êtes redirigé vers la page de configuration du bot où le fichier manifeste est enregistré et prêt à être téléchargé.

   Remarque :

   Vous pouvez également modifier le fichier manifeste en sélectionnant Modifier la configuration sur la page de téléchargement et en téléchargeant le fichier autant de fois que vous le souhaitez. À chaque nouveau manifeste, assurez-vous de saisir un numéro de version plus élevé dans le champ Version afin que le formulaire mis à jour puisse être enregistré avec succès.

7. Sur la page de configuration du bot, sous Votre package, sélectionnez le bouton Télécharger pour télécharger votre fichier de package.
   Remarque :

   Vous pouvez également modifier le fichier manifeste en sélectionnant Modifier la configuration sur la page de téléchargement et en téléchargeant le fichier autant de fois que vous le souhaitez. Toutefois, à chaque nouveau manifeste, veillez à saisir un numéro de version plus élevé dans le champ Version afin d’enregistrer le formulaire mis à jour.

Que faire ensuite

Chargez le fichier du package de manifeste pour publier votre bot.