Merge pull request #110417 from diberry/diberry/0406-qna-qna-pair-2

[CogSvcs] QnA Set -> Pair - 2

Author: shawnmariejones

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

@@ -28,7 +28,7 @@ The **optional** settings for a set include:
 
 ## Editorially add to knowledge base
 
-If you do not have pre-existing content to populate the knowledge base, you can add QnA sets editorially in the QnA Maker portal. Learn how to update your knowledge base [here](../How-To/edit-knowledge-base.md).
+If you do not have pre-existing content to populate the knowledge base, you can add QnA pairs editorially in the QnA Maker portal. Learn how to update your knowledge base [here](../How-To/edit-knowledge-base.md).
 
 ## Editing your knowledge base locally
 

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

@@ -5,17 +5,17 @@ ms.topic: conceptual
 ms.date: 04/06/2020
 ---
 
-# Edit QnA sets in your knowledge base
+# Edit QnA pairs in your knowledge base
 
 QnA Maker allows you to manage the content of your knowledge base by providing an easy-to-use editing experience.
 
-QnA sets are added from a datasource, such as a file or URL, or added as an editorial source. An editorial source indicates the QnA set was added in the QnA portal manually. All QnA sets are available for editing.
+QnA pairs are added from a datasource, such as a file or URL, or added as an editorial source. An editorial source indicates the QnA pair was added in the QnA portal manually. All QnA pairs are available for editing.
 
