Merge pull request #116554 from diberry/diberry/0526-qnamaker-sets-to-pairs

[Cogsvcs] QnA Maker - set -> pair - 1

Author: American-Dipper

articles/cognitive-services/QnAMaker/Concepts/content-types.md

@@ -44,4 +44,4 @@ Learn more about the [format guidelines](../reference-document-format-guidelines
 
 ## Next steps
 
-Understand what information is stored in a [question and answer (QnA) set](question-answer-set.md).
+Understand what information is stored in a [question and answer (QnA) pair](question-answer-set.md).

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

@@ -1,13 +1,13 @@
 ---
 title: Importing from data sources - QnA Maker
-description: A QnA Maker knowledge base consists of a set of question-and-answer (QnA) sets and optional metadata associated with each QnA pair.
+description: A QnA Maker knowledge base consists of a set of question-and-answer (QnA) pairs and optional metadata associated with each QnA pair.
 ms.topic: conceptual
 ms.date: 03/16/2020
 ---
 
 # Importing from data sources
 
-A knowledge base consists of question and answer sets brought in by public URLs and files.
+A knowledge base consists of question and answer pairs brought in by public URLs and files.
 
 ## Data source locations
 
@@ -21,7 +21,7 @@ The Chit chat QnA content set is offered as a complete content data source in se
 
 ## Structured data format through import
 
-Importing a knowledge base replaces the content of the existing knowledge base. Import requires a structured `.tsv` file that contains questions and answer. This information helps QnA Maker group the question-answer sets and attribute them to a particular data source.
+Importing a knowledge base replaces the content of the existing knowledge base. Import requires a structured `.tsv` file that contains questions and answer. This information helps QnA Maker group the question-answer pairs and attribute them to a particular data source.
 
 | Question  | Answer  | Source| Metadata (1 key: 1 value) |
 |-----------|---------|----|---------------------|
@@ -53,7 +53,7 @@ The **displayOrder** is numeric and the **displayText** is text that shouldn't i
 
 If you are unsure how to represent your QnA pair in the `.tsv` file:
 * Use this [downloadable example from GitHub](https://github.com/Azure-Samples/cognitive-services-sample-data-files/blob/master/qna-maker/data-source-formats/Structured-multi-turn-format.xlsx?raw=true)
-* Or create the set in the QnA Maker portal, save, then export the knowledge base for an example of how to represent the set.
+* Or create the pair in the QnA Maker portal, save, then export the knowledge base for an example of how to represent the pair.
 
 ## Next steps
 

articles/cognitive-services/QnAMaker/Concepts/question-answer-set.md

@@ -1,24 +1,24 @@
 ---
 title: Design knowledge base - QnA Maker
-description: A QnA Maker knowledge base consists of a set of question-and-answer (QnA) sets and optional metadata associated with each QnA pair.
+description: A QnA Maker knowledge base consists of a set of question-and-answer (QnA) pairs and optional metadata associated with each QnA pair.
 ms.topic: conceptual
 ms.date: 01/27/2020
 ---
 
-# Question and answer set concepts
+# Question and answer pair concepts
 
-A knowledge base consists of question and answer (QnA) sets.  Each set has one answer and a set contains all the information associated with that _answer_. An answer can loosely resemble a database row or a data structure instance.
+A knowledge base consists of question and answer (QnA) pairs.  Each pair has one answer and a pair contains all the information associated with that _answer_. An answer can loosely resemble a database row or a data structure instance.
 
-## Question and answer sets
+## Question and answer pairs
 
-The **required** settings in a question-and-answer (QnA) set are:
+The **required** settings in a question-and-answer (QnA) pair are:
 
 * a **question** - text of user query, used to QnA Maker's machine-learning, to align with text of user's question with different wording but the same answer
-* the **answer** - the set's answer is the response that's returned when a user query is matched with the associated question
+* the **answer** - the pair's answer is the response that's returned when a user query is matched with the associated question
 
-Each set is represented by an **ID**.
+Each pair is represented by an **ID**.
 
-The **optional** settings for a set include:
+The **optional** settings for a pair include:
 
 * **Alternate forms of the question** - this helps QnA Maker return the correct answer for a wider variety of question phrasings
 * **Metadata**: Metadata are tags associated with a QnA pair and are represented as key-value pairs. Metadata tags are used to filter QnA pairs and limit the set over which query matching is performed.

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

@@ -1,7 +1,7 @@
 ---
 title: Adding chit-chat to a QnA Maker knowledge base
 titleSuffix: Azure Cognitive Services
-description: Adding personal chit-chat to your bot makes it more conversational and engaging when you create a KB. QnA Maker allows you to easily add a pre-populated set of the top chit-chat, into your KB. 
+description: Adding personal chit-chat to your bot makes it more conversational and engaging when you create a KB. QnA Maker allows you to easily add a pre-populated set of the top chit-chat, into your KB.
 services: cognitive-services
 author: diberry
 manager: nitinme
@@ -15,9 +15,9 @@ ms.custom: seodec18
 
 # Add Chit-chat to a knowledge base
 
-Adding chit-chat to your bot makes it more conversational and engaging. The chit-chat feature in QnA maker allows you to easily add a pre-populated set of the top chit-chat, into your knowledge base (KB). This can be a starting point for your bot's personality, and it will save you the time and cost of writing them from scratch.  
+Adding chit-chat to your bot makes it more conversational and engaging. The chit-chat feature in QnA maker allows you to easily add a pre-populated set of the top chit-chat, into your knowledge base (KB). This can be a starting point for your bot's personality, and it will save you the time and cost of writing them from scratch.
 
-This dataset has about 100 scenarios of chit-chat in the voice of multiple personas, like Professional,Friendly and Witty. Choose the persona that most closely resembles your bot's voice. Given a user query, QnA Maker tries to match it with the closest known chit-chat QnA.  
+This dataset has about 100 scenarios of chit-chat in the voice of multiple personas, like Professional,Friendly and Witty. Choose the persona that most closely resembles your bot's voice. Given a user query, QnA Maker tries to match it with the closest known chit-chat QnA.
 
 Some examples of the different personalities are below. You can see all the personality [datasets](https://github.com/Microsoft/BotBuilder-PersonalityChat/tree/master/CSharp/Datasets) along with details of the personalities.
 
@@ -52,23 +52,23 @@ Chit-chat data sets are supported in the following languages:
 
 
 ## Add chit-chat during KB creation
-During knowledge base creation, after adding your source URLs and files, there is an option for adding chit-chat. Choose the personality that you want as your chit-chat base. If you do not want to add chit-chat, or if you already have chit-chat support in your data sources, choose **None**. 
+During knowledge base creation, after adding your source URLs and files, there is an option for adding chit-chat. Choose the personality that you want as your chit-chat base. If you do not want to add chit-chat, or if you already have chit-chat support in your data sources, choose **None**.
 
 ## Add Chit-chat to an existing KB
-Select your KB, and navigate to the **Settings** page. There is a link to all the chit-chat datasets in the appropriate **.tsv** format. Download the personality you want, then upload it as a file source. Make sure not to edit the format or the metadata when you download and upload the file. 
-  
+Select your KB, and navigate to the **Settings** page. There is a link to all the chit-chat datasets in the appropriate **.tsv** format. Download the personality you want, then upload it as a file source. Make sure not to edit the format or the metadata when you download and upload the file.
+
 ![Add chit-chat to existing KB](../media/qnamaker-how-to-chit-chat/add-chit-chat-dataset.png)
 
 ## Edit your chit-chat questions and answers
-When you edit your KB, you will see a new source for chit-chat, based on the personality you selected. You can now add altered questions or edit the responses, just like with any other source. 
+When you edit your KB, you will see a new source for chit-chat, based on the personality you selected. You can now add altered questions or edit the responses, just like with any other source.
 
 ![Edit chit-chat QnAs](../media/qnamaker-how-to-chit-chat/edit-chit-chat.png)
 
 To view the metadata, select **View Options** in the toolbar, then select **Show metadata**.
 
 ## Add additional chit-chat questions and answers
-You can add new chit-chat QnA that is not in the predefined set. Ensure that you are not duplicating a QnA pair that is already covered in the chit-chat set. When you add any new chit-chat QnA, it gets added to your **Editorial** source. To ensure the ranker understands that this is chit-chat, add the metadata key/value pair "Editorial: chitchat", as seen in the following image:
-   
+You can add a new chit-chat QnA pair that is not in the predefined data set. Ensure that you are not duplicating a QnA pair that is already covered in the chit-chat set. When you add any new chit-chat QnA, it gets added to your **Editorial** source. To ensure the ranker understands that this is chit-chat, add the metadata key/value pair "Editorial: chitchat", as seen in the following image:
+
 ![![Add chit-chat QnAs](../media/qnamaker-how-to-chit-chat/add-new-chit-chat.png)](../media/qnamaker-how-to-chit-chat/add-new-chit-chat.png#lightbox)
 
 ## Delete chit-chat from an existing KB
@@ -81,6 +81,6 @@ Select your KB, and navigate to the **Settings** page. Your specific chit-chat s
 > [!div class="nextstepaction"]
 > [Import a knowledge base](../Tutorials/migrate-knowledge-base.md)
 
-## See also 
+## See also
 
 [QnA Maker overview](../Overview/overview.md)

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

@@ -79,7 +79,7 @@ Any field in any QnA pair can be edited, regardless of the original data source.
 
 ## Delete a QnA pair
 
-To delete a QnA, click the **delete** icon on the far right of the QnA row. This is a permanent operation. It can't be undone. Consider exporting your KB from the **Publish** page before deleting sets.
+To delete a QnA, click the **delete** icon on the far right of the QnA row. This is a permanent operation. It can't be undone. Consider exporting your KB from the **Publish** page before deleting pairs.
 
 ![Delete QnA pair](../media/qnamaker-how-to-edit-kb/delete-qnapair.png)
 

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

@@ -1,7 +1,7 @@
 ---
 title: Metadata with GenerateAnswer API - QnA Maker
 titleSuffix: Azure Cognitive Services
-description: QnA Maker lets you add metadata, in the form of key/value pairs, to your question/answer sets. You can filter results to user queries, and store additional information that can be used in follow-up conversations.
+description: QnA Maker lets you add metadata, in the form of key/value pairs, to your question/answer pairs. You can filter results to user queries, and store additional information that can be used in follow-up conversations.
 services: cognitive-services
 author: diberry
 manager: nitinme
@@ -16,7 +16,7 @@ ms.author: diberry
 
 To get the predicted answer to a user's question, use the GenerateAnswer API. When you publish a knowledge base, you can see information about how to use this API on the **Publish** page. You can also configure the API to filter answers based on metadata tags, and test the knowledge base from the endpoint with the test query string parameter.
 
-QnA Maker lets you add metadata, in the form of key and value pairs, to your sets of questions and answers. You can then use this information to filter results to user queries, and to store additional information that can be used in follow-up conversations. For more information, see [Knowledge base](../Concepts/knowledge-base.md).
+QnA Maker lets you add metadata, in the form of key and value pairs, to your pairs of questions and answers. You can then use this information to filter results to user queries, and to store additional information that can be used in follow-up conversations. For more information, see [Knowledge base](../Concepts/knowledge-base.md).
 
 <a name="qna-entity"></a>
 
@@ -32,7 +32,7 @@ Each QnA entity has a unique and persistent ID. You can use the ID to make updat
 
 ## Get answer predictions with the GenerateAnswer API
 
-You use the [GenerateAnswer API](https://docs.microsoft.com/rest/api/cognitiveservices/qnamakerruntime/runtime/generateanswer) in your bot or application to query your knowledge base with a user question, to get the best match from the question and answer sets.
+You use the [GenerateAnswer API](https://docs.microsoft.com/rest/api/cognitiveservices/qnamakerruntime/runtime/generateanswer) in your bot or application to query your knowledge base with a user question, to get the best match from the question and answer pairs.
 
 <a name="generateanswer-endpoint"></a>
 
@@ -191,7 +191,7 @@ Because results are required only for the restaurant "Paradise", you can set a f
 
 ## Use question and answer results to keep conversation context
 
-The response to the GenerateAnswer contains the corresponding metadata information of the matched question and answer set. You can use this information in your client application to store the context of the previous conversation for use in later conversations.
+The response to the GenerateAnswer contains the corresponding metadata information of the matched question and answer pair. You can use this information in your client application to store the context of the previous conversation for use in later conversations.
 
 ```json
 {

articles/cognitive-services/QnAMaker/Overview/overview.md

@@ -35,9 +35,9 @@ Once a QnA Maker knowledge base is published, a client application sends a quest
 
 ## What is a knowledge base?
 
-QnA Maker [imports your content](../concepts/knowledge-base.md) into a knowledge base of question and answer sets. The import process extracts information about the relationship between the parts of your structured and semi-structured content to imply relationships between the question and answer sets. You can edit these question and answer sets or add new sets.
+QnA Maker [imports your content](../concepts/knowledge-base.md) into a knowledge base of question and answer pairs. The import process extracts information about the relationship between the parts of your structured and semi-structured content to imply relationships between the question and answer pairs. You can edit these question and answer pairs or add new pairs.
 
-The content of the question and answer set includes:
+The content of the question and answer pair includes:
 * All the alternate forms of the question
 * Metadata tags used to filter answer choices during the search
 * Follow-up prompts to continue the search refinement
@@ -48,7 +48,7 @@ After you publish your knowledge base, a client application sends a user's quest
 
 ## Create, manage, and publish to a bot without code
 
-The QnA Maker portal provides the complete knowledge base authoring experience. You can import documents, in their current form, to your knowledge base. These documents (such as an FAQ, product manual, spreadsheet, or web page) are converted into question and answer sets. Each set is analyzed for follow-up prompts and connected to other sets. The final _markdown_ format supports rich presentation including images and links.
+The QnA Maker portal provides the complete knowledge base authoring experience. You can import documents, in their current form, to your knowledge base. These documents (such as an FAQ, product manual, spreadsheet, or web page) are converted into question and answer pairs. Each pair is analyzed for follow-up prompts and connected to other pairs. The final _markdown_ format supports rich presentation including images and links.
 
 Once your knowledge base is edited, publish the knowledge base to a working [Azure Web App bot](https://azure.microsoft.com/services/bot-service/) without writing any code. Test your bot in the [Azure portal](https://portal.azure.com) or download and continue development.
 
@@ -58,7 +58,7 @@ QnA Maker's system is a layered ranking approach. The data is stored in Azure se
 
 ## QnA Maker improves the conversation process
 
-QnA Maker provides multi-turn prompts and active learning to help you improve your basic question and answer sets.
+QnA Maker provides multi-turn prompts and active learning to help you improve your basic question and answer pairs.
 
 **Multi-turn prompts** give you the opportunity to connect question and answer pairs. This connection allows the client application to provide a top answer and provides more questions to refine the search for a final answer.