QnA Maker ナレッジ ベースの作成、トレーニング、発行Create, train, and publish your QnA Maker knowledge base

QnA Maker のナレッジ ベース (KB) は、よくあるご質問や製品マニュアルなど、独自のコンテンツから作成できます。You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. この記事には、単純な FAQ Web ページから QnA Maker ナレッジ ベースを作成して、BitLocker キーの回復に関する質問に答える例が含まれています。This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions on BitLocker key recovery.

前提条件Prerequisite

  • Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。If you don't have an Azure subscription, create a free account before you begin.

QnA Maker ナレッジ ベースの作成Create a QnA Maker knowledge base

  1. ご自分の Azure の資格情報を使用して QnAMaker.ai ポータルにサインインします。Sign in to the QnAMaker.ai portal with your Azure credentials.

  2. QnA Maker ポータルで、 [Create a knowledge base](ナレッジ ベースの作成) を選択します。On the QnA Maker portal, select Create a knowledge base.

    QnA Maker ポータルのスクリーンショット

  3. 手順 1 として、 [作成] ページで [Create a QnA service](QnA サービスの作成) を選択します。On the Create page, in step 1, select Create a QnA service. サブスクリプションで QnA Maker サービスを設定するため、Azure portal にリダイレクトされます。You are directed to the Azure portal to set up a QnA Maker service in your subscription. Azure portal がタイムアウトした場合は、サイトで [Try again](再試行) を選択します。If the Azure portal times out, select Try again on the site. 接続されると、Azure ダッシュ ボードが表示されます。After you connect, your Azure dashboard appears.

  4. Azure で新しい QnA Maker サービスが正常に作成できたら、qnamaker.ai/create に戻ります。After you successfully create a new QnA Maker service in Azure, return to qnamaker.ai/create. 手順 2 のドロップダウン リストから QnA Maker サービスを選択します。Select your QnA Maker service from the drop-down lists in step 2. 新しい QnA Maker サービスを作成した場合は、必ずページを更新してください。If you created a new QnA Maker service, be sure to refresh the page.

    QnA Maker サービス ナレッジ ベースの選択のスクリーン ショット

  5. 手順 3 として、ご自分のナレッジ ベースに My Sample QnA KB という名前を付けます。In step 3, name your knowledge base My Sample QnA KB.

  6. ご自分のナレッジ ベースにコンテンツを追加するために、3 種類のデータ ソースを選択します。To add content to your knowledge base, select three types of data sources. 手順 4 として、 [Populate your KB](KB の入力)[URL] ボックスに BitLocker Recovery FAQ の URL を追加します。In step 4, under Populate your KB, add the BitLocker Recovery FAQ URL in the URL box.

    データ ソース追加のスクリーンショット

  7. 手順 5 として、 [Create your KB](KB の作成) を選択します。In step 5, select Create your KB.

  8. QnA Maker がナレッジ ベースを作成している間、ポップアップ ウィンドウが表示されます。While QnA Maker creates the knowledge base, a pop-up window appears. 抽出プロセスでは、HTML ページを読み取って質問と回答を識別します。これには数分かかります。The extraction process takes a few minutes to read the HTML page and identify questions and answers.

  9. QnA Maker がナレッジ ベースを正常に作成すると、 [Knowledge base](ナレッジ ベース) ページが開きます。After QnA Maker successfully creates the knowledge base, the Knowledge base page opens. このページで、ナレッジ ベースの内容を編集することができます。You can edit the contents of the knowledge base on this page.

ナレッジ ベースを編集するEdit the knowledge base

  1. QnA Maker ポータルの [編集] セクションで [Add QnA pair](QnA ペアの追加) を選択して、ナレッジ ベースに新しい行を追加します。In the QnA Maker portal, on the Edit section, select Add QnA pair to add a new row to the knowledge base. [質問] に、Hi と入力します。Under Question, enter Hi. [回答] に、こんにちは。BitLocker について質問してください。 」と入力します。Under Answer, enter Hello. Ask me BitLocker questions.

    QnA Maker ポータルのスクリーンショット

  2. 右上の [Save and train](保存してトレーニング) を選択し、編集内容を保存して QnA Maker のモデルをトレーニングします。In the upper right, select Save and train to save your edits and train the QnA Maker model. 保存しないと、編集した内容は保持されません。Edits aren't kept unless they're saved.

ナレッジ ベースをテストするTest the knowledge base

  1. QnA Maker ポータルの右上にある [テスト] を選択して、行った変更が反映されたかどうかをテストします。In the QnA Maker portal, in the upper right, select Test to test that the changes you made took effect. ボックスに「hi there」と入力し、Enter キーを押します。Enter hi there in the box, and select Enter. 作成した応答が回答として表示されます。You should see the answer you created as a response.

  2. [検査] を選択し、詳細に応答を確認します。Select Inspect to examine the response in more detail. テスト ウィンドウは、発行前にナレッジ ベースへの変更をテストする際に使用します。The test window is used to test your changes to the knowledge base before they're published.

    テスト パネルのスクリーンショット

  3. もう一度 [テスト] を選択して、 [テスト] ポップアップを閉じます。Select Test again to close the Test pop-up.

ナレッジ ベースの公開Publish the knowledge base

ナレッジ ベースを公開すると、ナレッジ ベースの質問と回答コンテンツが、Azure Search のテスト インデックスから実稼働インデックスへ移動されます。When you publish a knowledge base, the question and answer contents of your knowledge base moves from the test index to a production index in Azure search.

ナレッジ ベースのコンテンツ移動のスクリーン ショット

  1. QnA Maker ポータルの [編集] の隣にあるメニューから、 [発行] を選択します。In the QnA Maker portal, in the menu next to Edit, select Publish. 確認のため、ページの [発行] を選択します。Then to confirm, select Publish on the page.

  2. QnA Maker サービスが正常に発行されました。The QnA Maker service is now successfully published. お使いのアプリケーションまたはボット コードで、エンドポイントを使用できます。You can use the endpoint in your application or bot code.

    正常な発行のスクリーンショット

ボットの作成Create a bot

発行後は、 [発行] ページからボットを作成できます。After publishing, you can create a bot from the Publish page:

  • 複数のボットを迅速に作成し、個々のボットはリージョンや価格プランが異なっていてもすべて同じナレッジ ベースを指すことができます。You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots.
  • ナレッジ ベースのボットを 1 つだけにする場合は、 [View all your bots on the Azure portal](Azure portal 上で自分のボットをすべて表示する) リンクを使用して、ご自分の現在のボットの一覧を表示します。If you want only one bot for the knowledge base, use the View all your bots on the Azure portal link to view a list of your current bots.

ナレッジ ベースに変更を加えて再発行しても、ボットに対して追加のアクションを実行する必要はありません。When you make changes to the knowledge base and republish, you don't need to take further action with the bot. ナレッジ ベースと連携するように既に構成されており、ナレッジ ベースに対する今後のすべての変更に対応します。It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. ナレッジ ベースを発行するたびに、それに接続されているすべてのボットが自動的に更新されます。Every time you publish a knowledge base, all the bots connected to it are automatically updated.

  1. QnA Maker ポータルの [発行] ページで、 [Create bot](ボットの作成) を選択します。In the QnA Maker portal, on the Publish page, select Create bot. このボタンは、ナレッジ ベースの発行後にのみ表示されます。This button appears only after you've published the knowledge base.

    ボットの作成のスクリーンショット

  2. Azure portal の新しいブラウザー タブが開き、Azure Bot Service の作成ページが表示されます。A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Azure Bot Service を構成します。Configure the Azure bot service. これらの構成設定の詳細については、「Azure Bot Service v4 を使用して QnA ボットを作成する」を参照してください。For more information on these configuration settings, see Create a QnA Bot with Azure Bot Service v4.

    • ボットを作成するときに、Azure portal 上で次の設定を変更しないでください。Don't change the following settings in the Azure portal when creating the bot. これらはご自分の既存のナレッジ ベースのために事前に設定されています。They are pre-populated for your existing knowledge base:
      • QnA 認証キーQnA Auth Key
      • App Service プランと場所App service plan and location
      • Azure StorageAzure Storage
    • ボットと QnA Maker は、Web App Service プランを共有できますが、Web アプリを共有することはできません。The bot and QnA Maker can share the web app service plan, but can't share the web app. そのため、アプリ名は、QnA Maker サービスを作成したときに使用したアプリ名と異なる必要があります。This means the app name must be different from the app name you used when you created the QnA Maker service.

次の手順Next steps