チュートリアル:Azure Bot Service v4 を使用して QnA ボットを作成するTutorial: Create a QnA Bot with Azure Bot Service v4

既存のナレッジ ベース用の発行ページから QnA チャット ボットを作成します。Create a QnA chat bot from the Publish page for an existing knowledge base. このボットでは、Bot Framework SDK v4 が使用されます。This bot uses the Bot Framework SDK v4. ボットを構築するためにコードを記述する必要はありません。すべてのコードが自動的に提供されます。You do not need to write any code to build the bot, all the code is provided for you.

このチュートリアルで学習する内容は次のとおりです。In this tutorial, you learn how to:

  • 既存のナレッジ ベースから Azure ボット サービスを作成するCreate an Azure Bot Service from an existing knowledge base
  • コードが動作していることを確認するためにボットとチャットするChat with the bot to verify the code is working

前提条件Prerequisites

このチュートリアル用に公開済みのナレッジ ベースが必要です。You need to have a published knowledge base for this tutorial. それがない場合は、KB の作成と KB から質問に回答に関するチュートリアルの手順に従って、質問と回答が含まれる QnA Maker ナレッジ ベースを作成します。If you do not have one, follow the steps in Create and answer from KB tutorial to create a QnA Maker knowledge base with questions and answers.

QnA ボットの作成Create a QnA Bot

ナレッジ ベースのクライアント アプリケーションとしてボットを作成します。Create a bot as a client application for the knowledge base.

  1. QnA Maker ポータルで、発行ページに進み、ご自分のナレッジ ベースを発行します。In the QnA Maker portal, go to the Publish page, and publish your knowledge base. [ボットを作成する] を選択します。Select Create Bot.

    QnA Maker ポータルで発行ページに進み、ご自分のナレッジ ベースを発行します。

    Azure portal が開き、ボットの作成構成が表示されます。The Azure portal opens with the bot creation configuration.

  2. ボットを作成するための設定を入力します。Enter the settings to create the bot:

    SettingSetting Value 目的Purpose
    ボット名Bot name my-tutorial-kb-bot これは、ボット用の Azure リソース名です。This is the Azure resource name for the bot.
    SubscriptionSubscription 目的を参照。See purpose. QnA Maker リソースを作成するために使用したのと同じサブスクリプションを選択します。Select the same subscription as you used to create the QnA Maker resources.
    Resource groupResource group my-tutorial-rg ボット関連の Azure リソースすべてに使用されるリソース グループ。The resource group used for all the bot-related Azure resources.
    LocationLocation west us ボットの Azure リソースの場所。The bot's Azure resource location.
    Pricing tierPricing tier F0 Azure ボット サービス用の Free レベル。The free tier for the Azure bot service.
    アプリの名前App name my-tutorial-kb-bot-app これは、ご利用のボットのみをサポートする Web アプリです。This is a web app to support your bot only. これは、ご利用の QnA Maker サービスで既に使用されている名前と同じにしないでください。This should not be the same app name as your QnA Maker service is already using. QnA Maker の Web アプリを他のリソースと共有することはサポートされていません。Sharing QnA Maker's web app with any other resource is not supported.
    SDK 言語SDK Language C#C# これは、ボット フレームワーク SDK によって使用される基になるプログラミング言語です。This is the underlying programming language used by the bot framework SDK. 使用する選択肢は、C# または Node.js です。Your choices are C# or Node.js.
    QnA 認証キーQnA Auth Key 変更しないDo not change この値は自動的に入力されます。This value is filled in for you.
    App Service プラン/場所App service plan/Location 変更しないDo not change このチュートリアルでは、場所は重要ではありません。For this tutorial, the location is not important.
    Azure StorageAzure Storage 変更しないDo not change 会話データは Azure Storage テーブルに格納されます。Conversation data is stored in Azure Storage tables.
    Application InsightsApplication Insights 変更しないDo not change ログ記録は、Application Insights に送信されます。Logging is sent to Application Insights.
    Microsoft アプリ IDMicrosoft App ID 変更しないDo not change Active Directory ユーザーとパスワードが必須です。Active directory user and password is required.

    これらの設定を使用して、ナレッジ ベース ボットを作成します。

    ボット作成プロセスの通知によって成功が報告されるまで、数分をお待ちください。Wait a couple of minutes until the bot creation process notification reports success.

