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

適用対象: SDK v4

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

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

前提条件

C# テンプレート

現在のボット サンプルでは .NET Core 3.1 テンプレートを使用しています。

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

注意

Visual Studio 内からテンプレートをインストールできます。

  1. メニューで[ 拡張機能 ]、[ 拡張機能の管理]の順に選択します。
  2. [ 拡張機能の管理 ] ダイアログで、 Visual Studio 用 Bot Framework v4 SDK テンプレートを検索してインストールします。

.NET ボットを Azure にデプロイする方法については、 ボットをプロビジョニングして発行する方法に関するページを参照してください。

ボットの作成

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

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

ヒント

Core ボットを作成する場合:

  • ソリューション ディレクトリのみがボット名を受け取ります。
  • 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) を参照してください。