Skip to content

Commit 75737bd

Browse files
committed
edit pass: four-qna-maker-articles
1 parent 111884a commit 75737bd

File tree

4 files changed

+17
-19
lines changed

4 files changed

+17
-19
lines changed

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ The algorithm to determine proximity is not a simple calculation. The ranges in
4949

5050
Active learning is off by default. Turn it on to see suggested questions.
5151

52-
1. Select **Publish** to publish the knowledge base. Active learning queries are collected from the GenerateAnswer API prediction endpoint only. The queries to the Test pane in the QnA Maker portal don't impact active learning.
52+
1. Select **Publish** to publish the knowledge base. Active learning queries are collected from the GenerateAnswer API prediction endpoint only. The queries to the Test pane in the QnA Maker portal don't affect active learning.
5353

5454
1. To turn active learning on, select your **Name**, and go to [**Service Settings**](https://www.qnamaker.ai/UserSettings) in the QnA Maker portal, in the top right corner.
5555

@@ -58,7 +58,7 @@ Active learning is off by default. Turn it on to see suggested questions.
5858

5959
1. Find the QnA Maker service, and then toggle to **Active Learning**.
6060

61-
[![Screenshot of QnA Maker portal Service Settings](../media/improve-knowledge-base/turn-active-learning-on-at-service-setting.png#lightbox)
61+
[![Screenshot of QnA Maker portal Service Settings](../media/improve-knowledge-base/turn-active-learning-on-at-service-setting.png)](../media/improve-knowledge-base/turn-active-learning-on-at-service-setting.png#lightbox)
6262

6363
When active learning is enabled, the knowledge base suggests new questions at regular intervals based on user-submitted questions. You can disable active learning by toggling the setting again.
6464

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

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -167,8 +167,6 @@ Because results are required only for the restaurant "Paradise", you can set a f
167167
}
168168
```
169169

170-
<name="keep-context"></a>
171-
172170
## Use question and answer results to keep conversation context
173171

174172
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.

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,9 @@ You can create a QnA Maker knowledge base (KB) from your own content, such as FA
3131

3232
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.
3333

34-
1. After you successfully create a new QnA Maker service in Azure, return to qnamaker.ai/create. Select your QnA service from the drop-down lists in step 2. If you created a new QnA service, be sure to refresh the page.
34+
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.
3535

36-
![Screenshot of selecting a QnA service knowledge base](../media/qnamaker-quickstart-kb/qnaservice-selection.png)
36+
![Screenshot of selecting a QnA Maker service knowledge base](../media/qnamaker-quickstart-kb/qnaservice-selection.png)
3737

3838
1. In step 3, name your knowledge base **My Sample QnA KB**.
3939

articles/cognitive-services/QnAMaker/Tutorials/create-publish-query-in-portal.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Create, publish, and answer in QnA Maker
33
titleSuffix: Azure Cognitive Services
4-
description: Create a new knowledge base with questions and answers from a public web-based FAQ. Save, train, and publish the knowledge base. After the knowledge base is published, send a question and receive an answer with a Curl command. Then create a bot, and test the bot with the same question.
4+
description: Create a new knowledge base with questions and answers from a public web-based FAQ. Save, train, and publish the knowledge base. After the knowledge base is published, send a question and receive an answer with a cURL command. Then create a bot, and test the bot with the same question.
55
services: cognitive-services
66
author: diberry
77
manager: nitinme
@@ -16,15 +16,15 @@ ms.author: diberry
1616

1717
# Tutorial: From the QnA Maker portal, create a knowledge base
1818

19-
Create a new knowledge base with questions and answers from a public web-based FAQ. Save, train, and publish the knowledge base. After the knowledge base is published, send a question and receive an answer with a Curl command. Then create a bot, and test the bot with the same question.
19+
Create a new knowledge base with questions and answers from a public web-based FAQ. Save, train, and publish the knowledge base. After the knowledge base is published, send a question and receive an answer with a cURL command. Then create a bot, and test the bot with the same question.
2020

2121
In this tutorial, you learn how to:
2222

2323
> [!div class="checklist"]
2424
> * Create a knowledge base in the QnA Maker portal.
2525
> * Review, save, and train the knowledge base.
2626
> * Publish the knowledge base.
27-
> * Use Curl to query the knowledge base.
27+
> * Use cURL to query the knowledge base.
2828
> * Create a bot.
2929
3030

@@ -83,7 +83,7 @@ This tutorial requires an existing [QnA Maker service](../How-To/set-up-qnamaker
8383

8484
1. From the toolbar above the list of questions and answers, select the **View options** icon, and then select **Show metadata**. This shows the metadata tags for each question and answer. The Chit-chat questions have the **editorial: chit-chat** metadata already set. This metadata is returned to the client application, along with the selected answer. The client application, such as a chat bot, can use this filtered metadata to determine additional processing or interactions with the user.
8585

86-
![Screenshot of QnA Maker portal](../media/qnamaker-tutorial-create-publish-query-in-portal/save-and-train-kb-chit-chat.png#lightbox)
86+
![Screenshot of QnA Maker portal](../media/qnamaker-tutorial-create-publish-query-in-portal/save-and-train-kb-chit-chat.png)](../media/qnamaker-tutorial-create-publish-query-in-portal/save-and-train-kb-chit-chat.png#lightbox)
8787

8888
1. Select **Save and train** in the top menu bar.
8989

@@ -99,17 +99,17 @@ After the knowledge base is published, the endpoint is displayed.
9999

100100
Don't close this **Publish** page. You need it later in the tutorial, to create a bot.
101101

102-
## Use Curl to query for an FAQ answer
102+
## Use cURL to query for an FAQ answer
103103

104104
1. Select the **Curl** tab.
105105

106106
![Screenshot of Curl tab](../media/qnamaker-tutorial-create-publish-query-in-portal/publish-3-curl.png)
107107

108-
1. Copy the text of the **Curl** tab, and run it in a Curl-enabled terminal or command-line. The authorization header's value includes the text `Endpoint`, with a trailing space and then the key.
108+
1. Copy the text of the **Curl** tab, and run it in a cURL-enabled terminal or command-line. The authorization header's value includes the text `Endpoint`, with a trailing space and then the key.
109109

110110
1. Replace `<Your question>` with `How large can my KB be?`. This is close to the question, `How large a knowledge base can I create?`, but not exactly the same. QnA Maker applies natural language processing to determine that the two questions are the same.
111111

112-
1. Run the Curl command and receive the JSON response, including the score and answer.
112+
1. Run the cURL command and receive the JSON response, including the score and answer.
113113

114114
```TXT
115115
% Total % Received % Xferd Average Speed Time Time Time Current
@@ -133,11 +133,11 @@ Don't close this **Publish** page. You need it later in the tutorial, to create
133133
134134
QnA Maker is somewhat confident with the score of 42.81%.
135135
136-
## Use Curl to query for a Chit-chat answer
136+
## Use cURL to query for a Chit-chat answer
137137
138-
1. In the Curl-enabled terminal, replace `How large can my KB be?` with a bot conversation-ending statement from the user, such as `Thank you`.
138+
1. In the cURL-enabled terminal, replace `How large can my KB be?` with a bot conversation-ending statement from the user, such as `Thank you`.
139139
140-
1. Run the Curl command and receive the JSON response, including the score and answer.
140+
1. Run the cURL command and receive the JSON response, including the score and answer.
141141
142142
```TXT
143143
% Total % Received % Xferd Average Speed Time Time Time Current
@@ -173,13 +173,13 @@ Don't close this **Publish** page. You need it later in the tutorial, to create
173173
174174
Because the question of `Thank you` exactly matched a Chit-chat question, QnA Maker is completely confident with the score of 100. QnA Maker also returned all the related questions, as well as the metadata property containing the Chit-chat metadata tag information.
175175
176-
## Use Curl to query for the default answer
176+
## Use cURL to query for the default answer
177177
178178
Any question that QnA Maker is not confident about receives the default answer. This answer is configured in the Azure portal.
179179
180-
1. In the Curl-enabled terminal, replace `Thank you` with `x`.
180+
1. In the cURL-enabled terminal, replace `Thank you` with `x`.
181181
182-
1. Execute the Curl command and receive the JSON response, including the score and answer.
182+
1. Run the cURL command and receive the JSON response, including the score and answer.
183183
184184
```TXT
185185
% Total % Received % Xferd Average Speed Time Time Time Current

0 commit comments

Comments
 (0)