Merge pull request #89779 from diberry/0925-qna-quickstart

[Cogsvcs] QnA Maker - switch quickstart

Author: v-shils

.openpublishing.redirection.json

@@ -779,7 +779,12 @@
       "source_path": "articles/cognitive-services/LUIS/luis-how-to-account-settings.md",
       "redirect_url": "/azure/cognitive-services/LUIS/luis-how-to-azure-subscription",
       "redirect_document_id": false
-    },    
+    },
+    {
+      "source_path": "articles/cognitive-services/QnAMaker/How-To/create-knowledge-base.md",
+      "redirect_url": "/azure/cognitive-services/QnAMaker/Quickstarts/create-publish-knowledge-base",
+      "redirect_document_id": false
+    },           
     {
       "source_path": "articles/cognitive-services/QnAMaker/quickstarts/csharp.md",
       "redirect_url": "/azure/cognitive-services/QnAMaker/quickstarts/create-publish-kb-csharp-sdk",
@@ -31706,7 +31711,7 @@
     },
     {
       "source_path": "articles/cognitive-services/QnAMaker/Guides/CreateKB.md",
-      "redirect_url": "/azure/cognitive-services/QnAMaker/How-To/create-knowledge-base",
+      "redirect_url": "/azure/cognitive-services/QnAMaker/Quickstarts/create-publish-knowledge-base",
       "redirect_document_id": false
     },
     {

articles/cognitive-services/QnAMaker/Concepts/development-lifecycle-knowledge-base.md

@@ -19,7 +19,7 @@ QnA Maker learns best in an iterative cycle of model changes, utterance examples
 ![Authoring cycle](../media/qnamaker-concepts-lifecycle/kb-lifecycle.png)
 
 ## Creating a QnA Maker knowledge base
-QnA Maker knowledge base (KB) endpoint provides a best-match answer to a user query based on the content of the KB. Creating a knowledge base is a one-time action to setting up a content repository of questions, answers and associated metadata. A knowledge base can be created by crawling pre-existing content such as FAQ pages, product manuals or structured Q-A pairs. Learn how to [create a knowledge base](../How-To/create-knowledge-base.md).
+QnA Maker knowledge base (KB) endpoint provides a best-match answer to a user query based on the content of the KB. Creating a knowledge base is a one-time action to setting up a content repository of questions, answers and associated metadata. A knowledge base can be created by crawling pre-existing content such as FAQ pages, product manuals or structured Q-A pairs. Learn how to [create a knowledge base](../quickstarts/create-publish-knowledge-base.md).
 
 ## Testing and updating the knowledge base
 
@@ -68,9 +68,4 @@ When you need to go back to a specific version, you need to import that file fro
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Confidence score](./confidence-score.md)
-
-## See also 
-
-[Knowledge base](./knowledge-base.md)
-[QnA Maker overview](../Overview/overview.md)
+> [Confidence score](./confidence-score.md)

articles/cognitive-services/QnAMaker/How-To/create-knowledge-base.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: qna-maker
 ms.topic: conceptual
-ms.date: 06/27/2019
+ms.date: 10/02/2019
 ms.author: diberry
 ---
 
@@ -244,4 +244,4 @@ You can search through the published kb, using `isTest=false`, or in the test kb
 The **Publish** page also provides information to generate an answer with [Postman](../Quickstarts/get-answer-from-kb-using-postman.md) and [cURL](../Quickstarts/get-answer-from-kb-using-curl.md). 
 
 > [!div class="nextstepaction"]
-> [Create a knowledge base](./create-knowledge-base.md)
+> [Create a knowledge base bot](../tutorials/integrate-qnamaker-luis.md)

articles/cognitive-services/QnAMaker/How-To/metadata-generateanswer-usage.md

@@ -8,77 +8,96 @@ services: cognitive-services
 ms.service: cognitive-services
 ms.subservice: qna-maker
 ms.topic: quickstart
-ms.date: 10/01/2019
+ms.date: 10/04/2019
 ms.author: diberry
 ---
 
 # Quickstart: Create, train, and publish your QnA Maker knowledge base
 
 You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions on BitLocker key recovery.
 
