Q&A Maker FAQs
- QnA Maker is primarily meant to provide a FAQ data source that you can query from your bot/application. Although developers will find this useful, content owners will especially benefit from this tool. QnA Maker is a completely no-code way of managing the content that powers your bot/application.
- You can log in with your Microsoft account.
- Yes. The QnA Maker tool is currently free to use. However, we do meter usage per account. See the Subscription Keys section of the documentation for details.
- It’s possible that the tool is not able to auto-extract QnA from valid FAQ URLs. In such cases, you have the option of copying and pasting the QnA content into a .txt and then trying to ingest it. Alternately, you can always editorially add content to your knowledge base.
We support two formats of files for ingestion.
- .tsv: QnA contained in the Question-Answer format
- .txt, .docx, .pdf: QnA contained as regular FAQ content, i.e. a sequence of questions and answers.
- Currently, we have a limit of a 20 MB knowledge base.
- Every edit operation, whether in Table update, Test or Settings needs to be saved before it can be published. Make sure you press the Save and retrain button after every edit operation.
- Currently, the QnA Maker tool handles semi-structured FAQ content. Eventually, the vision is to be able to answer questions from unstructured content as well.
- No, you don’t. However, QnA Maker is offered as one of several templates in Azure Bot Service that enables rapid intelligent bot development powered by Microsoft Bot Framework, and runs in a serverless environment. Bots scale based on demand; only pay for the resources you consume.
- The format in which the upload expects the file is tab-separated columns of Question, Answer and Source.
- You should refresh your subscription keys if you suspect that they have been compromised. Any requests with your subscription key will count towards your quota.
- All knowledge base content is stored in Azure storage by the QnAMaker tool. You need a combination of a knowledge base ID and a subscription key to access the knowledge base. The knowledge base contents are not used by the tool for any other purpose.
- The knowledge base supports Markdown. However, the auto-extraction from URLs has limited HTML-to-Markdown conversion capability. If you want to use full-fledged Markdown, you can modify your content directly in the table, or upload a KB with the rich content.
- The QnA Maker tool ingests and matches data in UTF-16 encoding. This means that any language should work as is. Having said that, we have only extensively tested the relevance of the service for EN so far.
- In the new service, we do not have the test URL anymore. This is because, as part of the cognitive services, all calls are being metered. As the test URL exposes the subscription key and the KB ID, it is a security risk. However, it is still super easy to chat with your KB and share it. Take a look at the Azure Bot Templates for Question and Answer Bot. You can light up the QnA Bot in Skype in a few clicks, and then share it with anyone.
Follow the below steps to embed the QnA Maker service as a web-chat control on your website:
- Create your knowledge base at https://qnamaker.ai
- Create your Azure service bot: https://docs.botframework.com/en-us/azure-bots/build/first-bot
- Look for the Question and Answer Bot template. Select the KB ID you created in step 1, then enable it on the web-chat channel. Get the embed keys.
- Embed the web-chat as shown in https://docs.botframework.com/en-us/support/embed-chat-control2
- The chat logs are tab-separated files, with the query and the frequency as the columns. Frequency is the number of times the same query was seen. The file is sorted in descending order of frequency. Select questions from the downloaded file you want to test, and then upload it to see what responses the system returned for them.