ボットとチャットするChat with the Bot

  1. Azure portal で、通知から新しいボット リソースを開きます。In the Azure portal, open the new bot resource from the notification.

    Azure portal で、通知から新しいボット リソースを開きます。

  2. [Bot management](ボット管理) で、 [Test in Web Chat](Web チャットでのテスト) を選択し、「How large can my KB be?」と入力します。From Bot management, select Test in Web Chat and enter: How large can my KB be?. ボットの応答内容は次のとおりです。The bot will respond with:

    The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Read [here](https://docs.microsoft.com/azure/cognitive-services/qnamaker/tutorials/choosing-capacity-qnamaker-deployment)for more details.

    新しいナレッジ ベースをテストします。

    Azure ボットの詳細については、「QnA Maker を使用して質問に回答する」を参照してください。For more information about Azure Bots, see Use QnA Maker to answer questions

リソースのクリーンアップClean up resources

このチュートリアルのボットを完了したら、Azure portal でボットを削除します。When you are done with this tutorial's bot, remove the bot in the Azure portal.

ボットのリソースとして新しいリソース グループを作成している場合は、そのリソース グループを削除します。If you created a new resource group for the bot's resources, delete the resource group.

新しいリソース グループを作成していない場合は、ボットに関連付けられているリソースを検索する必要があります。If you didn't create a new resource group, you need to find the resources associated with the bot. ボットとボット アプリから成る名前で検索するのが最も簡単です。The easiest way is to search by the name of the bot and bot app. ボット リソースには次のものがあります。The bot resources include:

  • App Service プランThe App Service plan
  • Search ServiceThe Search service
  • Cognitive ServiceThe Cognitive service
  • App ServiceThe App service
  • 必要に応じて、Application Insights サービスと Application Insights データ用のストレージも含まれることがありますOptionally, it may also include the application insights service and storage for the application insights data

ボットに関する詳細情報More information about bots

ボットにこのサービスを使用する方法の詳細については、次のリソースから始めます。For more information about using this service with bots, begin with the following resources:

ResourceResource 目的Purpose
Azure Bot サービスAzure Bot service Azure Bot サービスは、ボット エンドポイントを備えた完全なクラウド ホスト型 Web サービスを提供します。The Azure Bot service provides a complete cloud-hosted web service with a bot endpoint. このサービスは Bot Framework を使用します。これはいくつかの言語で使用できます。The services uses Bot framework, which is available in several languages.
Bot FrameworkBot Framework Microsoft Bot Framework は、エンタープライズ級の会話型 AI エクスペリエンスを構築するための包括的なプラットフォームです。The Microsoft Bot Framework is a comprehensive platform for building enterprise-grade conversational AI experiences.
Bot Framework EmulatorBot Framework Emulator Bot Framework Emulator はクロスプラットフォーム デスクトップ アプリケーションです。このアプリケーションを使用すると、ボット開発者が、Bot Framework SDK を使って構築されたボットをテストし、デバッグできます。The Bot Framework Emulator is a cross-platform desktop application that allows bot developers to test and debug bots built using the Bot Framework SDK. Bot Framework Emulator を使用して、ご自身のマシンでローカルで実行されているボットをテストしたり、リモートで実行されているボットに接続したりできます。You can use the Bot Framework Emulator to test bots running locally on your machine or to connect to bots running remotely.
Bot ツールBot tools Bot Framework ツールは、エンドツーエンドのボット開発ワークフローに対応するように設計されたクロスプラットフォームのコマンド ライン ツールのコレクションです。The Bot Framework tools are a collection of cross-platform command line tools designed to cover end-to-end bot development workflow.
Bot Builder のサンプルBot builder samples 完全に開発済みのボット サンプルは、優れたボットを構築するために実装する必要があるシナリオを説明するために設計されています。Full-developed bot samples are designed to illustrate scenarios you'll need to implement to build great bots.

次の手順Next steps

関連項目See also