Merge pull request #99201 from diberry/diberry/1217-allup-fresh

[Cogsvcs] QnA - fresh - create-pub-bot

Author: megvanhuygen

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

@@ -1,14 +1,14 @@
 ---
 title: "Quickstart: Create, train, and publish knowledge base - QnA Maker"
-titleSuffix: Azure Cognitive Services 
+titleSuffix: Azure Cognitive Services
 description: This quickstart shows how to create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. The QnA Maker knowledge base in this example is created from a simple FAQ webpage to answer questions on BitLocker key recovery.
 author: diberry
 manager: nitinme
 services: cognitive-services
 ms.service: cognitive-services
 ms.subservice: qna-maker
 ms.topic: quickstart
-ms.date: 10/14/2019
+ms.date: 12/17/2019
 ms.author: diberry
 ---
 
@@ -31,21 +31,22 @@ Include a chit-chat personality to make your knowledge more engaging with your u
 
 1. On the QnA Maker portal, select **Create a knowledge base**.
 
-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. 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. 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.
+1. In the Azure portal, create the resource. Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when creating the resource.
+1. Return to the QnA Maker portal, refresh the web page in the portal, to continue creating your knowledge base.
 
    ![Screenshot of selecting a QnA Maker service knowledge base](../media/qnamaker-quickstart-kb/qnaservice-selection.png)
 
 1. Name your knowledge base **My Sample QnA KB**.
 
-1. Add a sample word document as a URL: 
+1. Add a sample word document as a URL:
 
     `https://docs.microsoft.com/azure/cognitive-services/qnamaker/troubleshooting`
 
 1. Select `+ Add URL`.
 
-1. Add **_professional_ Chit-chat** to your KB. 
+1. Add **_professional_ Chit-chat** to your KB.
 
 1. Select **Create your KB**.
 
@@ -55,8 +56,8 @@ Include a chit-chat personality to make your knowledge more engaging with your u
 
 ## Add a new question and answer set
 
-1. In the QnA Maker portal, on the **Edit** page, select **Add QnA pair**.
-1. Add the following question: 
+1. In the QnA Maker portal, on the **Edit** page, select **+ Add QnA pair** from the context toolbar.
+1. Add the following question:
 
     `How many Azure services are used by a knowledge base?`
 
@@ -66,20 +67,20 @@ Include a chit-chat personality to make your knowledge more engaging with your u
 
     ![ Add the question as text and the answer formatted with markdown.](../media/qnamaker-create-publish-knowledge-base/add-question-and-answer.png)
 
-    The markdown symbol, `*`, is used for bullet points. The `\n` is used for a new line.  
+    The markdown symbol, `*`, is used for bullet points. The `\n` is used for a new line.
 
-    The **Edit** page shows the markdown. When you use the **Test** panel later, you will see the markdown displayed properly. 
+    The **Edit** page shows the markdown. When you use the **Test** panel later, you will see the markdown displayed properly.
 
 ## Save and train
 
 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. 
-1. Enter an example user query in the textbox. 
+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.
 
-    `How many Azure services are used by a knowledge base?`  
+    `How many Azure services are used by a knowledge base?`
 
     ![ Enter an example user query in the textbox. ](../media/qnamaker-create-publish-knowledge-base/test-panel-in-qna-maker.png)
 
@@ -101,45 +102,57 @@ When you publish a knowledge base, the contents of your knowledge base moves fro
 
 ## Create a bot
 
-After publishing, you can create a bot from the **Publish** page: 
+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. 
-* 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. 
+* You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots.
+* 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. In the QnA Maker portal, on the **Publish** page, select **Create bot**. This button appears only after you've published the knowledge base.
 
     ![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. 
-    
-    * 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
-    * 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. A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configure the Azure bot 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.
+
+    * **Do**
+        * Change bot handle - if it is not unique.
+        * Select SDK Language. Once the bot is created, you can download the code to your local development environment and continue the development process.
+    * **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
 
-1. After the bot is created, open the **Bot service** resource. 
+
+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. 
+    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)
 
+## What did you accomplish?
+
+You created a new knowledge base, added a public URL to the knowledge base, added your own QnA set, trained, tested, and published the knowledge base.
+
+After publishing the knowledge base, you created a bot, and tested the bot.
+
+This was all accomplished in a few minutes without having to write any code and clean the content.
+
 ## Clean up resources
 
-Clean up the QnA Maker and Bot framework resources in the Azure portal. 
+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). 
+* QnA Maker [data sources](../Concepts/data-sources-supported.md).
 * [Bot resource configuration settings](../tutorials/create-qna-bot.md).
 
 > [!div class="nextstepaction"]