Comment créer un robot simple dans Microsoft Teams
L’une des fonctionnalités les plus puissantes de Microsoft Teams est la possibilité de créer et de connecter des bots. Ces robots permettent aux capacités conversationnelles et transactionnelles de créer facilement des tâches plus complexes.
Au-delà du codage proprement dit d’un bot pour effectuer des tâches utiles, la mise en œuvre de l’infrastructure a été un défi. En effet, les bots nécessitent généralement un support de service Web configuré de manière spécifique, ce qui rend la création et le test rapides d’un bot plus difficile.
Microsoft a créé un service Web App Bot qui regroupe toutes les infrastructures nécessaires pour vous permettre de commencer rapidement à développer un bot, à tester et, finalement, à publier ce bot dans Teams. Dans cet article, nous explorons comment commencer rapidement à utiliser le modèle de bot Echo.
Sommaire
Création d’un bot d’application Web
Le moyen le plus rapide de créer un nouveau Web App Bot consiste à utiliser la fonction de recherche du portail Microsoft pour localiser le Web App Bot sur la place de marché sous le service Bot Services.
Une fois que vous avez cliqué sur le Web App Bot, vous êtes dirigé vers un assistant pour provisionner votre bot et ses configurations nécessaires.
- Poignée de bot:
lctestbot
- Il s’agit d’une poignée unique qui doit être différente des bots existants car elle vit
azurewebsites.net
.
- Il s’agit d’une poignée unique qui doit être différente des bots existants car elle vit
- Abonnement: {abonnement locataire}
- Groupe de ressources: {groupe de ressources pour le bot}
- Emplacement: {emplacement pour placer le bot}
- Niveau de tarification: 1 $ (1 000 messages Premium / unité)
- Il existe également une option 10k.
- Nom de l’application:
lctestbot
- Modèle de bot: Echo Bot (C #)
- Plan de service d’application / emplacement:
lctestbot/Central US
- Par défaut, vous devez cliquer dessus pour créer un nouvel emplacement.
- Application Insights: Sur
- Emplacement Application Insights: Centre des États-Unis
- Il est recommandé que ce soit le même que celui où vous localisez le bot.
- Identifiant et mot de passe de l’application Microsoft: Créer automatiquement un identifiant et un mot de passe d’application
- Il est recommandé de laisser Azure gérer cela, sauf si vous avez une raison d’utiliser un ID d’application et un mot de passe spécifiques.
Vous devrez vous assurer que deux fournisseurs sont inscrits pour votre abonnement: Microsoft.Storage et Microsoft.BotService. Ceux-ci sont situés sous votre abonnement → Fournisseurs de ressources. Vous constaterez peut-être que la première fois que vous chargez Web App Bot, il se plaint de ne pas avoir enregistré Microsoft.BotService. Cependant, si vous quittez et entrez à nouveau, cela fonctionnera très probablement. Ce service s’enregistre automatiquement la première fois que vous le chargez et prend un moment.
Créer un bot d’application Web
Une fois le Web App Bot créé, vous avez accès aux pages de configuration du bot. Dans cet exemple, nous allons faire une simple modification du code source existant, réexécuter le script de construction, tester, puis tester dans un client Teams.
Accédez à la page Générer, puis recherchez le lien Ouvrir l’éditeur de code en ligne. En cliquant sur ce lien, vous ouvrez l’éditeur App Service, ce qui facilite la modification rapide du code et la réexécution du script de construction.
Il existe de nombreux codes de support pour faire fonctionner le bot, mais le cœur du code se trouve dans le dossier Bots. Celui-ci contient le EchoBot.cs
fichier, que nous allons modifier. Comme vous pouvez le voir dans le code ci-dessous, nous allons ajouter le Test
texte précédant l’existant Echo
texte. En modifiant le code, le fichier sera enregistré au fur et à mesure et vous n’avez pas besoin d’enregistrer manuellement les modifications.
Accédez à la console et entrez dans le build.cmd
commander. Cela exécutera une série de commandes, recompilera le code et, finalement, copiera les fichiers compilés là où ils doivent aller pour rendre le bot disponible. À la fin, vous devriez voir un Finished successfully
message indiquant que les fichiers compilés sont maintenant disponibles.
Test du bot d’application Web
Heureusement, il existe une fonctionnalité de test dans Web Chat intégrée directement dans les services Microsoft Portal Web App Bot. Cet outil utile nous permet de tester comment le bot réagit au dialogue conversationnel et aux commandes simples. Dans ce cas, notre bot renvoie simplement le texte. Pour vous assurer que notre modification a pris effet, lorsque vous envoyez du texte, vous devriez voir le même texte en écho avec le texte précédent de Test Echo:
.
Ensuite, nous voulons tester ce bot dans un client Teams réel. Par défaut, le seul canal connecté est le Web Chat. Cliquez sur l’icône «Teams» pour connecter ce bot au canal Teams.
Dans ce cas, nous allons utiliser toutes les valeurs par défaut, qui est l’option de messagerie commerciale de Microsoft Teams, et toutes les autres options restent les mêmes. Cliquez sur «Enregistrer» pour le rendre disponible sur le canal Microsoft Teams.
Pour charger le bot dans un client Teams, cliquez simplement sur le lien Microsoft Teams, et il chargera automatiquement le bot dans votre client Teams.
Comme vous pouvez le voir ci-dessous, le bot est disponible pour le client, et nous pouvons le tester en envoyant un message de discussion et en voyant que le résultat est comme prévu.
Conclusion
Microsoft Teams offre une puissante expérience de bot, mais pour faciliter le développement, tirez parti du service Web App Bot dans Microsoft Azure. Cela vous permet de créer un robot de test facile à utiliser et rapide à développer, que ce soit à partir de l’éditeur de code en ligne ou d’un éditeur hors ligne tel que VS Code. Commencez à développer des bots Microsoft Teams dès aujourd’hui!