Azure Serverless ワークショップ Deep Dive : モジュール 3

Article
11/02/2017

前回に続いて、今回はモジュール 3 の Deep Dive です。

GitHub: https://github.com/Azure-Samples/azure-serverless-workshop-team-assistant/tree/lang/jp/3-squirebot

概要

このモジュールではボットの本体を作ります。既存の GitHub 上のソリューションを使うため手順は簡単ですが、ここではコードを見ていきます。このソリューションにはボットの他に、タスク (コマンド) を登録するための Web アプリが含まれます。

プログラムの取得と実行

1. コマンドプロンプトより任意のディレクトで以下のコマンド実行。

git clone https://github.com/christopheranderson/squirebot

2. まずボット側から。squirebot\src\task-functions に移動して code . コマンドで Visual Studio Code を起動。

3. 次に package.json を確認。依存関係がすべて記述。Visual Studio Code の統合ターミナルより npm i を実行して依存関係をインストール。node_modules フォルダが作成されモジュールがコピーされる。

4. 続いてコンソールより npm start を実行。4 つのファンクションが起動。フォルダ構成を確認し、function.json を含むフォルダがファンクション名となっていることを確認。

5. 既にモジュール 2 で出てきてた lanceFetcher から確認。function.json を開く。認証レベル、トリガーのタイプ、変数名等を含み、実際のスクリプトが index.js であることが scriptfile に記載あり。

6. index.js も確認。module.exports で HttpRequest が来た際の処理だけ記述。C# と少しパターンが異なるため確認。Hello ファンクションも同様。Azure ファンクションは起動したまま次のステップへ。

7. 次に Web アプリ。新しいコマンドプロンプトで squirebot\src\webapp に移動して code . コマンドで Visual Studio Code を起動。

8. ターミナルより npm i を実行しパッケージの復元。

9. npm start で開始したら、URL を確認して、ブラウザでアクセス。画面が出たら正常。

bot ファンクション

bot ファンクションは Azure ファンクションとしての要素と BotFramework としての要素があります。

Azure ファンクション: bot\index.js

まず Azure ファンクションの実装を確認していきます。

1. module.exports で HttpRequest が来た際に要求を受ける処理を公開。LancerFetcher と異なり、listen(req, response(context)); の一行だけで実質内部関数を呼んでいるだけ。

2. listen は const として定義されており、connector.listen が相当。

3. connector は一番上に const として定義されており、../lib/bot を読み込んで、公開されている connector にアクセスしている。

4. response 関数は listen の引数として渡している。この方法で既定の挙動を上書きできるが、ここではログを追加している程度であるためあまり気にしなくて良い。

Bot Framework モジュール lib\bot

次に Bot Framework のモジュールが格納されている lib\bot ディレクトリの中身を確認してきます。

1. ボットの本体は bot\index.js にある。また dialogs フォルダには 2 つのダイアログが存在。server.js は bot 単体で起動する際に利用する restfy を含んでいる、しかし今回は Azure ファンクションの一部として稼働し、ボット単体でホストしないため利用しない。

2. bot 直下の index.js の実装を確認。冒頭から botbuilder の読み込みと、各ダイアログを取得、および connector と bot の作成。その後ダイアログのセットアップを行う。ここまではテンプレ通り。Bot Framework に触るのが初めての場合、こちらの記事の手順を一度やることを推奨。

3. 一番下にある module.exports で connector を公開。これが Azure ファンクションの bot 関数から呼ばれているものの実体。

Bot Framework ダイアログ

Bot Framework は 1 問 1 答の簡単なボットだけではなく、会話形式をサポートしており、その機能をダイアログと呼びます。詳細はこちら。このソリューションでは 2 つのダイアログがありますが、dialogs\index.js をメインに使い、handleParameters.js は子ダイアログとして実行されます。

1. メインのダイアログとなる dialogs\index.js を確認。冒頭でモジュールの読み込み。4 行目、5 行目ではタスク (コマンド) の一覧の読み込みや変更などを、ローカルのメモリから読み込むか、リモートのデータベースに対して行うかを、環境変数から取得。設定は local.settings.json にある。ワークショップの最後で CosmosDB を設定するが、その場合 UseInMemoryStore が false になる。7 行目ではタスクサービスをローカルから読み込むか、リモート Web　API から実行するかを指定。その場合、合わせて TASKAPIHOST 名も正しく設定。

2. Bot Framework のダイアログは、上から順番に処理されるウォーターフォール形式。まず一番初めの会話は挨拶確認。hello か squire を送られてきた場合は挨拶を返し、それ以外の場合は次の会話へユーザーからの入力を引数に遷移。

3. 次の会話では、ユーザーから送られてきたメッセージ (コマンド) を検索。コマンドがあった場合、タスク (コマンド) に必要なパラメーターをユーザーに聞くために、handleParameters ダイアログを子ダイアログとして開始。タスク見つからない場合はエラーを返信。

4. 最後の会話でマンドと、ユーザーから集めたパラメーターの値で、実際の処理を実行。

5. handleParameters.js を開くと、基本的には index.js と同じだが、必要なモジュールは botbuilder のみ。はじめの会話で index.js から受け取ったパラメーターの一覧を session オブジェクトに代入。確認するパラメーターがない場合は、そのまま endDialog を実行して index ダイアログに結果を返す。

6. 次の会話で自分を再起呼び出し。全てのパラメーターがなくなるまで繰り返し。

ボットの部分は以上で終わりです。ダイアログに慣れないと記述が複雑に見えますが、順番に見ると分かりやすいです。

タスクサービス

タスクサービス lib\tasks.js に実装があるタスク (コマンド) を扱うサービスで、タスクの CRUD (Create/Read/Update/Delete) を行う taskService と、タスクを実行する taskRunnerService があります

1. lib\tasks.js を確認。一番下で 2 つのサービスを公開。

2. 15 行目から 56 行目で既定のタスクを定義。UseInMemoryStore が true の場合に初期のタスクとして利用されるため、はじめから ”Fetch me my lance” コマンド等が利用可能。コマンド実行 URL と必要なパラメーターが定義されている。Web アプリ起動時に 2 つタスクが出てきたのもこのため。