ハンズオンの最初に Bot Framework Composer で Bot 開発のための環境を構築します。
このハンズオンでは、Bot Framework Composer v2.1.0 を使用します。
ハンズオン実施の時期によっては画面の構成などが一部異なる可能性があります。
Bot Framework Composer は ソースコードからビルドする も紹介します。
不具合修正や機能追加・変更が、アプリケーション版より早いタイミングで行われる可能性があります。
興味がある方はソースコードからビルドする方法を検討してください。
Bot Framework Composer を使用するには、構築が簡単なデスクトップアプリケーション版をお勧めします。
Windows 版、macOS 版、Linux 版が用意されています。
-
Bot Framework Emulator インストール
Bot Framework Emulator をダウンロードしてインストールします。
Bot Framework Emulator は Bot 開発の テスト用クライアント として使用します。
-
.NET Core 3.1 SDK インストール
.NET Core 3.1 SDK をダウンロードしてインストールします。
-
Node.js インストール
Node.js をダウンロードしてインストールします。このハンズオンの Bot 開発の範囲では Node.js のインストールは必須ではありませんが、Bot Framework Composer は Node.js のコードを生成するプロジェクト テンプレートが用意されています。
このタイミングでインストールすることをお勧めします。
Windows を使用している場合、Node.js のインストーラーの途中で Chocolatey もインストールするかを確認されます。
Bot Framework Composer での開発には Chocolatey は不要なので、任意で追加インストールしてください。Node.js をインストールしていない環境で Bot Framework Composer で新規プロジェクトを作成すると、Node.js のインストールを促すポップアップが表示されます。
キャンセルすれば C# のテンプレートを利用して Bot 開発を進めることができますが、毎回メッセージが表示されるのが気になる場合や Node.js 用のテンプレートを利用したい場合は、Node.js のインストールをしてください。
-
Bot Framework Composer インストール
使用している OS にあわせて、Bot Framework Composer のインストーラーをダウンロードしてインストールします。OS インストーラーのアドレス Windows https://aka.ms/bf-composer-download-win macOS https://aka.ms/bf-composer-download-mac Linux https://aka.ms/bf-composer-download-linux
-
ngrok インストール
ngrok をダウンロードして、ZIP ファイル内の "ngrok.exe" をローカル PC の任意のフォルダーにコピーします。
インストーラーはないので exe ファイルをコピーするだけです。パスが通ったフォルダーでなくてもかまいません。ngrok は ステップ 7 までの Bot アプリケーション開発の範囲では不要です。
ステップ 8 で Bot アプリケーションを Azure に発行したあとの動作確認に使用します。
Bot Framework Composer で開発する場合、以下のケースで ngrok が必要になります。
- Azure に発行した Bot アプリケーションを Bot Framework Emulator でテストしたい場合
- ローカルで実行している Bot アプリケーションに他のマシンから接続したい場合
環境によっては、上記の手順で構築しても Bot Framework Composer が 正常に動作しない ことがあるようです。(tfukumori さん、情報ありがとうございます)
具体的には Composer が "Starting Server" のままで起動しない ことがあります。この場合は、Visual C++ 再頒布可能ファイル を追加でインストールすることで正常に起動するようになります。
この後のステップで Composer が正常に起動しない場合は実施してください。
以上で、Bot アプリケーション開発環境の構築は完了です。
以上で、Bot Framework Composer のインストールが完了しました。
次のステップでは、Bot Framework Composer 操作の超基礎を理解するために、Echo Bot を作ります。