Tutorial: Erstellen eines EinfachbotsTutorial: Create a basic bot

gilt für: SDK v4APPLIES TO: SDK v4

In diesem Tutorial wird beschrieben, wie Sie einen einfachen Bot mit dem Bot Framework SDK erstellen.This tutorial describes how to create a basic bot with the Bot Framework SDK. Wenn Sie bereits einen Basisbot erstellt und lokal ausgeführt haben, lesen Sie den Artikel Tutorial: Bereitstellen eines einfachen Bots.If you've already created a basic bot and have it running locally, read the Tutorial: Deploy a basic bot article.

Sie lernen Folgendes:You will learn how to:

  • Erstellen eines BasisbotsCreate a basic bot
  • Ausführen des Bots auf Ihrem lokalen ComputerRun the bot on your local machine
  • Testen Sie es mithilfe Bot Framework EmulatorTest it using the Bot Framework Emulator

VoraussetzungenPrerequisites

VorlagenTemplates

Um die Botvorlagen zu Visual Studio hinzufügen, laden Sie die Bot Framework v4 SDK Templates for Visual Studio VSIX-Datei herunter, und installieren Sie sie.To add the bot templates to Visual Studio, download and install the Bot Framework v4 SDK Templates for Visual Studio VSIX file.

Hinweis

Das VSIX -Paket umfasst sowohl .net Core 2,1-als auch .net Core 3,1-Versionen der c#-Vorlagen.The VSIX package includes both .NET Core 2.1 and .NET Core 3.1 versions of the C# templates. Sie sollten beim Erstellen neuer Bots in Visual Studio 2019 die .NET Core 3.1-Vorlagen verwenden.When creating new bots in Visual Studio 2019, you should use the .NET Core 3.1 templates. Für die aktuellen Botbeispiele werden .NET Core 3.1-Vorlagen verwendet.The current bot samples use .NET Core 3.1 templates. Beispiele mit .NET Core 2.1-Vorlagen finden Sie im Branch 4.7-archive des Repositorys BotBuilder-Samples.You can find the samples that use .NET Core 2.1 templates in the 4.7-archive branch of the BotBuilder-Samples repository. Informationen zum Bereitstellen von .net Core 3,1-Bots in Azure finden Sie unter Bereitstellen Ihres bot in Azure.For information about deploying .NET Core 3.1 bots to Azure, see how to deploy your bot to Azure.

Erstellen eines BotsCreate a bot

Erstellen mit Visual StudioBuild with Visual Studio

Erstellen Sie in Visual Studio mithilfe der Vorlage Echo Bot (Bot Framework v4 – .NET Core 3.1) ein neues Botprojekt.In Visual Studio, create a new bot project using the Echo Bot (Bot Framework v4 - .NET Core 3.1) template. Wählen Sie aus den Projekttypen AI Bots (KI-Bots) aus, um nur Botvorlagen anzuzeigen.Choose AI Bots from the project types to show only bot templates.

Visual Studio-Dialogfeld „Neues Projekt erstellen“Visual Studio create a new project dialog

Dank der Vorlage enthält Ihr Projekt sämtlichen Code, der zum Erstellen des Bots in dieser Schnellstartanleitung erforderlich ist.Thanks to the template, your project contains all the code that's necessary to create the bot in this quickstart. Zum Testen des Bots benötigen Sie keinen zusätzlichen Code.You don't need any additional code to test your bot.

Hinweis

Wenn Sie einen Kernbot erstellen, benötigen Sie ein Luis-Sprachmodell.If you create a Core bot, you'll need a LUIS language model. Sie können ein Sprachmodell unter Luis.AIerstellen.You can create a language model at luis.ai. Aktualisieren Sie die Konfigurationsdatei, nachdem Sie das Modell erstellt haben.After creating the model, update the configuration file.

Starten Ihres BotsStart your bot

Starten Sie das Projekt in Visual Studio.In Visual Studio, start the project. Dadurch wird die Anwendung erstellt, auf „localhost“ bereitgestellt der Webbrowser mit der Seite default.htm der Anwendung geöffnet.This will build the application, deploy it to localhost, and launch the web browser to display the application's default.htm page. Zu diesem Zeitpunkt wird Ihr Bot lokal an Port 3978 ausgeführt.At this point, your bot is running locally on port 3978.

Starten des Emulators und Herstellen einer Verbindung mit Ihrem BotStart the Emulator and connect your bot

  1. Starten Sie den Bot Framework-Emulator.Start the Bot Framework Emulator.

  2. Wählen Sie auf der Registerkarte Willkommen des Emulators die Option Bot öffnen aus. Select Open Bot on the Emulator's Welcome tab.

  3. Geben Sie die URL Ihres Bots ein. Dabei handelt es sich um die URL des lokalen Ports, die dem Pfad hinzugefügt /api/messages wird(in der Regel http://localhost:3978/api/messages ).Enter your bot's URL, which is the URL of the local port, with /api/messages added to the path, typically http://localhost:3978/api/messages.

    Öffnen eines Bots

  4. Wählen Sie dann Verbinden aus.Then select Connect.

    Senden Sie eine Nachricht an Ihren Bot, und der Bot antwortet.Send a message to your bot, and the bot will respond back.

    Echomeldung

Nächste SchritteNext steps