Bot Framework SDK を使用してボットを作成する

適用対象: SDK v4

このクイックスタートでは、Bot Framework SDK for C#、Java、JavaScript、Python を使用して最初のボットを構築する方法と、Bot Framework Emulatorを使用してボットをテストする方法について説明します。

最初のボットを作成するには、Azure サブスクリプションや Azure Bot Service リソースは必要ありません。 このクイック スタートでは、最初のボットをローカルに作成することに重点を置いています。 Azure でボットを作成する方法については、「Azure Bot リソースの作成」を参照してください。

前提条件

テンプレート

ボット テンプレートを Visual Studio に追加するには、 Bot Framework v4 SDK Templates for Visual Studio VSIX ファイルをダウンロードしてインストールします。

注意

VSIX パッケージには、C# テンプレートの .NET Core 2.1 バージョンと .NET Core 3.1 バージョンの両方が含まれています。 Visual Studio 2019 以降で新しいボットを作成する場合は、.NET Core 3.1 テンプレートを使用する必要があります。 現在のボット サンプルでは .NET Core 3.1 テンプレートを使用しています。 .NET Core 2.1 テンプレートを使用するサンプルは、BotBuilder-Samples リポジトリの 4.7-archive ブランチにあります。

Visual Studio にテンプレートをインストールするには、上部のメニュー バーの [拡張機能>の管理] に移動します。 次に、 Bot Framework v4 SDK for Visual Studio を検索してインストールします。

.NET Core 3.1 ボットを Azure にデプロイする方法については、Azure に ボットをデプロイする方法を参照してください

ボットの作成

Visual Studio で、Echo Bot (Bot Framework v4 - .NET Core 3.1) テンプレートを使用して、新しいボット プロジェクトを作成します。 ボット テンプレートのみを表示するには、プロジェクトの種類から AI ボット を選択します。

テンプレートのおかげで、このクイックスタートでボットを作成するために必要なすべてのコードがプロジェクトに含まれています。 ボットをテストするためにこれ以上コードは必要ありません。

ヒント

コア ボットを作成する場合:

  • ソリューション ディレクトリのみがボット名を受け取ります。
  • LUIS 言語モデルが必要です。 言語モデルは 、luis.ai で作成できます。 モデルの作成後、構成ファイルを更新します。

ボットの起動

Visual Studio で次の操作を行います。

  1. ボット プロジェクトを開きます。
  2. デバッグなしでプロジェクトを実行します。
  3. Visual Studio によってアプリケーションがビルドされ、localhost にデプロイされ、Web ブラウザーが起動してアプリケーションの default.htm ページが表示されます。

この時点では、ボットはローカルのポート 3978 で実行されています。

エミュレーターの起動とボットの接続

  1. Bot Framework Emulator を起動します。

  2. エミュレーターの [ようこそ] タブで [ボットを開く] を選択します。

  3. ローカル ホストとポートであるボットの URL を入力し、 /api/messages パスに追加します。 アドレスは通常次のとおりです http://localhost:3978/api/messages

    ボットを開く

  4. 次に、 [接続]\(Connect\) を選択します。

    ボットにメッセージを送信すると、ボットは応答します。

    エコー メッセージ

その他のリソース

  • Visual Studio または Visual Studio Code とBot Framework Emulatorを使用してデバッグする方法については、ボットのデバッグに関するページを参照してください。
  • ngrok のインストール方法については、 トンネリング (ngrok) を参照してください。

次のステップ