Create a QnA Maker service

Before you can create any QnA Maker knowledge bases, you must first set up a QnA Maker service in Azure. Anyone with authorization to create new resources in a subscription can set up a QnA Maker service.

Create a new service

This procedure deploys a few Azure resources. Together, these resources manage the knowledge base content and provide question-answering capabilities though an endpoint.

  1. Sign in to the Azure portal and create a QnA Maker resource.

  2. Select Create after reading the terms and conditions.

    Create a new QnA Maker service

  3. In QnA Maker, select the appropriate tiers and regions.

    Create a new QnA Maker service - pricing tier and regions

    • Fill the Name with a unique name to identify this QnA Maker service. This name also identifies the QnA Maker endpoint to which your knowledge bases will be associated.

    • Choose the Subscription in which the QnA Maker resource will be deployed.

    • Select the Pricing tier for the QnA Maker management services (portal and management APIs). See here for details on the pricing of the SKUs.

    • Create a new Resource Group (recommended) or use an existing one in which to deploy this QnA Maker resource. QnA Maker creates several Azure resources; when you create a resource group to hold these resources, you can easily find, manage, and delete these resources by the resource group name.

    • Select a Resource group location.

    • Choose the Search pricing tier of the Azure Search service. If you see the Free tier option greyed out, it means you already have a Free Azure Search tier deployed in your subscription. In that case, you will need to start with the Basic Azure Search tier. See details of Azure search pricing here.

    • Choose the Search Location where you want Azure Search data to be deployed. Restrictions in where customer data must be stored will inform the location you choose for Azure Search.

    • Give a name to your App service in App name.

    • By default the App service defaults to the standard (S1) tier. You can change the plan after creation. See more details of App service pricing here.

    • Choose the Website location where the App Service will be deployed.


      The Search Location can be different from the Website Location.

    • Choose whether you want to enable Application Insights or not. If Application Insights is enabled, QnA Maker collects telemetry on traffic, chat logs, and errors.

    • Choose the App insights location where Application Insights resource will be deployed.

    • For cost savings measures, you can share some but not all Azure resources created for QnA Maker.

  4. Once all the fields are validated, you can select Create to start deployment of these services in your subscription. It will take a few minutes to complete.

  5. Once the deployment is done, you will see the following resources created in your subscription.

    Resource created a new QnA Maker service

Region of management service

The management service of QnA Maker, only used for the portal & for initial data processing, is available only in West US. No customer data is stored in this West US service.

Next steps