Erstellen eines Bots mithilfe des Bot Framework SDK für .NETCreate a bot with the Bot Framework SDK for .NET

gilt für: SDK v4APPLIES TO: SDK v4

In diesem Artikel erfahren Sie, wie Sie einen Bot mithilfe der c#-Vorlage erstellen und dann mit dem bot Framework-Emulator testen.This article shows you how to build a bot by using the C# template, and then how to test it with the Bot Framework Emulator.

Bots können sowohl mit Azure Bot Service als auch lokal erstellt werden.Creating a bot with Azure Bot Service and creating a bot locally are independent, parallel ways to create a bot.

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

Zusätzliche RessourcenAdditional resources

  • Weitere Informationen zu den .net Core-Vorlagen finden Sie in der Infodatei für .net Core SDK Vorlagen .See the .NET Core SDK Templates README for more information about the .NET Core templates.
  • Weitere Informationen finden Sie unter Gewusst wie: Debuggen eines Bots zum Debuggen mit Visual Studio oder Visual Studio Code und dem bot Framework-Emulator.See how to debug a bot for how to debug using Visual Studio or Visual Studio Code and the Bot Framework Emulator.
  • Weitere Informationen zum Installieren von ngrok finden Sie unter Tunneling(ngrok) .See Tunneling (ngrok) for information on how to install ngrok.

Nächste SchritteNext steps