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 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 pair
Sign in to the QnA portal, then select the knowledge base to add the QnA pair to.
On the EDIT page of the knowledge base, select Add QnA pair to add a new QnA pair.
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.
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.
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.
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.
Optionally, add follow-up prompts. Follow-up prompts provide additional conversation paths to the client application to present to the user.
Select Save and train to see predictions including the new QnA pair.
Rich-text editing for answer
Rich-text editing of your answer text gives you markdown styling from a simple toolbar.
Select the text area for an answer, the rich-text editor toolbar displays on the QnA pair row.
Any text already in the answer displays correctly as your user will see it from a bot.
Edit the text. Select formatting features from the rich-text editing toolbar or use the toggle feature to switch to markdown syntax.
Rich-text editor features Keyboard shortcut Toggle between rich-text editor and markdown.
CTRL+M Bold. B CTR+LB Italics, indicated with an italicized I CTRL+I Unordered list Ordered list Paragraph style Image - add an image available from a public URL. CTRL+G Add link to publicly available URL. CTRL+K Emoticon - add from a selection of emoticons. CTRL+E Advanced menu - undo CTRL+Z Advanced menu - redo CTRL+Y
Add an image to the answer using the Image icon in the rich-text toolbar. The in-place editor needs the publicly accessible image URL and the alternate text for the image.
Add a link to a URL by either selecting the text in the answer, then selecting the Link icon in the toolbar or by selecting the Link icon in the toolbar then entering new text and the URL.
Edit a QnA pair
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 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 pairs.
Find the QnA pair ID
If you need to find the QnA pair ID, you can find it in two places:
- 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 pair to improve the likelihood of a match to a user query.
Linking QnA pairs
Linking QnA pairs is provided with follow-up prompts. 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 pairs in the answer's metadata.
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.
Learn more about metadata in the QnA Maker portal quickstart for metadata:
Save changes to the QnA pairs
Periodically select Save and train after making edits to avoid losing changes.
When to use rich-text editing versus markdown
Rich-text editing of answers allows you, as the author, to use a formatting toolbar to quickly select and format text.