+Include a chit-chat personality to make your knowledge more engaging with your users.
+
 [!INCLUDE [Custom subdomains notice](../../../../includes/cognitive-services-custom-subdomains-note.md)]
 
 ## Prerequisite
 
 > [!div class="checklist"]
 > * If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-## Create a QnA Maker knowledge base
+## Create a new QnA Maker knowledge base
 
 1. Sign in to the [QnAMaker.ai](https://QnAMaker.ai) portal with your Azure credentials.
 
 1. On the QnA Maker portal, select **Create a knowledge base**.
 
-   ![Screenshot of QnA Maker portal](../media/qna-maker-create-kb.png)
-
-1. On the **Create** page, in step 1, select **Create a QnA service**. You are directed to the [Azure portal](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesQnAMaker) to set up a QnA Maker service in your subscription. If the Azure portal times out, select **Try again** on the site. After you connect, your Azure dashboard appears.
+1. On the **Create** page, select **Create a QnA service**. You are directed to the [Azure portal](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesQnAMaker) to set up a QnA Maker service in your subscription. 
 
-1. After you successfully create a new QnA Maker service in Azure, return to qnamaker.ai/create. Select your QnA Maker service from the drop-down lists in step 2. If you created a new QnA Maker service, be sure to refresh the page.
+1. In the QnA Maker portal, select your QnA Maker service from the drop-down lists. If you created a new QnA Maker service, be sure to refresh the page.
 
    ![Screenshot of selecting a QnA Maker service knowledge base](../media/qnamaker-quickstart-kb/qnaservice-selection.png)
 
-1. In step 3, name your knowledge base **My Sample QnA KB**.
+1. Name your knowledge base **My Sample QnA KB**.
+
+1. Add a sample word document as a URL: 
+
+    `https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/troubleshooting`
+
+1. Select `+ Add URL`.
+
+1. Add **_professional_ Chit-chat** to your KB. 
+
+1. Select **Create your KB**.
+
+    The extraction process takes a few minutes to read the document and identify questions and answers.
+
+    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.
+
+## Add a new question and answer set
 
-1. To add content to your knowledge base, select three types of data sources. In step 4, under **Populate your KB**, add the 
-   [BitLocker Recovery FAQ](https://docs.microsoft.com/windows/security/information-protection/bitlocker/bitlocker-overview-and-requirements-faq) URL in the **URL** box.
+1. In the QnA Maker portal, on the **Edit** page, select **Add QnA pair**.
+1. Add the following question: 
 
-   ![Screenshot of adding data sources](../media/qnamaker-quickstart-kb/add-datasources.png)
+    `How many Azure services are used by a knowledge base?`
 
-1. In step 5, select **Create your KB**.
+1. Add the answer formatted with _markdown_:
 
-1. While QnA Maker creates the knowledge base, a pop-up window appears. The extraction process takes a few minutes to read the HTML page and identify questions and answers.
+    ` * Azure QnA Maker service\n* Azure Search\n* Azure web app\n* Azure app plan`
 
-1. 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.
+    ![ Add the question as text and the answer formatted with markdown.](../media/qnamaker-create-publish-knowledge-base/add-question-and-answer.png)
 
-## Edit the knowledge base
+    The markdown symbol, `*`, is used for bullet points. The `\n` is used for a new line.  
 
-1. In the QnA Maker portal, on the **Edit** section, select **Add QnA pair** to add a new row to the knowledge base. Under **Question**, enter **Hi.** Under **Answer**, enter **Hello. Ask me BitLocker questions.**
+    The **Edit** page shows the markdown. When you use the **Test** panel later, you will see the markdown displayed properly. 
 
-    ![Screenshot of QnA Maker portal](../media/qnamaker-quickstart-kb/add-qna-pair.png)
+## Save and train
 
-1. 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.
+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. In the QnA Maker portal, in the upper right, select **Test** to test that the changes you made took effect. Enter `hi there` in the box, and select Enter. You should see the answer you created as a response.
+1. In the QnA Maker portal, in the upper right, select **Test** to test that the changes you made took effect. 
+1. Enter an example user query in the textbox. 
 
-1. 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.
+    `How many Azure services are used by a knowledge base?`  
 
-    ![Screenshot of test panel](../media/qnamaker-quickstart-kb/inspect.png)
+    ![ Enter an example user query in the textbox. ](../media/qnamaker-create-publish-knowledge-base/test-panel-in-qna-maker.png)
 
-1. Select **Test** again to close the **Test** pop-up.
+1. Select **Inspect** to examine the response in more detail. The test window is used to test your changes to the knowledge base before publishing your knowledge base.
+
+1. Select **Test** again to close the **Test** panel.
 
 ## Publish the knowledge base
 
-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.
+When you publish a knowledge base, the contents of your knowledge base moves from the `test` index to a `prod` index in Azure search.
 
 ![Screenshot of moving the contents of your knowledge base](../media/qnamaker-how-to-publish-kb/publish-prod-test.png)
 
-1. In the QnA Maker portal, in the menu next to **Edit**, select **Publish**. Then to confirm, select **Publish** on the page.
+1. In the QnA Maker portal, select **Publish**. Then to confirm, select **Publish** on the page.
 
-1. The QnA Maker service is now successfully published. You can use the endpoint in your application or bot code.
+    The QnA Maker service is now successfully published. You can use the endpoint in your application or bot code.
 
-    ![Screenshot of successful publishing](../media/qnamaker-quickstart-kb/publish-sucess.png)
+    ![Screenshot of successful publishing](../media/qnamaker-create-publish-knowledge-base/publish-knowledge-base-to-endpoint.png)
 
 ## Create a bot
 
@@ -93,16 +112,36 @@ When you make changes to the knowledge base and republish, you don't need to tak
 
     ![Screenshot of creating a bot](../media/qnamaker-create-publish-knowledge-base/create-bot-from-published-knowledge-base-page.png)
 
-1. A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configure the Azure bot service. For more information on these configuration settings, see [Create a QnA Bot with Azure Bot Service v4](../tutorials/create-qna-bot.md).
+1. A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configure the Azure bot service. 
 
     * Don't change the following settings in the Azure portal when creating the bot. They are pre-populated for your existing knowledge base: 
         * QnA Auth Key
         * App service plan and location
-        * Azure Storage
-    * The bot and QnA Maker can share the web app service plan, but can't share the web app. This means the **app name** must be different from the app name you used when you created the QnA Maker service. 
+    * The bot and QnA Maker can share the web app service plan, but can't share the web app. This means the **app name** for the bot must be different from the app name for the QnA Maker service. 
+
+1. After the bot is created, open the **Bot service** resource. 
+1. Under **Bot Management**, select **Test in Web Chat**.
+1. At the chat prompt of **Type your message**, enter:
+
+    `Azure services?`
+
+    The chat bot responds with an answer from your knowledge base. 
+
+    ![Enter a user query into the test web chat.](../media/qnamaker-create-publish-knowledge-base/test-web-chat.png)
 
+## Clean up resources
+
+Clean up the QnA Maker and Bot framework resources in the Azure portal. 
 
 ## Next steps
 
+For more information:
+
+* [Markdown format in answers](../concepts/data-sources-supported.md)
+* [Testing your markdown](../concepts/data-sources-supported.md#testing-your-markdown)
+* QnA Maker [data sources](../Concepts/data-sources-supported.md). 
+* [Bot resource configuration settings](../tutorials/create-qna-bot.md).
+
 > [!div class="nextstepaction"]
-> [Create a knowledge base](../How-To/create-knowledge-base.md)
+> [Add questions with metadata](add-question-metadata-portal.md)
+

articles/cognitive-services/QnAMaker/Quickstarts/create-publish-knowledge-base.md

@@ -48,7 +48,7 @@ landingContent:
       - linkListType: get-started
         links:
           - text: "Quickstart: Create a new knowledge base"
-            url: how-to/create-knowledge-base.md
+            url: quickstarts/create-publish-knowledge-base.md
           - text: "Quickstart: Add questions and answer"
             url: quickstarts/add-question-metadata-portal.md
       - linkListType: how-to-guide