|
1 | 1 | ---
|
2 | 2 | title: Edit a knowledge base - QnA Maker
|
3 |
| -titleSuffix: Azure Cognitive Services |
4 |
| -description: QnA Maker allows you to manage the content of your knowledge base by providing an easy-to-use editing experience. |
5 |
| -services: cognitive-services |
6 |
| -author: diberry |
7 |
| -manager: nitinme |
8 |
| -ms.service: cognitive-services |
9 |
| -ms.subservice: qna-maker |
| 3 | +description: QnA Maker allows you to manage the content of your knowledge base by providing an easy-to-use editing experience. |
10 | 4 | ms.topic: conceptual
|
11 |
| -ms.date: 11/21/2019 |
12 |
| -ms.author: diberry |
13 |
| -ms.custom: seodec18 |
| 5 | +ms.date: 03/16/2020 |
14 | 6 | ---
|
15 |
| -# Edit a knowledge base in QnA Maker |
| 7 | + |
| 8 | +# Edit QnA sets in your knowledge base |
16 | 9 |
|
17 | 10 | QnA Maker allows you to manage the content of your knowledge base by providing an easy-to-use editing experience.
|
18 | 11 |
|
19 |
| -<a name="add-datasource"></a> |
| 12 | +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. |
| 13 | + |
| 14 | +## Add an editorial QnA set |
| 15 | +1. Sign in to the [QnA portal](https://www.qnamaker.ai/), then select the knowledge base to add the QnA set to. |
| 16 | +1. On the **EDIT** page of the knowledge base, select **Add QnA set** to add a new QnA set. |
20 | 17 |
|
21 |
| -## Edit your knowledge base content |
| 18 | +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. |
22 | 19 |
|
23 |
| -1. Select **My knowledge bases** in the top navigation bar. |
| 20 | +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. |
24 | 21 |
|
25 |
| - You can see all the services you created or shared with you sorted in the descending order of the **last modified** date. |
| 22 | + When your knowledge base is published, and you have active learning turned on, QnA Maker collects alternate phrasing choices for you to accept. These choices are selected in order to increase the prediction accuracy. |
26 | 23 |
|
27 |
| -  |
| 24 | +1. Optionally, add **metadata**. To view metadata, select **View options** in the context menu. Metadata provides filters to the answers that the client application, such as a chat bot, provides. |
28 | 25 |
|
29 |
| -1. Select a particular knowledge base to make edits to it. |
30 |
| - |
31 |
| -1. Select **Settings**. Here you can edit mandatory field Service Name. |
32 |
| - |
33 |
| - |Goal|Action| |
34 |
| - |--|--| |
35 |
| - |Add URL|You can add new URLs to add new FAQ content to Knowledge base by clicking **Manage knowledge base -> '+ Add URL'** link.| |
36 |
| - |Delete URL|You can delete existing URLs by selecting the delete icon, the trash can.| |
37 |
| - |Refresh content|If you want your knowledge base to crawl the latest content of existing URLs, select the **Refresh** checkbox. This will update the knowledge base with latest URL content once. This is not setting a regular schedule of updates.| |
38 |
| - |Add file|You can add a supported file document to be part of a knowledge base, by selecting **Manage knowledge base**, then selecting **+ Add File**| |
39 |
| - |Import|You can also import any existing knowledge base by selecting **Import Knowledge base** button. | |
40 |
| - |Update|Updating of knowledge base depends on **management pricing tier** used while creating QnA Maker service associated with your knowledge base. You can also update the management tier from Azure portal if required. |
| 26 | +1. Optionally, add **follow-up prompts**. Follow-up prompts provide additional conversation paths to the client application to present to the user. |
41 | 27 |
|
42 |
| -1. Once you are done making changes to the knowledge base, select **Save and train** in the top right corner of the page in order to persist the changes. |
| 28 | +1. Select **Save and train** to see predictions including the new QnA set. |
43 | 29 |
|
44 |
| -  |
| 30 | +## Edit a QnA set |
45 | 31 |
|
46 |
| - >[!CAUTION] |
47 |
| - >If you leave the page before selecting **Save and train**, all changes will be lost. |
| 32 | +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. |
48 | 33 |
|
49 |
| -## Add a QnA pair |
| 34 | +## Delete a QnA set |
50 | 35 |
|
51 |
| -On the **EDIT** page, select **Add QnA pair** to add a new row to the knowledge base table. |
| 36 | +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. |
52 | 37 |
|
53 |
| - |
| 38 | + |
54 | 39 |
|
55 |
| -## Delete a QnA pair |
| 40 | +## Find the QnA set ID |
56 | 41 |
|
57 |
| -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. |
| 42 | +If you need to find the QnA set ID, you can find it in two places: |
58 | 43 |
|
59 |
| - |
| 44 | +* Hover on the delete icon on the QnA set row you are interested in. The hover text includes the QnA set ID. |
| 45 | +* Export the knowledge base. Each QnA set in the knowledge base includes the QnA set ID. |
60 | 46 |
|
61 | 47 | ## Add alternate questions
|
62 | 48 |
|
63 |
| -Add alternate questions to an existing QnA pair to improve the likelihood of a match to a user query. |
| 49 | +Add alternate questions to an existing QnA set to improve the likelihood of a match to a user query. |
64 | 50 |
|
65 | 51 | 
|
66 | 52 |
|
67 | 53 | ## Add metadata
|
68 | 54 |
|
69 |
| -Add metadata pairs by first selecting **View options**, then selecting **Show metadata**. This displays the metadata column. Next, select the **+** sign to add a metadata pair. This pair consists of one key and one value. |
70 |
| - |
71 |
| - |
72 |
| - |
73 |
| -> [!TIP] |
74 |
| -> Make sure to periodically Save and train the knowledge base after making edits to avoid losing changes. |
75 |
| -
|
76 |
| -## Manage large knowledge bases |
77 |
| - |
78 |
| -* **Data source groups**: The QnAs are grouped by the data source from which they were extracted. You can expand or collapse the data source. |
79 |
| - |
80 |
| -  |
| 55 | +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. |
81 | 56 |
|
82 |
| -* **Search knowledge base**: You can search the knowledge base by typing in the text box at the top of the Knowledge Base table. Click enter to search on the question, answer, or metadata content. Click on the X icon to remove the search filter. |
| 57 | +## Save changes to the QnA sets |
83 | 58 |
|
84 |
| -  |
| 59 | +Periodically select **Save and train** after making edits to avoid losing changes. |
85 | 60 |
|
86 |
| -* **Pagination**: Quickly move through data sources to manage large knowledge bases |
87 |
| - |
88 |
| -  |
89 |
| - |
90 |
| -## Delete knowledge bases |
91 |
| - |
92 |
| -Deleting a knowledge base (KB) is a permanent operation. It can't be undone. Before deleting a knowledge base, you should export the knowledge base from the **Settings** page of the QnA Maker portal. |
93 |
| - |
94 |
| -If you share your KB with [collaborators](collaborate-knowledge-base.md) then delete it, everyone loses access to the KB. |
95 |
| - |
96 |
| -## Delete Azure resources |
97 |
| - |
98 |
| -If you delete any of the Azure resources used for your QnA Maker knowledge bases, the knowledge bases will no longer function. Before deleting any resources, make sure you export your knowledge bases from the **Settings** page. |
| 61 | + |
99 | 62 |
|
100 | 63 | ## Next steps
|
101 | 64 |
|
102 | 65 | > [!div class="nextstepaction"]
|
103 | 66 | > [Collaborate on a knowledge base](./collaborate-knowledge-base.md)
|
| 67 | +
|
| 68 | +* [Manage Azure resources used by QnA Maker](set-up-qnamaker-service-azure.md) |
0 commit comments