Erstellen eines Bots mit dem Bot Framework SDK für PythonCreate a bot with the Bot Framework SDK for Python

gilt für: SDK v4APPLIES TO: SDK v4

In diesem Artikel erfahren Sie, wie Sie mithilfe der python-Echo-bot-Vorlage einen Bot erstellen und dann mit dem bot Framework-Emulator testen.This article shows you how to build a bot by using the Python Echo Bot 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

Tipp

Einige Entwickler finden es möglicherweise hilfreich, python-Bots in einer virtuellen Umgebungzu erstellen.Some developers may find it useful to create Python bots in a virtual environment. Die folgenden Schritte funktionieren unabhängig davon, ob die Entwicklung in einer virtuellen Umgebung oder auf Ihrem lokalen Computer erfolgt.The steps below will work regardless if you're developing in a virtual environment or on your local machine.

VorlagenTemplates

Installieren Sie die erforderlichen Pakete, indem Sie die folgenden Befehle ausführen:Install the necessary packages by running the following commands:

pip install botbuilder-core
pip install asyncio
pip install aiohttp
pip install cookiecutter==1.7.0

Das letzte Paket, cookiecutter, wird verwendet, um Ihren bot zu generieren.The last package, cookiecutter, will be used to generate your bot. Vergewissern Sie sich, dass die Installation korrekt war, indem Sie Ausführen cookiecutter --help .Verify that it was installed correctly by running cookiecutter --help.

Erstellen eines BotsCreate a bot

Navigieren Sie zum Erstellen des Bots zu dem Verzeichnis, in dem Ihr bot erstellt werden soll, und führen Sie dann Folgendes aus:To create your bot, navigate to the directory you want your bot created in, then run:

cookiecutter https://github.com/microsoft/BotBuilder-Samples/releases/download/Templates/echo.zip

Dieser Befehl kopiert alle benötigten Dateien aus GitHub, um auf der Grundlage der Python- Echo Vorlageeinen Echo-bot zu erstellen.This command copies all needed files from GitHub to create an Echo Bot based on the Python echo template. Sie werden aufgefordert, den Namen des Bots und eine Beschreibung einzugeben.You will be prompted for the name of the bot and a description. Benennen Sie den bot -Echo-bot , und legen Sie die Beschreibung auf einen bot fest, der die Benutzer Antwort wieder gibt.Name your bot echo-bot and set the description to A bot that echoes back user response. wie unten dargestellt:as shown below:

Namen und Beschreibung festlegen

Starten Ihres BotsStart your bot

  1. Navigieren Sie in einem Terminal zum Ordner Echo-bot , in dem Sie den bot gespeichert haben.From a terminal navigate to the echo-bot folder where you saved your bot. Führen Sie pip install -r requirements.txt aus, um die zum Ausführen des Bots erforderlichen Pakete zu installieren.Run pip install -r requirements.txt to install any required packages to run your bot.

  2. Wenn die Pakete installiert sind, führen Sie python app.py aus, um den Bot zu starten.Once the packages are installed run python app.py to start your bot. Sie erkennen, dass der Bot getestet werden kann, wenn die letzte Zeile im folgenden Screenshot angezeigt wird:You will know your bot is ready to test when you see the last line shown in the screenshot below:

    Lokal ausgeführter Bot

Kopieren Sie die letzten vier Ziffern in der Adresse in der letzten Zeile (normalerweise 3978), da Sie sie im nächsten Schritt verwenden werden.Copy the last for digits in the address on the last line (usually 3978) since you will be using them in the next step. Sie sind jetzt bereit, den Emulator zu starten.You are now ready to start the Emulator.

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

Informationen zum Herstellen einer Verbindung mit einem remote gehosteten Bot finden Sie unter Tunneling (ngrok).See tunneling (ngrok) for how to connect to a bot hosted remotely.

Nächste SchritteNext steps