microsoftbotframework

Microsoft ボット フレームワーク

Microsoft Bot Framework は、Microsoft による Microsoft Bot API のラッパーです。 Flask を使用して Microsoft と Celery からポスト メッセージを受信し、非同期タスクを完了します。

目標は、Microsoft ボット フレームワークとのインターフェイスを可能にする、非常に簡単に使用できるライブラリを作成することでした。

完全なドキュメントは次の場所にあります: http://microsoftbotframework.readthedocs.io/

ローカル シミュレーターを使用してこのアプリを実行するには

https://docs.botframework.com/en-us/tools/bot-framework-emulator/ からシミュレーターをダウンロードして実行します。

ライブラリをインストールする

 pip install microsoftbotframework

タスクを定義する

ルート ディレクトリに、tasks.py というファイルを作成します。ファイル内で次のようにタスクを定義します。 ReplyToActivity オブジェクトなどの詳細については、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 ()

メインファイルを作成する

 from microsoftbotframework import MsBot
from tasks import *

bot = MsBot ()
bot . add_process ( echo_response )

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

アプリを実行する

 python main.py

ボットに接続する

デフォルトでは、アプリは http://localhost:5000/api/messages で実行されます。

このアドレスをエミュレータのEnter your endpoint URLヘッダーに入力します。

チャットを始めましょう！上記の手順に従った場合は、入力した内容が繰り返されるはずです。

オンラインボットフレームワークを使用してこのアプリを実行するには

Microsoft ボット フレームワークと対話するには、有効な証明書を持つ、インターネットに接続された https エンドポイントが必要です。このガイドでは、gunicorn と heroku を使用してアプリケーションをホストする方法を説明しますが、MsBot オブジェクトは Flask を拡張するため、任意の wsgi ホスティング オプションを簡単に使用できます。

Microsoft チャットボットを作成する

https://dev.botframework.com/bots に移動します。ボットを登録し、「Microsoft App ID」と「Microsoft App Secret」を生成します。メッセージング エンドポイントについては、すぐに作成するので心配しないでください。プロジェクトのルートに config.yaml ファイルを作成し、次の情報を配置します。

 other :
    app_client_id : 
    app_client_secret :  

Heroku に公開する

requirements.txt というファイルを作成し、次の内容を追加します。

 microsoftbotframework
gunicorn

「Procfile」というファイルを作成し、以下を追加します。 Webサーバーとしてgunicornを使用します。 「--log-level INFO」を削除することも、実稼働用に低いレベルに設定することもできます。

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

runtime.txt というファイルを作成し、次の内容を追加します。

 python-3.6.0

まだ git をインストールしていない場合

sudo apt-get install git

https://www.heroku.com/ から Heroku アカウントにサインアップし、新しいアプリを作成します。指示に従って Heroku Git を使用してデプロイします

Microsoft MyBots タブに戻り、メッセージング エンドポイントを Heroku 設定タブにあるドメインになるように更新します。 URL の最後に「/api/messages」を必ず追加してください。

おめでとうございます。Skype でボットとチャットできるようになりました。

このライブラリのテストを実行する

1. pip install -e .[test]を使用して、setup.py testing_require セクションから必要なライブラリがインストールされていることを確認してください。
2. Redis と mongodb がローカルにインストールされていることを確認してください
3. Redis を有効にする: redis-server
4. mongobdをオンにする: mongod
5. このディレクトリのルートでターミナルを開きます
6. 以下のオプションのいずれかを使用してテストを実行します
   • nosetests (ステップ 1 のライブラリをインストールする必要があります)
   • python setup.py test (ステップ 1 のライブラリをインストールする必要はありません)