Créer un bot à l’aide du kit de développement logiciel (SDK) Bot Framework

S’APPLIQUE À : KIT de développement logiciel (SDK) v4

Cet article explique comment créer votre premier bot avec le Kit de développement logiciel (SDK) Bot Framework pour C#, Java, JavaScript ou Python, et comment tester votre bot avec le Bot Framework Emulator.

La création de votre premier bot ne nécessite pas d’abonnement Azure ni de ressource Azure Bot Service. Ce guide de démarrage rapide se concentre sur la création de votre premier bot localement. Si vous souhaitez savoir comment créer un bot dans Azure, consultez Créer une ressource Azure Bot.

Notes

Les sdk Python et Java bot Framework sont mis hors service avec une prise en charge finale à long terme qui se termine en novembre 2023. Seuls les correctifs de sécurité et de bogues critiques au sein de ce dépôt seront entrepris. Les bots existants créés avec ces SDK continueront de fonctionner.

Pour le développement de nouveaux bots, envisagez d’utiliser Power Virtual Agents. Pour plus d’informations, consultez L’avenir de la génération de bots.

Prérequis

Modèles C#

Les exemples de bot actuels utilisent des modèles .NET Core 3.1.

Pour ajouter les modèles de bot à Visual Studio, téléchargez et installez le fichier Bot Framework v4 SDK Templates for Visual Studio VSIX.

Notes

Vous pouvez installer les modèles à partir de Visual Studio.

  1. Dans le menu, sélectionnez Extensions , puis Gérer les extensions.
  2. Dans la boîte de dialogue Gérer les extensions , recherchez et installez les modèles du Kit de développement logiciel (SDK) Bot Framework v4 pour Visual Studio.

Pour plus d’informations sur le déploiement de bots .NET sur Azure, consultez Comment approvisionner et publier un bot.

Créer un bot

Dans Visual Studio, créez un projet de bot et utilisez le modèle Echo Bot (Bot Framework v4 - .NET Core 3.1). Pour afficher uniquement les modèles de bots, choisissez le type de projet AI Bots .

Grâce au modèle, votre projet contient tout le code nécessaire pour créer le bot dans ce guide de démarrage rapide. Vous n’avez plus besoin de code pour tester votre bot.

Démarrer votre robot

Dans Visual Studio :

  1. Ouvrez votre projet de bot.
  2. Exécutez le projet sans débogage.
  3. Visual Studio génère l’application, la déploie sur localhost et lance le navigateur web pour afficher la page de default.htm l’application.

À ce stade, votre bot s’exécute localement sur le port 3978.

Démarrer l’émulateur et connecter votre robot

  1. Démarrez le Bot Framework Emulator.

  2. Sélectionnez Ouvrir le bot sous l’onglet Bienvenue de l’émulateur.

  3. Entrez l’URL de votre bot, qui est votre hôte local et votre port, avec /api/messages l’ajout au chemin d’accès. L’adresse est généralement : http://localhost:3978/api/messages.

    ouvrir un bot

  4. Sélectionnez Connecter.

    Envoyez un message à votre bot et celui-ci répondra.

    message d’écho

Étapes suivantes

  • Pour plus d’informations sur le débogage à l’aide de Visual Studio ou Visual Studio Code et de la Bot Framework Emulator, consultez Déboguer un bot.
  • Pour plus d’informations sur ngrok, consultez Tunneling (ngrok).