Dans de nombreux articles, y compris ceux que j’ai publié, il est présenté comment créer un bot en utilisant Visual Studio et les modèles de projets disponibles pour l’environnement de développement. Si vous utilisez Visual Studio Code et vous cherchez un article pour débuter et prendre en mains les outils de développement pour la création des bots, vous aurez de la difficulté à trouver des ressources pour vous accompagner. Dans ce billet de blog, nous verrons comment mettre en place son environnement et créer et déboguer un premier bot avec Visual Studio Code et le Bot framework SDK V4.
Prérequis :
- Visual Studio Code
- .NET Core 3.1
- Bot Framework Emulator
Le SDK bot framework est disponible via des pakacges NuGet. Aucune installation préalable n’est donc nécessaire.
Installation des Template
Trois modèles de projets sont offerts pour démarrer rapidement la création des agents conversationnel.
Le modèle Echo Bot
Ce modèle est légèrement plus qu'un classique "Hello World!". Ce modèle montre la structure de base d'un bot, comment un bot reçoit des messages d'un utilisateur et comment un bot envoie des messages à un utilisateur. C'est un bon choix pour les développeurs qui démarrent avec le Bot Framework v4.
Le modèle Core Bot
Ce modèle se compose d'un ensemble de fonctionnalités de base que la plupart des bots sont susceptibles d'avoir. S'appuyant sur les principales fonctionnalités de traitement des messages présentes dans le modèle Echo Bot, ce modèle ajoute un certain nombre de fonctionnalités plus sophistiquées.
On y retrouve notamment des fonctionnalités comme l’envois et la réception des messages, l’utilisation des cartes adaptives pour une meilleure expérience utilisateur, la prise en charge de l’intelligence artificielle avec LUIS, la prise en charge des dialogues ou encore la gestion des états.
Le modèle Empty Bot
Ce modèle dispose du squelette minimal d’un Bot. Si vous avez l'habitude de développer des bots avec le Bot Framework v4 et que vous souhaitez une configuration minimale, le modèle Empty Bot est fait pour vous.
Pour installer les trois modèles de projets ci-dessous, vous devez exécuter les commandes suivantes en invite en commandes :
| Code : | Sélectionner tout |
1 2 3 | dotnet new -i Microsoft.Bot.Framework.CSharp.EchoBot dotnet new -i Microsoft.Bot.Framework.CSharp.CoreBot dotnet new -i Microsoft.Bot.Framework.CSharp.EmptyBot |
Pour vérifier les composants installés, vous pouvez utiliser la commande :
| Code : | Sélectionner tout |
dotnet new --list
Création d’un nouveau Bot
Pour créer un nouveau bot, vous devez utiliser la commande dotnet new suivi du modèle à utiliser, puis du paramètre -n pour donner le nom du projet.
Pour un nouveau projet avec le modèle Echo Bot, vous devez exécuter la commande suivante :
| Code : | Sélectionner tout |
dotnet new echobot -n MyEchoBot
| Code : | Sélectionner tout |
dotnet new corebot -n MyCoreBot
| Code : | Sélectionner tout |
dotnet new emptybot -n MyEmptyBot
Ouvrir le projet dans la Visual Studio Code
Pour ouvrir le projet avec Visual Studio Code, vous devez vous positionner dans le répertoire racine du projet et exécuter la commande :
| Code : | Sélectionner tout |
code .
Votre projet va s’ouvrir dans Visual Studio Code. Vous pouvez visualiser le code minimal qui a été mis en place pour permettre au bot de répondre aux messages d’un utilisateur.
Vous pouvez démarrer le débogage de votre bot et le tester en utilisant le Bot Framework Emulator.
