Créer et déboguer un bot avec le CLI et Visual Studio Code

Un billet blog d'Hinault Romaric

Le 26/12/2020, par Hinault Romaric, Responsable .NET

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 :

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 :

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 :

dotnet new echobot -n MyEchoBot

Si vous voulez utiliser le modèle CoreBot, la commande doit être la suivante :

Code :

dotnet new corebot -n MyCoreBot

Pour un projet avec le modèle EmptyBot, exécutez la commande suivante :

Code :

dotnet new emptybot -n MyEmptyBot

Dans notre exemple, nous allons créer un nouveau projet en utilisant la modèle Echo Bot.

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 :

 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.

Billet blog