Bot Framework SDK for .NET を使用したボットの作成Create a bot with the Bot Framework SDK for .NET

適用対象: 対象 SDK v4 対象外 SDK v3 APPLIES TO: yesSDK v4 no SDK v3

このクイック スタートでは、C# テンプレートを使用してボットを構築し、Bot Framework Emulator でテストします。This quickstart walks you through building a bot by using the C# template, and then testing it with the Bot Framework Emulator.

Azure Bot Service でのボット作成とローカルでのボット作成は、ボットを作成するための、似ているけれども別個の方法です。Creating a bot with Azure Bot Service and creating a bot locally are independent, parallel ways to create a bot.

前提条件Prerequisites

テンプレートTemplates

Visual Studio のテンプレートVisual Studio templates

前提条件セクションでダウンロードした BotBuilderVSIX.vsix テンプレートをインストールします。Install BotBuilderVSIX.vsix template that you downloaded in the prerequisites section.

注意

.NET Core 2.1 と .NET Core 3.1 の両方のバージョンの C# VSIXテンプレートは、Visual Studio で使用できます。Both .NET Core 2.1 and .NET Core 3.1 versions of the C# VSIX templates are available in Visual Studio. Visual Studio 2019 で新しいボットを作成するときは、.NET Core 3.1 テンプレートを使用する必要があります。When creating new bots in Visual Studio 2019, you should use the .NET Core 3.1 templates. 現在のボット サンプルでは .NET Core 3.1 テンプレートを使用しています。The current bot samples use .NET Core 3.1 templates. .NET Core 2.1 テンプレートを使用するサンプルは、BotBuilder-Samples リポジトリの 4.7-archive ブランチにあります。You can find the samples that use .NET Core 2.1 templates in the 4.7-archive branch of the BotBuilder-Samples repository. .NET Core 3.1 ボットを Azure にデプロイする方法については、「ボットをデプロイする」を参照してください。For information about deploying .NET Core 3.1 bots to Azure, see Deploy your bot.

Bot をビルドして実行するBuild and run the bot

Visual Studio で bot をビルドして実行するBuild and run the bot in Visual Studio

Visual Studio で、Echo Bot (Bot Framework v4 - .NET Core 3.1) テンプレートを使用して、新しいボット プロジェクトを作成します。In Visual Studio, create a new bot project using the Echo Bot (Bot Framework v4 - .NET Core 3.1) template. ボット テンプレートのみを表示するには、プロジェクトの種類から [AI Bots](AI ボット) を選択します。Choose AI Bots from the project types to show only bot templates.

Visual Studio のプロジェクト新規作成ダイアログVisual Studio create a new project dialog

テンプレートのおかげで、プロジェクトには、このクイック スタートでボットを作成するのに必要なすべてのコードが含まれています。Thanks to the template, your project contains all the code that's necessary to create the bot in this quickstart. ボットをテストするために追加コードは必要ありません。You don't need any additional code to test your bot.

プロジェクトを開始します。Start the project. これにより、アプリケーションがビルドされ、localhost に配置され、Web ブラウザーが起動してアプリケーションの default.htm ページが表示されます。This will build the application, deploy it to localhost, and launch the web browser to display the application's default.htm page. この時点では、ボットはポート 3978 のローカルで実行されています。At this point, your bot is running locally on port 3978.

注意

Core ボットを作成する場合は、LUIS 言語モデルが必要ですIf you create a Core bot, you'll need a LUIS language model. (言語モデルは luis.ai で作成できます)。(You can create a language model at luis.ai). モデルの作成後、構成ファイルを更新します。After creating the model, update the configuration file.

エミュレーターを起動し、お使いのボットに接続しますStart the Emulator and connect to your bot

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

  2. エミュレーターの [Welcome](ようこそ) タブで [Open Bot](ボットを開く) をクリックします。Click Open Bot on the Emulator's Welcome tab.

  3. ボットの URL を入力します。これは、パスに /api/messages が追加されたローカル ポートの URL であり、通常は http://localhost:3978/api/messages です。Enter your bot's URL, which is the URL of the local port, with /api/messages added to the path, typically http://localhost:3978/api/messages.

    [Open Bot](ボットを開く) 画面open a bot screen

  4. 次いで [Connect] をクリックします。Then click Connect.

    Bot にメッセージを送信すると、bot は応答を返します。Send a message to your bot, and the bot will respond back.

    実行中のエミュレーターEmulator running

その他のリソースAdditional resources

  • .NET Core テンプレートの詳細については、 .NET Core SDK テンプレートの README を参照してください。See the .NET Core SDK Templates README for moreinformation about the .NET Core templates.
  • 「Visual Studio または Visual Studio Code と Bot Framework Emulator を使用してデバッグする方法についてbot をデバッグする方法」を参照してください。See how to debug a bot for how to debug using Visual Studio or Visual Studio Code and the Bot Framework Emulator.
  • Ngrok をインストールする方法については、「トンネリング」 (ngrok)を参照してください。See Tunneling (ngrok) for information on how to install ngrok.

次のステップNext steps