microsoftbotframework

Cadre de robots Microsoft

Microsoft Bot Framework est un wrapper pour l'API Microsoft Bot de Microsoft. Il utilise Flask pour recevoir les messages postés par Microsoft et Celery afin d'effectuer des tâches asynchrones.

L'objectif était de créer une bibliothèque vraiment simple à utiliser pour vous permettre de vous interfacer avec le framework de robots Microsoft.

La documentation complète peut être trouvée ici : http://microsoftbotframework.readthedocs.io/

Pour exécuter cette application à l'aide du simulateur local

Téléchargez et exécutez le simulateur depuis : https://docs.botframework.com/en-us/tools/bot-framework-emulator/

Installer la bibliothèque

 pip install microsoftbotframework

Définir une tâche

Créez un fichier dans le répertoire racine appelé tâches.py. Dans le fichier, définissez une tâche comme suit. Plus d'informations sur l'objet ReplyToActivity et d'autres peuvent être trouvées sur 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 ()

Créer le fichier principal

 from microsoftbotframework import MsBot
from tasks import *

bot = MsBot ()
bot . add_process ( echo_response )

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

Exécutez votre application

 python main.py

Connectez-vous à votre bot

Par défaut, l'application s'exécute sur http://localhost:5000/api/messages.

Entrez cette adresse dans l’en- tête Entrez votre URL de point de terminaison de l’émulateur.

Commencez à discuter ! Si vous avez suivi les instructions ci-dessus, vous devriez répéter ce que vous tapez.

Pour exécuter cette application à l'aide du framework de robots en ligne

Afin d'interagir avec le framework de robots Microsoft, vous devez disposer d'un point de terminaison https connecté à Internet avec un certificat valide. Ce guide montrera comment utiliser gunicorn et heroku pour héberger l'application, mais vous pouvez facilement utiliser n'importe quelle option d'hébergement wsgi car l'objet MsBot étend Flask.

Créer un chatbot Microsoft

Accédez à https://dev.botframework.com/bots. Enregistrez un bot et générez un « Microsoft App ID » et un « Microsoft App Secret ». Ne vous inquiétez pas du point de terminaison de messagerie, car nous le créerons bientôt. Créez un fichier config.yaml à la racine de votre projet et placez les informations suivantes :

 other :
    app_client_id : 
    app_client_secret :  

Publier sur Heroku

Créez un fichier appelé exigences.txt et ajoutez ce qui suit.

 microsoftbotframework
gunicorn

Créez un fichier appelé "Procfile" et ajoutez ce qui suit. Nous allons utiliser Gunicorn comme serveur Web. Vous pouvez supprimer "--log-level INFO" ou le définir à un niveau inférieur pour la production.

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

Créez un fichier appelé runtime.txt et ajoutez ce qui suit.

 python-3.6.0

Si vous n'avez pas encore installé git

sudo apt-get install git

Créez un compte Heroku ici : https://www.heroku.com/ et créez une nouvelle application. Suivez les instructions pour déployer à l'aide de Heroku Git

Revenez dans l'onglet Microsoft MyBots et mettez à jour le point de terminaison de messagerie pour qu'il corresponde au domaine trouvé dans l'onglet des paramètres Heroku. Assurez-vous d'ajouter "/api/messages" à l'URL.

Félicitations, vous devriez maintenant pouvoir discuter avec votre bot sur Skype !

Exécuter les tests de cette bibliothèque

1. Assurez-vous que les bibliothèques requises sont installées à partir de la section setup.py tests_require avec pip install -e .[test]
2. Assurez-vous que Redis et Mongodb sont installés localement
3. Activer Redis : redis-server
4. Activer mongobd : mongod
5. Ouvrez un terminal à la racine de ce répertoire
6. Exécutez les tests avec l'une des options ci-dessous
   • nosetests (nécessite l'installation des bibliothèques de l'étape 1)
   • python setup.py test (ne nécessite pas l'installation des bibliothèques de l'étape 1)