microsoftbotframework

Microsoft Bot Framework

Microsoft Bot Framework ist ein Wrapper für die Microsoft Bot API von Microsoft. Es verwendet Flask, um die Post-Nachrichten von Microsoft und Celery zu empfangen und Async-Aufgaben abzuschließen.

Das Ziel bestand darin, eine wirklich einfach zu verwendende Bibliothek zu erstellen, die Ihnen die Schnittstelle zum Microsoft-Bot-Framework ermöglicht.

Die vollständigen Dokumente finden Sie hier: http://microsoftbotframework.readthedocs.io/

Um diese App mit dem lokalen Simulator auszuführen

Laden Sie den Simulator herunter und führen Sie ihn aus: https://docs.botframework.com/en-us/tools/bot-framework-emulator/

Installieren Sie die Bibliothek

 pip install microsoftbotframework

Definieren Sie eine Aufgabe

Erstellen Sie im Stammverzeichnis eine Datei mit dem Namen „tasks.py“. Definieren Sie in der Datei eine Aufgabe wie folgt. Weitere Informationen zum ReplyToActivity-Objekt und anderen finden Sie unter http://microsoftbotframework.readthedocs.io/en/latest/conversationoperations/

 from microsoftbotframework import ReplyToActivity

def echo_response ( message ):
    if message [ "type" ] == "message" :
        ReplyToActivity ( fill = message ,
                        text = message [ "text" ]). send ()

Erstellen Sie die Hauptdatei

 from microsoftbotframework import MsBot
from tasks import *

bot = MsBot ()
bot . add_process ( echo_response )

if __name__ == '__main__' :
    bot . run ()

Führen Sie Ihre App aus

 python main.py

Stellen Sie eine Verbindung zu Ihrem Bot her

Standardmäßig wird die App unter http://localhost:5000/api/messages ausgeführt.

Geben Sie diese Adresse in den Header „Geben Sie Ihre Endpunkt-URL ein“ des Emulators ein.

Beginnen Sie mit dem Chatten! Wenn Sie die obigen Anweisungen befolgt haben, sollte Ihre Eingabe wiederholt werden.

Um diese App mit dem Online-Bot-Framework auszuführen

Um mit dem Microsoft-Bot-Framework interagieren zu können, benötigen Sie einen mit dem Internet verbundenen https-Endpunkt mit einem gültigen Zertifikat. In dieser Anleitung wird gezeigt, wie Sie Gunicorn und Heroku zum Hosten der Anwendung verwenden. Sie können jedoch problemlos jede beliebige WSGI-Hostingoption verwenden, da das MsBot-Objekt Flask erweitert.

Erstellen Sie einen Microsoft Chatbot

Gehen Sie zu https://dev.botframework.com/bots. Registrieren Sie einen Bot und generieren Sie eine „Microsoft App ID“ und ein „Microsoft App Secret“. Machen Sie sich keine Sorgen um den Messaging-Endpunkt, da wir ihn bald erstellen werden. Erstellen Sie eine config.yaml-Datei im Stammverzeichnis Ihres Projekts und geben Sie die folgenden Informationen ein:

 other :
    app_client_id : 
    app_client_secret :  

Auf Heroku veröffentlichen

Erstellen Sie eine Datei mit dem Namen „requirements.txt“ und fügen Sie Folgendes hinzu.

 microsoftbotframework
gunicorn

Erstellen Sie eine Datei mit dem Namen „Procfile“ und fügen Sie Folgendes hinzu. Wir werden Gunicorn als unseren Webserver verwenden. Sie können „--log-level INFO“ entfernen oder für die Produktion auf eine niedrigere Ebene festlegen.

 web: gunicorn -b '0.0.0.0:'$PORT --log-level INFO main:bot

Erstellen Sie eine Datei mit dem Namen runtime.txt und fügen Sie Folgendes hinzu.

 python-3.6.0

Wenn Sie Git noch nicht installiert haben

sudo apt-get install git

Melden Sie sich hier für ein Heroku-Konto an: https://www.heroku.com/ und erstellen Sie eine neue App. Befolgen Sie die Anweisungen zur Bereitstellung mit Heroku Git

Gehen Sie zurück zur Registerkarte „Microsoft MyBots“ und aktualisieren Sie den Messaging-Endpunkt auf die Domäne, die Sie auf der Registerkarte „Heroku-Einstellungen“ finden. Stellen Sie sicher, dass Sie am Ende der URL „/api/messages“ hinzufügen.

Herzlichen Glückwunsch, Sie sollten jetzt in der Lage sein, mit Ihrem Bot über Skype zu chatten!

Ausführen der Tests dieser Bibliothek

1. Stellen Sie sicher, dass Sie die erforderlichen Bibliotheken aus dem Abschnitt „tests_require“ von setup.py mit pip install -e .[test]
2. Stellen Sie sicher, dass Redis und Mongodb lokal installiert sind
3. Aktivieren Sie redis: redis-server
4. Schalten Sie Mongobd ein: mongod
5. Öffnen Sie ein Terminal im Stammverzeichnis dieses Verzeichnisses
6. Führen Sie die Tests mit einer der folgenden Optionen aus
   • nosetests (erfordert die Installation von Schritt-1-Bibliotheken)
   • python setup.py test (erfordert keine Installation der Schritt-1-Bibliotheken)