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

GILT FÜR: JaSDK v4 Nein SDK v3 APPLIES TO: yesSDK v4 no SDK v3

In dieser Schnellstartanleitung werden die Schritte zum Erstellen eines Bots per mit der Vorlage „Python Echo Bot“ und zum anschließenden Testen mit dem Bot Framework-Emulator beschrieben.This quickstart walks you through building a bot using the Python Echo Bot template, and then testing it with the Bot Framework Emulator.

VoraussetzungenPrerequisites

Erstellen eines BotsCreate a bot

Hinweis

Einige Entwickler finden es möglicherweise nützlich, Python-Bots in einer virtuellen Umgebung zu erstellen.Some developers may find it useful to create Python bots in a virtual envrionment. 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.

  1. Öffnen Sie ein Terminal.Open a terminal. 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 zum Generieren des Bots verwendet.The last package, cookiecutter, will be used to generate your bot. Vergewissern Sie sich, dass „cookiecutter“ ordnungsgemäß installiert wurde, indem Sie cookiecutter --help ausführen.Verify that cookiecutter was installed correctly by running cookiecutter --help.

  1. So erstellen Sie die Botausführung:To create your bot run:
cookiecutter https://github.com/microsoft/botbuilder-python/releases/download/Templates/echo.zip

Mit diesem Befehl wird ein Echobot auf Grundlage der Echo-Vorlage für Python erstellt.This command creates an Echo Bot based on the Python echo template.

  1. 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 mit echo-bot, und legen Sie die Beschreibung auf A bot that echoes back user response. fest, wie unten dargestellt:Name your bot echo-bot and set the description to A bot that echoes back user response. as shown below:

Namen und Beschreibung festlegen

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. Nun können Sie den Bot starten.You are now ready to start your bot.

Starten des BotsStart you bot

  1. Navigieren Sie in einem Terminal zu dem 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

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

  1. Starten Sie den Emulator, und klicken Sie auf die Schaltfläche Bot öffnen.Start the Emulator and click the Open Bot button.

  2. Nachdem Sie auf die Schaltfläche geklickt haben, wird ein Dialogfeld geöffnet, in dem Sie die erforderlichen Werte zum Ausführen des Bots festlegen.After clicking the button a box window will open where you set the necessary values to run the bot. Verwenden Sie die Zahl, die Sie zuvor gespeichert haben, und legen Sie die Bot-URL wie unten gezeigt auf http://localhost:<saved number>/api/messages fest:Use the number you saved earlier and set the Bot URL to http://localhost:<saved number>/api/messages as seen below:

Öffnen eines Bot-Bildschirms

  1. Klicken Sie auf die Schaltfläche Verbinden, und der Bot wird gestartet.Click the Connect button and your bot should start. Testen Sie den Bot, indem Sie etwas eingeben und auf Eingabe klicken, wie unten gezeigt:Try testing the bot by typing anything and clicking Enter as seen below:

Verbinden und testen

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