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.
Zum Erstellen Ihres ersten Bots ist kein Azure-Abonnement oder eine Azure Bot Service-Ressource erforderlich. 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 Bot Framework-Python- und Java-SDKs werden eingestellt und der endgültige langfristige Support endet im November 2023.
Es werden nur kritische Sicherheits- und Fehlerbehebungen innerhalb dieses Repositorys durchgeführt.
Vorhandene Bots, die mit diesen SDKs erstellt wurden, funktionieren weiterhin.
.NET Core-Vorlagen helfen Ihnen, schnell neue Konversations-KI-Bots mit Bot Framework v4 zu erstellen.
Ab Mai 2020 ist für diese Vorlagen und den generierten Code .NET Core 3.1 oder höher erforderlich.
Mit diesem Befehl können Sie bestimmen, welche Versionen der .NET Core-Befehlszeilenschnittstelle installiert sind.
dotnet --version
Installieren Sie die drei Bot Framework-C#-Vorlagen: echo, core und leere Botvorlagen.
dotnet new -i Microsoft.Bot.Framework.CSharp.EchoBot
dotnet new -i Microsoft.Bot.Framework.CSharp.CoreBot
dotnet new -i Microsoft.Bot.Framework.CSharp.EmptyBot
Überprüfen Sie, ob die Vorlagen ordnungsgemäß installiert wurden.
dotnet new --list
Hinweis
In den obigen Schritten werden alle drei Bot Framework-Vorlagen installiert. Sie müssen nicht alle Vorlagen installieren und können nur die Vorlagen installieren, die Sie verwenden. In diesem Artikel wird die Echobot-Vorlage verwendet.
Installieren Sie node.js Version 12.10 oder höher.
Ein Azure-Konto, wenn Sie die Bereitstellung in Azure durchführen möchten.
Java-Vorlagen
Verwenden Sie den Yeoman-Generator, um schnell einen Konversations-KI-Bot mithilfe von KI-Kernfunktionen im Bot Framework v4 zu erstellen. Weitere Informationen finden Sie unter yeoman.io.
Der Generator unterstützt drei verschiedene Vorlagenoptionen, wie unten gezeigt.
Vorlage
Beschreibung
Echobot
Eine gute Vorlage, wenn Sie etwas mehr als "Hallo Welt!" wollen, aber nicht viel mehr. Diese Vorlage verarbeitet die Grundlagen des Sendens von Nachrichten an einen Bot und die Verarbeitung der Nachrichten durch Wiederholung an den Benutzer. Diese Vorlage erzeugt einen Bot, der einfach alles an den Benutzer zurückgibt, was der Benutzer dem Bot sagt.
Leerer Bot
Eine gute Vorlage, wenn Sie mit Bot Framework v4 vertraut sind und einfach ein einfaches Skelettprojekt benötigen. Auch eine gute Option, wenn Sie Beispielcode aus der Dokumentation nehmen und ihn in einen minimalen Bot einfügen möchten, um zu lernen.
Core-Bot
Eine gute Vorlage, wenn Sie erweiterte Bots erstellen möchten, da sie Multi-Turn-Dialoge und LUIS, einen KI-basierten kognitiven Dienst, verwendet, um Sprachverständnis zu implementieren. Mit dieser Vorlage wird ein Bot erstellt, der Orte und Datumsangaben extrahieren kann, um einen Flug zu buchen.
Hinweis
Language Understanding (LUIS) wird am 1. Oktober 2025 eingestellt.
Ab dem 1. April 2023 können Sie keine neuen LUIS-Ressourcen mehr erstellen.
Eine neuere Version von Language Understanding ist jetzt als Teil von Azure Cognitive Service for Language verfügbar.
Conversational Language Understanding (CLU), ein Feature von Azure Cognitive Service for Language, ist die aktualisierte Version von LUIS.
Weitere Informationen zur Sprachverständnisunterstützung im Bot Framework SDK finden Sie unter Verstehen natürlicher Sprache.
Installieren von Yeoman
Stellen Sie sicher, dass Sie node.js Version 12.10 oder höher installiert haben.
Kenntnisse von restify und asynchroner Programmierung in JavaScript
Visual Studio Code oder Ihre bevorzugte IDE, wenn Sie den Code des Bots bearbeiten möchten.
JavaScript- und TypeScript-Vorlagen
So installieren Sie Yeoman und den Yeoman-Generator für Bot Framework v4:
Öffnen Sie ein Terminalfenster oder eine Eingabeaufforderung mit erhöhten Rechten.
Wechseln Sie zum Verzeichnis mit Ihren JavaScript-Bots. Erstellen Sie es zuerst, wenn es noch nicht vorhanden ist.
mkdir myJsBots
cd myJsBots
Stellen Sie sicher, dass Sie über die neuesten Versionen von npm und Yeoman verfügen.
npm install -g npm
npm install -g yo
Installieren Sie den Yeoman-Generator.
Yeoman ist ein Tool zum Erstellen von Anwendungen. Weitere Informationen finden Sie unter yeoman.io.
npm install -g generator-botbuilder
Hinweis
Die Installation der unten aufgeführten Windows-Buildtools ist nur erforderlich, wenn Sie Windows als Entwicklungsbetriebssystem verwenden.
Bei einigen Installationen gibt der Installationsschritt für restify einen Fehler im Zusammenhang mit .node-gyp
Wenn dies der Fall ist, können Sie versuchen, den folgenden Befehl mit erhöhten Berechtigungen auszuführen.
Dieser Aufruf kann auch ohne Beenden hängen bleiben, wenn Python bereits auf Ihrem System installiert ist:
Kenntnisse der asynchronen Programmierung in Python
Erstellen und Aktivieren einer virtuellen Umgebung
Eine virtuelle Umgebung ist eine Kombination aus einem bestimmten Python-Interpreter und Bibliotheken, die sich von Ihren globalen Einstellungen unterscheiden. Die virtuelle Umgebung ist projektspezifisch und wird im Projektordner verwaltet. Ein Vorteil bei der Verwendung einer virtuellen Umgebung ist, dass die virtuelle Umgebung beim Entwickeln eines Projekts im Laufe der Zeit immer die genauen Abhängigkeiten des Projekts widerspiegelt. Weitere Informationen zu virtuellen Umgebungen finden Sie unter Erstellen virtueller Umgebungen.
Navigieren Sie zu dem Verzeichnis, in dem Sie Ihren Bot erstellen möchten. Führen Sie dann die folgenden Befehle für Ihre bevorzugte Plattform aus. Nachdem Sie Ihre virtuelle Umgebung aktiviert haben, sollte Ihre Befehlszeile/Ihr Terminal mit (venv)vorangestellt werden. Dadurch erfahren Sie, dass die virtuelle Umgebung aktiv ist. Sie können Ihre virtuelle Umgebung jederzeit deaktivieren, indem Sie Folgendes eingeben: deactivate.
macOS/Linux
python3 -m venv venv
source venv/bin/activate
Windows
python -m venv venv
venv\Scripts\activate.bat
Python-Vorlagen
Installieren Sie die erforderlichen Pakete, indem Sie die folgenden pip install Befehle ausführen:
Erstellen Sie in Visual Studio ein neues Botprojekt, und verwenden Sie die Vorlage Echo Bot (Bot Framework v4 – .NET Core 3.1). Um nur Botvorlagen anzuzeigen, wählen Sie den Projekttyp AI Bots aus.
Stellen Sie sicher, dass .NET Core 3.1 oder höher installiert ist.
Öffnen Sie in Visual Studio Code ein neues Terminalfenster.
Wechseln Sie zu dem Verzeichnis, in dem Sie Ihr Botprojekt erstellen möchten.
Erstellen Sie mit dem folgenden Befehl ein neues Echobot-Projekt. Ersetzen Sie <your-bot-name> durch den Namen, der für Ihr Botprojekt verwendet werden soll.
dotnet new echobot -n <your-bot-name>
Öffnen Sie ein neues Terminalfenster.
Wechseln Sie zu dem Verzeichnis, in dem Sie Ihr Botprojekt erstellen möchten.
Erstellen Sie mit dem folgenden Befehl ein neues Echobot-Projekt. Ersetzen Sie <your-bot-name> durch den Namen, der für Ihr Botprojekt verwendet werden soll.
dotnet new echobot -n <your-bot-name>
Dank der Vorlage enthält Ihr Projekt den gesamten code, der zum Erstellen des Bots in dieser Schnellstartanleitung erforderlich ist. Sie benötigen keinen weiteren Code, um Ihren Bot zu testen.
Führen Sie den folgenden Befehl aus, um einen Echobot aus Vorlagen zu erstellen. Der Befehl verwendet Standardoptionen für seine Parameter.
yo botbuilder-java -T "echo"
Yeoman fordert Sie zur Eingabe einiger Informationen auf, um Ihren Bot zu erstellen. Verwenden Sie für dieses Tutorial die Standardwerte.
? What's the name of your bot? (echo)
? What's the fully qualified package name of your bot? (com.mycompany.echo)
? Which template would you like to start with? (Use arrow keys) Select "Echo Bot"
? Looking good. Shall I go ahead and create your new bot? (Y/n) Enter "y"
Der Generator unterstützt viele Befehlszeilenoptionen, die Sie verwenden können, um die Standardwerte des Generators zu ändern oder eine Eingabeaufforderung vorab zu erstellen. Bei den Optionen wird die Groß-/Kleinschreibung beachtet.
Befehlszeilenoption
Beschreibung
--help, -h
Auflisten von Hilfetexten für alle unterstützten Befehlszeilenoptionen
--botName, -N
Der dem Botprojekt angegebene Name
--packageName, -P
Der Für den Bot zu verwendende Java-Paketname
--template, -T
Die Vorlage, die zum Generieren des Projekts verwendet wird. Optionen sind echo, empty, core. Weitere Informationen zu den verschiedenen Vorlagen finden Sie im GitHub-Repository für Ihre Sprache C#, JavaScript, Python oder Java.
--noprompt
Der Generator fordert keine Bestätigung auf, bevor ein neuer Bot erstellt wird. Alle Anforderungsoptionen, die nicht über die Befehlszeile übergeben werden, verwenden einen angemessenen Standardwert. Diese Option soll die automatisierte Botgenerierung zu Testzwecken ermöglichen.
Dank der Vorlage enthält Ihr Projekt sämtlichen Code, der zum Erstellen des Bots in dieser Schnellstartanleitung erforderlich ist. Sie benötigen keinen anderen Code, um Ihren Bot zu testen.
Verwenden Sie den Generator, um einen Echobot zu erstellen.
yo botbuilder
Yeoman fordert Sie zur Eingabe einiger Informationen auf, um Ihren Bot zu erstellen. Verwenden Sie für dieses Tutorial die Standardwerte.
? What's the name of your bot? my-chat-bot
? What will your bot do? Demonstrate the core capabilities of the Microsoft Bot Framework
? What programming language do you want to use? JavaScript
? Which template would you like to start with? Echo Bot - https://aka.ms/bot-template-echo
? Looking good. Shall I go ahead and create your new bot? Yes
Dank der Vorlage enthält Ihr Projekt sämtlichen Code, der zum Erstellen des Bots in dieser Schnellstartanleitung erforderlich ist. Sie benötigen keinen anderen Code, um Ihren Bot zu testen.
Visual Studio erstellt die Anwendung, stellt sie in localhost bereit und startet den Webbrowser, um die Seite der Anwendung default.htm anzuzeigen.
Zu diesem Zeitpunkt wird Ihr Bot lokal an Port 3978 ausgeführt.
In Visual Studio Code:
Öffnen Sie Ihren Botprojektordner.
Wenn Sie zur Auswahl eines Projekts aufgefordert werden, wählen Sie das Projekt für den von Ihnen erstellten Bot aus.
Wählen Sie im Menü Ausführen und dann Ohne Debuggen ausführen aus.
Wenn Sie zur Auswahl einer Umgebung aufgefordert werden, wählen Sie .NET Core aus.
Wenn dieser Befehl Ihre Starteinstellungen aktualisiert hat, speichern Sie die Änderungen, und führen Sie den Befehl erneut aus.
Der Befehl ausführen erstellt die Anwendung, stellt sie in localhost bereit und startet den Webbrowser, um die Seite der Anwendung default.htm anzuzeigen.
Zu diesem Zeitpunkt wird Ihr Bot lokal an Port 3978 ausgeführt.
Über eine Eingabeaufforderung oder ein Terminal:
Ändern Sie Verzeichnisse in den Projektordner für Ihren Bot.
Verwenden Sie dotnet run , um den Bot zu starten.
dotnet run
Mit diesem Befehl wird die Anwendung erstellt und in localhost bereitgestellt.
Die Standardwebseite der Anwendung wird nicht angezeigt, aber zu diesem Zeitpunkt wird Ihr Bot lokal an Port 3978 ausgeführt.
Wechseln Sie in einem Terminalfenster oder einer Eingabeaufforderung in das Verzeichnis, das Sie für Ihren Bot erstellt haben, und starten Sie ihn mit npm start.
cd my-chat-bot
npm start
Zu diesem Zeitpunkt wird Ihr Bot lokal an Port 3978 ausgeführt.
Starten des Emulators und Herstellen einer Verbindung mit Ihrem Bot
Starten Sie den Bot Framework-Emulator.
Wählen Sie auf der Registerkarte Willkommen des Emulators die Option Bot öffnen aus.
Geben Sie die URL Ihres Bots ein, bei der es sich um Ihren lokalen Host und Port handelt, und /api/messages fügen Sie dem Pfad hinzu. Die Adresse lautet in der Regel: http://localhost:3978/api/messages.
Wählen Sie dann Verbinden aus.
Senden Sie eine Nachricht an Ihren Bot, und der Bot antwortet zurück.