Erstellen eines Bots mit dem Bot Framework SDK

GILT FÜR: SDK v4

In diesem Artikel wird beschrieben, wie Sie Ihren ersten Bot mit dem Bot Framework SDK für C#, Java, JavaScript oder Python erstellen und wie Sie Ihren Bot mit dem Bot Framework-Emulator testen.

Das Erstellen Ihres ersten Bots erfordert kein Azure-Abonnement oder eine Azure KI Bot Service-Ressource. Diese Schnellstartanleitung konzentriert sich auf die lokale Erstellung Ihres ersten Bots. Informationen zum Erstellen eines Bots in Azure finden Sie unter Erstellen einer Azure Bot-Ressource.

Hinweis

Die JavaScript-, C#- und Python-SDKs für Bot Framework werden weiterhin unterstützt, das Java-SDK wird jedoch eingestellt und der langfristige Support endet im November 2023. Es werden nur kritische Sicherheits- und Programmfehlerbehebungen innerhalb dieses Repositorys durchgeführt.

Bestehende Bots, die mit dem Java SDK erstellt wurden, werden weiterhin funktionieren.

Wenn Sie einen neuen Bot erstellen möchten, sollten Sie den Einsatz von Power Virtual Agents in Betracht ziehen und sich über die Auswahl der richtigen Chatbot-Lösung informieren.

Weitere Informationen finden Sie unter Die Zukunft des Bot-Design.

Voraussetzungen

C#-Vorlagen

Für die aktuellen Botbeispiele werden .NET Core 3.1-Vorlagen verwendet.

Um die Botvorlagen zu Visual Studio hinzuzufügen, laden Sie die Bot Framework v4 SDK-Vorlagen für Visual Studio VSIX herunter, und installieren Sie sie.

Hinweis

Sie können die Vorlagen aus Visual Studio installieren.

  1. Wählen Sie im Menü Erweiterungen die Option Erweiterungen verwalten aus.
  2. Suchen Sie im Dialogfeld Erweiterungen verwalten nach Bot Framework v4 SDK-Vorlagen für Visual Studio und installieren Sie sie.

Informationen zum Bereitstellen von .NET-Bots in Azure finden Sie unter Bereitstellen und Veröffentlichen eines Bots.

Erstellen eines Bots

Erstellen Sie in Visual Studio mithilfe der Vorlage Echo Bot (Bot Framework v4 – .NET Core 3.1) ein neues Botprojekt. Wählen Sie den KI Bots-Projekttypen aus, um nur Botvorlagen anzuzeigen.

Dank der Vorlage enthält Ihr Projekt sämtlichen Code, der zum Erstellen des Bots in dieser Schnellstartanleitung erforderlich ist. Zum Testen des Bots benötigen Sie keinen zusätzlichen Code.

Starten Ihres Bots

In Visual Studio:

  1. Öffnen Sie Ihr -Projekt.
  2. Führen Sie Ihr Programm ohne Debuggen aus.
  3. Dadurch wird die Anwendung erstellt, auf „localhost“ bereitgestellt und der Webbrowser mit der Seite default.htm der Anwendung geöffnet.

Zu diesem Zeitpunkt wird Ihr Bot lokal an Port 3978 ausgeführt.

Starten des Emulators und Herstellen einer Verbindung mit Ihrem Bot

  1. Starten Sie den Bot Framework-Emulator.

  2. Klicken Sie auf der Registerkarte Willkommen des Emulators auf den Link Bot öffnen.

  3. Geben Sie die URL Ihres Bots ein, bei der es sich um Ihren lokalen Host und Port handelt, denen der Pfad /api/messages hinzugefügt wurde. Die Adresse lautet in der Regel: http://localhost:3978/api/messages.

    open a bot

  4. Wählen Sie dann Verbinden aus.

    Senden Sie eine Nachricht an Ihren Bot und er antwortet.

    echo message

Nächste Schritte

  • Informationen zum Debuggen mithilfe von Visual Studio oder Visual Studio Code und dem Bot Framework-Emulator finden Sie unter Debuggen eines Bots.
  • Weitere Informationen zu ngrok finden Sie unter Tunneln (ngrok).