The Question and Answer Skill, QnA Skill, uses Microsoft’s QnA Maker service allowing you to create a natural conversation layer over your data. Answers can prompt responses from the user that can make up a conversational flow.
Each knowledge base can contain many questions and answers. Alternative phrasing for a question is also available giving the admin the ability to pair a number of questions and phrases with a single answer.
The Skill allows QnA pairs to have follow on QnA's as well as actions linked to them based on the question pre-empting the users needs.
This article shows you how to set up the QnA skill.
It covers the following topics
- How to add the QnA skill
- How to add a question and answer to your knowledge base
- How to create a new topics
- How to edit a QnA pair
- How to delete a QnA pair
- Filter to change and filter to suggestion
- Maintaining your Knowledge Base
- Query your Knowledge Base
- How to test your Assistant
Adding the QnA Skill
- Click the ellipsis (three dots) button, top right on your screen followed by Add Skill.
- Click Add QnA Skill from the list of skills displayed.
- Once created select the skill to view.
- Click on Add Knowledge Base. The number of knowledge bases you are able to ass is dependent on your subscription, please contact your account manager or support for further assistance.
- Enter the details required. Click OK to save.
- Once your knowledge base is created, click the ellipsis (three dots) button, and select Edit.
- You will see the QnA home page where you can add, and edit your QnA pairs.
Topics - Topics are groupings of QnA pairs. QnA's can be moved across topics
- Click Add Topic.
- Enter the details required. Click OK to save.
Create a QnA pair
- Click +Add.
- Enter the question in the Q box and the answer in the A box.
- Click OK to save.
Edit your QnA pair
You can edit a QnA pair to add alternative phrasing, Follow-on prompts, Action Links, and Metadata.
- Click the Edit button by the QnA pair to edit. Click OK to save.
Delete a QnA pair
You can delete QnA pairs individually or in bulk by Topic.
- To delete in bulk by topic, click the Delete button at the topic level. Click Ok to confirm.
- To delete individually, click the Delete button beside the QnA. Click OK to confirm.
Filter to changes: Showing the changes made since the last save.
Filter to suggestions: The QnA is based on Azure bot framework giving Tenjin the ability to incorporate machine. If a question gets asked a lot, and it does not have a good answer, then Tenjin will make it a 'suggestion'. Tenjin will make its best guess about which answer the question should be assigned. It will generally not be sure about this and will suggest several answers as a possible home for the question.
You should look at the suggestions, if one of the answers is a good match, add it as a question for the answer. If none of the answers is a good match for the question, you should add it as a new question and fill in a suitable answer.
Amending the matching threshold percentage
When a user query is matched against a knowledge base, QnA Maker returns relevant answers, along with a confidence score. This score indicates the confidence that the answer is the right match for the given user query. We recommend a match threshold percentage of 25%.
Detailed inline help is available describing confidence score, score value, and score meaning.
- From your QnA home page, select the pen icon or click the ellipsis (three dots) button against your knowledge base name.
- Select Properties from the drop-down list.
- Edit the matching threshold percentage field.
- Detail inline help is available through the Help button.
- Click the Query button from the top of your knowledge base home screen.
The query button lets you query the knowledge base with the same natural language processing that the assistant uses.
The assistant will not show the result of a query unless the score exceeds the match threshold. The query dialog shows the score for a query, the match threshold, and whether it would be included in the assistant's results.
Often an expected result is not shown in the assistant because its score does not exceed the match threshold. You can use Query dialog to check if this is the case. If you do not get a good match to your question, consider adding it as an alternative phrasing the to correct answer.
- Type in a question to see what results the assistant will show, Click Query.
- Results displayed. Here you will see what answer will be returned to the user and the match score of that answer. This enables the admin of the system to make changes to the QnA pair in order to enable the users to find answers with ease.
- Inline Help is available.
Knowledge Base maintenance
- Click the ellipsis (three dots) button beside your knowledge base within your assistant page.
- Click Edit to maintain and add QnA skills.
- Click Manage Topics to show a list of all topics.
- Click Delete to delete your knowledge base.
- Click Backup from File to save the contents of your knowledge base.
- Click Restore to File to retrieve a stored knowledge base.
Testing your QnA skill
- From your assistant page click Test Assistant button.