Add questions and answer with QnA Maker portal
Note
Azure Open AI On Your Data utilizes large language models (LLMs) to produce similar results to QnA Maker. If you wish to migrate your QnA Maker project to Azure Open AI On Your Data, please check out our guide.
Once a knowledge base is created, add question and answer (QnA) pairs with metadata to filter the answer. The questions in the following table are about Azure service limits, but each has to do with a different Azure search service.
Note
The QnA Maker service is being retired on the 31st of March, 2025. A newer version of the question and answering capability is now available as part of Azure AI Language. For question answering capabilities within the Language Service, see question answering. Starting 1st October, 2022 you won’t be able to create new QnA Maker resources. For information on migrating existing QnA Maker knowledge bases to question answering, consult the migration guide.
| Pair | Questions | Answer | Metadata |
|---|---|---|---|
| #1 | How large a knowledge base can I create?What is the max size of a knowledge base?How many GB of data can a knowledge base hold? |
The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Read [here](../concepts/azure-resources.md) for more details. |
service=qna_makerlink_in_answer=true |
| #2 | How many knowledge bases can I have for my QnA Maker service?I selected an Azure Cognitive Search tier that holds 15 knowledge bases, but I can only create 14 - what is going on?What is the connection between the number of knowledge bases in my QnA Maker service and the Azure Cognitive Search service size? |
Each knowledge base uses 1 index, and all the knowledge bases share a test index. You can have N-1 knowledge bases where N is the number of indexes your Azure Cognitive Search tier supports. |
service=searchlink_in_answer=false |
Once metadata is added to a QnA pair, the client application can:
- Request answers that only match certain metadata.
- Receive all answers but post-process the answers depending on the metadata for each answer.
Prerequisites
- Complete the previous quickstart
Sign in to the QnA Maker portal
Sign in to the QnA Maker portal.
Select your existing knowledge base from the previous quickstart.
Add additional alternatively-phrased questions
The current knowledge base has the QnA Maker troubleshooting QnA pairs. These pairs were created when the URL was added to the knowledge base during the creation process.
When this URL was imported, only one question with one answer was created. In this procedure, add additional questions.
From the Edit page, use the search textbox above the question and answer pairs, to find the question
How large a knowledge base can I create?In the Question column, select + Add alternative phrasing then add each new phrasing, provided in the following table.
Alternative phrasing What is the max size of a knowledge base?How many GB of data can a knowledge base hold?Select Save and train to retrain the knowledge base.
Select Test, then enter a question that is close to one of the new alternative phrasings but isn't exactly the same wording:
What GB size can a knowledge base be?The correct answer is returned in markdown format:
The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Read [here](../concepts/azure-resources.md) for more details.If you select Inspect under the returned answer, you can see more answers met the question but not with the same high level of confidence.
Do not add every possible combination of alternative phrasing. When you turn on QnA Maker's active learning, this finds the alternative phrasings that will best help your knowledge base meet your users' needs.
Select Test again to close the test window.
Add metadata to filter the answers
Adding metadata to a question and answer pair allows your client application to request filtered answers. This filter is applied before the first and second rankers are applied.
Add the second question and answer pair, without the metadata, from the first table in this quickstart, then continue with the following steps.
Select View options, then select Show metadata.
For the QnA pair you just added, select Add metadata tags, then add the name of
serviceand the value ofsearch. It looks like this:service:search.Add another metadata tag with name of
link_in_answerand value offalse. It looks like this:link_in_answer:false.Search for the first answer in the table,
How large a knowledge base can I create?.Add metadata pairs for the same two metadata tags:
link_in_answer:true
service:qna_makerYou now have two questions with the same metadata tags with different values.
Select Save and train to retrain the knowledge base.
Select Publish in the top menu to go to the publish page.
Select the Publish button to publish the current knowledge base to the endpoint.
After the knowledge base is published, continue to the next quickstart to learn how to generate an answer from your knowledge base.
What did you accomplish?
You edited your knowledge base to support more questions and provided name/value pairs to support filtering during the search for the top answer or postprocessing, after the answer or answers are returned.
Clean up resources
If you are not continuing to the next quickstart, delete the QnA Maker and Bot framework resources in the Azure portal.