Premiers pas avec botframework

Installation ou configuration


C#

  1. Visual Studio 2015 (dernière mise à jour) - vous pouvez télécharger gratuitement la version communautaire ici : [www.VisualStudio.com][1]

  2. Important : mettre à jour toutes les extensions VS vers leurs dernières versions Tools->Extensions and Updates->Updates

  3. Téléchargez le modèle d’application Bot à partir d’ici : [Template Download][2] Enregistrez le fichier zip dans votre répertoire de modèles Visual Studio 2015, qui se trouve traditionnellement dans “%USERPROFILE%\Documents\Visual Studio 2015\Templates\ProjectTemplates \Visual C#" Remarque : vous devrez redémarrer Visual Studio après cette étape, afin d’utiliser le modèle.

[![Nouveau projet d’application de bot][3]][3]

  1. Créez un nouveau projet C# à l’aide du nouveau modèle d’application Bot

[![Solution d’application de bot][4]][4]

Une fois votre bot créé, vous devriez avoir une solution similaire à celle-ci :

[![Fenêtre du navigateur d’applications de bot][5]][5]

  1. Exécutez l’application en appuyant sur F5 ou en cliquant sur le bouton vert Exécuter dans la barre d’outils. Étant donné que notre nouveau bot est en fait un projet WebAPI, une fenêtre de navigateur s’ouvrira sur la page default.htm. Le bot est maintenant en cours d’exécution et exposé localement. Notez l’URL … il sera nécessaire de configurer l’émulateur Bot Framework à l’étape suivante.

Node.js

  1. Créez un nouveau projet node.js en utilisant npm init.

  2. Installez le SDK botbuilder et restify à l’aide des commandes npm suivantes :

    npm install –save botbuilder npm install –save restify

  3. Pour créer votre bot, créez un nouveau fichier appelé index.js et copiez le code suivant pour initialiser le bot.

    var restify = require(‘restify’); var builder = require(‘botbuilder’);

    // Setup Restify Server var server = restify.createServer(); server.listen(process.env.port || process.env.PORT || 3978, function () { console.log(’%s listening to %s’, server.name, server.url); });

    // Create chat connector for communicating with the Bot Framework Service var connector = new builder.ChatConnector({ appId: process.env.MICROSOFT_APP_ID, appPassword: process.env.MICROSOFT_APP_PASSWORD });

    var bot = new builder.UniversalBot(connector);

  4. Vous devriez maintenant pouvoir exécuter ce fichier en utilisant node index.js.

Il s’agit d’une configuration de base qui sera requise pour tous les bots créés avec le bot framework. Vous pouvez traiter cela comme un projet de modèle vierge pour commencer. Il initialise un serveur restify pour votre bot et crée un connecteur pour connecter les machines locales à votre serveur.

Téléchargement de l’émulateur pour le débogage (à la fois pour le nœud et C#)

[![Image de l’émulateur][6]][6]

  1. Téléchargez et installez Bot Framework Emulator [Téléchargement de l’émulateur][7]

  2. Exécutez l’émulateur et saisissez l’URL de l’étape 5 (C#) dans la zone de texte URL du point de terminaison. Ensuite, cliquez sur “Se connecter”.

[![Connexion au robot][8]][8]

  1. Vous devriez maintenant pouvoir communiquer avec votre bot en utilisant la fenêtre de chat de l’émulateur. Vous verrez les détails de la conversation enregistrés en bas à droite, et vous pouvez cliquer sur les éléments de ligne Publier et Obtenir pour voir le json qui a été transmis dans les deux sens.

[![entrez la description de l’image ici][9]][9]

Félicitations pour la création d’un bot à l’aide de Microsoft Bot Framework !

[1] : https://www.visualstudio.com/downloads/ [2] : http://aka.ms/bf-bc-vstemplate [3] : https://i.stack.imgur.com/8xBXo.png [4] : https://i.stack.imgur.com/OOMjM.png [5] : https://i.stack.imgur.com/bWAXo.png [6] : https://i.stack.imgur.com/8tsD2.png [7] : https://aka.ms/bf-bc-emulator [8] : https://i.stack.imgur.com/Jw4aM.png [9] : https://i.stack.imgur.com/6uqSp.png