次の方法で共有


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

この記事の対象: SDK v4

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

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

Note

Bot Framework JavaScript SDK、C#、Python SDK は引き続きサポートされますが、Java SDK については、最終的な長期サポートは 2023 年 11 月に終了する予定です。

Java SDK を使用して構築された既存のボットは引き続き機能します。

新しいボットを構築する場合は、Microsoft Copilot Studio の使用をご検討ください。また、適切なコパイロット ソリューションの選択に関する記事もお読みください。

詳細については、「The future of bot building」をご覧ください。

前提条件

C# テンプレート

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

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

Note

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

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

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

ボットの作成

Visual Studio で、新しいボット プロジェクトを作成して Echo Bot (Bot Framework v4 - .NET Core 3.1) テンプレートを使用します。 ボット テンプレートのみを表示するには、[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 を使用してデバッグする方法については、「ボットのデバッグ」を参照してください。
  • devtunnel の詳細については、トンネリング (devtunnel) に関する記事を参照してください。