-## Add an editorial QnA set
-1. Sign in to the [QnA portal](https://www.qnamaker.ai/), then select the knowledge base to add the QnA set to.
-1. On the **EDIT** page of the knowledge base, select **Add QnA set** to add a new QnA set.
+## Add an editorial QnA pair
+1. Sign in to the [QnA portal](https://www.qnamaker.ai/), then select the knowledge base to add the QnA pair to.
+1. On the **EDIT** page of the knowledge base, select **Add QnA pair** to add a new QnA pair.
 
-1. In the new QnA set row, add the required **Question** and **Answer** fields. The other fields are optional. All fields can be changed at any time.
+1. In the new QnA pair row, add the required **Question** and **Answer** fields. The other fields are optional. All fields can be changed at any time.
 
 1. Optionally, add **alternate phrasing**. Alternate phrasing is any form of the question that is significantly different from the original question but should provide the same answer.
 
@@ -25,42 +25,42 @@ QnA sets are added from a datasource, such as a file or URL, or added as an edit
 
 1. Optionally, add **follow-up prompts**. Follow-up prompts provide additional conversation paths to the client application to present to the user.
 
-1. Select **Save and train** to see predictions including the new QnA set.
+1. Select **Save and train** to see predictions including the new QnA pair.
 
-## Edit a QnA set
+## Edit a QnA pair
 
-Any field in any QnA set can be edited, regardless of the original data source. Some fields may not be visible due to your current **View Options** settings, found in the context tool bar.
+Any field in any QnA pair can be edited, regardless of the original data source. Some fields may not be visible due to your current **View Options** settings, found in the context tool bar.
 
-## Delete a QnA set
+## 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.
 
-![Delete QnA set](../media/qnamaker-how-to-edit-kb/delete-qnapair.png)
+![Delete QnA pair](../media/qnamaker-how-to-edit-kb/delete-qnapair.png)
 
-## Find the QnA set ID
+## Find the QnA pair ID
 
-If you need to find the QnA set ID, you can find it in two places:
+If you need to find the QnA pair ID, you can find it in two places:
 
-* Hover on the delete icon on the QnA set row you are interested in. The hover text includes the QnA set ID.
-* Export the knowledge base. Each QnA set in the knowledge base includes the QnA set ID.
+* Hover on the delete icon on the QnA pair row you are interested in. The hover text includes the QnA pair ID.
+* Export the knowledge base. Each QnA pair in the knowledge base includes the QnA pair ID.
 
 ## Add alternate questions
 
-Add alternate questions to an existing QnA set to improve the likelihood of a match to a user query.
+Add alternate questions to an existing QnA pair to improve the likelihood of a match to a user query.
 
 ![Add Alternate Questions](../media/qnamaker-how-to-edit-kb/add-alternate-question.png)
 
-## Linking QnA Sets
+## Linking QnA pairs
 
-Linking QnA sets is provided with [follow-up prompts](multiturn-conversation.md). This is a logical connection between QnA sets, managed at the knowledge base level. You can edit follow-up prompts in the QnA Maker portal.
+Linking QnA pairs is provided with [follow-up prompts](multiturn-conversation.md). This is a logical connection between QnA pairs, managed at the knowledge base level. You can edit follow-up prompts in the QnA Maker portal.
 
-You can't link QnA sets in the answer's metadata.
+You can't link QnA pairs in the answer's metadata.
 
 ## Add metadata
 
 Add metadata sets by first selecting **View options**, then selecting **Show metadata**. This displays the metadata column. Next, select the **+** sign to add a metadata set. This set consists of one key and one value.
 
-## Save changes to the QnA sets
+## Save changes to the QnA pairs
 
 Periodically select **Save and train** after making edits to avoid losing changes.
 

articles/cognitive-services/QnAMaker/How-To/manage-knowledge-bases.md

@@ -102,5 +102,5 @@ If you share your knowledge base with collaborators,](collaborate-knowledge-base
 
 Learn about [managing the language](language-knowledge-base.md) of all knowledge bases in a resource.
 
-* Edit QnA sets
+* Edit QnA pairs
 * Manage Azure resources used by QnA Maker

articles/cognitive-services/QnAMaker/Quickstarts/add-question-metadata-portal.md

@@ -22,7 +22,7 @@ Once a knowledge base is created, add question and answer (QnA) sets with metada
 |#1|`How large a knowledge base can I create?`<br><br>`What is the max size of a knowledge base?`<br><br>`How many GB of data can a knowledge base hold?` |`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.`|`service=qna_maker`<br>`link_in_answer=true`|
 |#2|`How many knowledge bases can I have for my QnA Maker service?`<br><br>`I selected a Azure Cognitive Search tier that holds 15 knowledge bases, but I can only create 14 - what is going on?`<br><br>`What is the connection between the number of knowledge bases in my QnA Maker service and the Azure Cognitive Search service size?` |`Each knowledge base uses 1 index, and all the knowledge bases share a test index. You can have N-1 knowledge bases where N is the number of indexes your Azure Cognitive Search tier supports.`|`service=search`<br>`link_in_answer=false`|
 
-Once metadata is added to a QnA set, the client application can:
+Once metadata is added to a QnA pair, the client application can:
 
 * Request answers that only match certain metadata.
 * Receive all answers but post-process the answers depending on the metadata for each answer.
@@ -40,7 +40,7 @@ Once metadata is added to a QnA set, the client application can:
 
 ## Add additional alternatively-phrased questions
 
-The current knowledge base has the QnA Maker troubleshooting QnA sets. These sets were created when the URL was added to the knowledge base during the creation process.
+The current knowledge base has the QnA Maker troubleshooting QnA pairs. These sets were created when the URL was added to the knowledge base during the creation process.
 
 When this URL was imported, only one question with one answer was created. In this procedure, add additional questions.
 
@@ -77,7 +77,7 @@ Adding metadata to a question and answer set allows your client application to r
 
 1. Select **View options**, then select **Show metadata**.
 
-1. For the QnA set you just added, select **Add metadata tags**, then add the name of `service` and the value of `search`. It looks like this: `service:search`.
+1. For the QnA pair you just added, select **Add metadata tags**, then add the name of `service` and the value of `search`. It looks like this: `service:search`.
 
 1. Add another metadata tag with name of `link_in_answer` and value of `false`. It looks like this: `link_in_answer:false`.
 

articles/cognitive-services/QnAMaker/Quickstarts/batch-testing.md

@@ -144,7 +144,7 @@ Use the following chart to understand how to find the field values for optional
     |Charge your Surface Pro 4|
     |Check the battery level|
 
-    Two QnA sets have the metadata set.
+    Two QnA pairs have the metadata set.
 
     > [!TIP]
     > To see the metadata and QnA IDs of each set, export the knowledge base. Select the **Settings** page, then select **Export** as a `.xls` file. Find this downloaded file and open with Excel reviewing for metadata and ID.
@@ -164,7 +164,7 @@ There are two main scenarios for batch testing:
 
 The following procedure assumes the scenario is to process chat logs with
 
-1. Create a new batch test file to include optional data, `batch-test-data-2.tsv`. Add the 6 rows from the original batch test input file, then add the metadata, top, and QnA set ID for each row.
+1. Create a new batch test file to include optional data, `batch-test-data-2.tsv`. Add the 6 rows from the original batch test input file, then add the metadata, top, and QnA pair ID for each row.
 
     To simulate the automated process of checking new text from chat logs against the knowledge base, set the metadata for each column to the same value: `topic:power`.
 

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

@@ -131,7 +131,7 @@ When you make changes to the knowledge base and republish, you don't need to tak
 
 ## 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.
+You created a new knowledge base, added a public URL to the knowledge base, added your own QnA pair, trained, tested, and published the knowledge base.
 
 After publishing the knowledge base, you created a bot, and tested the bot.
 

articles/cognitive-services/QnAMaker/includes/quickstart-test-tool-curl.md

@@ -29,13 +29,13 @@ This cURL-based quickstart walks you through getting an answer from your knowled
 Use the knowledge base from the previous quick to query for an answer based on metadata.
 
 1. From the knowledge base's **Settings** page, select the **CURL** tab to see an example cURL command used to generate an answer from the knowledge base.
-1. Copy the command to an editable environment (such as a text file) so you can edit the command. Edit the question value as follows so that the metadata of `service:qna_maker` is used as a filter for the QnA sets.
+1. Copy the command to an editable environment (such as a text file) so you can edit the command. Edit the question value as follows so that the metadata of `service:qna_maker` is used as a filter for the QnA pairs.
 
     ```bash
     curl -X POST https://replace-with-your-resource-name.azurewebsites.net/qnamaker/knowledgebases/replace-with-your-knowledge-base-id/generateAnswer -H "Authorization: EndpointKey replace-with-your-endpoint-key" -H "Content-type: application/json" -d "{'top':30, 'question':'size','strictFilters': [{'name':'service','value':'qna_maker'}]}"
     ```
 
-    The question is just a single word, `size`, which can return either of the two QnA sets. The `strictFilters` array tells the response to reduce to just the `qna_maker` answers.
+    The question is just a single word, `size`, which can return either of the two QnA pairs. The `strictFilters` array tells the response to reduce to just the `qna_maker` answers.
 
 1. The response includes only the answer that meets the filter criteria. The following cURL response has been formatted for readability:
 

articles/cognitive-services/QnAMaker/includes/quickstart-test-tool-postman.md

@@ -44,7 +44,7 @@ Use this procedure to configure Postman, then read each subsequent section to co
 
 ## Use metadata to filter answer
 
-In a previous quickstart, metadata was added to two QnA sets to distinguish between two different questions. Add the metadata to the query to restrict the filter to just the relevant QnA set.
+In a previous quickstart, metadata was added to two QnA pairs to distinguish between two different questions. Add the metadata to the query to restrict the filter to just the relevant QnA pair.
 
 1. In Postman, change only the query JSON by adding the `strictFilters` property with the name/value pair of `service:qna_maker`. The body JSON should be: