Edit

Tutorial: Add your knowledge base to Power Virtual Agents

  • Article

Create and extend a Power Virtual Agents bot to provide answers from your knowledge base.

Note

The integration demonstrated in this tutorial is in preview and is not intended for deployment to production environments.

In this tutorial, you learn how to:

  • Create a Power Virtual Agents bot
  • Create a system fallback topic
  • Add QnA Maker as an action to a topic as a Power Automate flow
  • Create a Power Automate solution
  • Add a Power Automate flow to your solution
  • Publish Power Virtual Agents
  • Test Power Virtual Agents, and recieve an answer from your QnA Maker knowledge base

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.

Create and publish a knowledge base

  1. Follow the quickstart to create a knowledge base. Don't complete the last section, about creating a bot. Instead, use this tutorial to create a bot with Power Virtual Agents.

    Screenshot of published knowledge base settings

    Enter your published knowledge base settings found on the Settings page in the QnA Maker portal. You will need this information for the Power Automate step to configure your QnA Maker GenerateAnswer connection.

  2. In the QnA Maker portal, on the Settings page, find the endpoint key, endpoint host, and knowledge base ID.

Create bot in Power Virtual Agents

Power Virtual Agents allows teams to create powerful bots by using a guided, no-code graphical interface. You don't need data scientists or developers.

Create a bot by following the steps in Create and delete Power Virtual Agents bots.

Create the system fallback topic

In Power Virtual Agents, you create a bot with a series of topics (subject areas), in order to answer user questions by performing actions.

Although the bot can connect to your knowledge base from any topic, this tutorial uses the system fallback topic. The fallback topic is used when the bot can't find an answer. The bot passes the user's text to QnA Maker's GenerateAnswer API, receives the answer from your knowledge base, and displays it to the user as a message.

Create a fallback topic by following the steps in Configure the system fallback topic in Power Virtual Agents.

Use the authoring canvas to add an action

Use the Power Virtual Agents authoring canvas to connect the fallback topic to your knowledge base. The topic starts with the unrecognized user text. Add an action that passes that text to QnA Maker, and then shows the answer as a message. The last step of displaying an answer is handled as a separate step, later in this tutorial.

This section creates the fallback topic conversation flow.

  1. The new fallback action might already have conversation flow elements. Delete the Escalate item by selecting the Options menu.

    Partial screenshot of conversation flow, with delete option highlighted.

  2. Above the Message node, select the plus (+) icon, and then select Call an action.

    Partial Screenshot of Call an action.

  3. Select Create a flow. The process takes you to the Power Automate portal.

    Screenshot of Create a flow

    Power Automate opens to a new template. You won't use this new template.

    Partial Screenshot of Power Automate with new flow template.

Create a Power Automate flow to connect to your knowledge base

Note

Currently the Power Automate template does not support QnA Maker managed (Preview) endpoints. To add a QnA Maker managed (Preview) knowledge base to Power Automate skip this step and manually add the endpoints to it.

The following procedure creates a Power Automate flow that:

  • Takes the incoming user text, and sends it to QnA Maker.
  • Returns the top response back to your bot.

  1. In Power Automate, select Templates from the left navigation. If you are asked if you want to leave the browser page, accept Leave.

  2. On the templates page, search for the template Generate answer using QnA Maker then select the template. This template has all the steps to call QnA Maker with your knowledge base settings and return the top answer.

  3. On the new screen for the QnA Maker flow, select Continue.

    Partial Screenshot of QnA Maker template flow with Continue button highlighted.

  4. Select the Generate Answer action box, and fill in your QnA Maker settings from a previous section titled Create and publish a knowledge base. Your Service Host in the following image refers to your knowledge base host Host and is in the format of https://YOUR-RESOURCE-NAME.azurewebsites.net/qnamaker.

    Partial Screenshot of QnA Maker template flow with Generate answer (Preview) highlighted.

  5. Select Save to save the flow.

Create a solution and add the flow

For the bot to find and connect to the flow, the flow must be included in a Power Automate solution.

  1. While still in the Power Automate portal, select Solutions from the left-side navigation.

  2. Select + New solution.

  3. Enter a display name. The list of solutions includes every solution in your organization or school. Choose a naming convention that helps you filter to just your solutions. For example, you might prefix your email to your solution name: jondoe-power-virtual-agent-qnamaker-fallback.

  4. Select your publisher from the list of choices.

  5. Accept the default values for the name and version.

  6. Select Create to finish the process.

Add your flow to the solution

  1. In the list of solutions, select the solution you just created. It should be at the top of the list. If it isn't, search by your email name, which is part of the solution name.

  2. In the solution, select + Add existing, and then select Flow from the list.

  3. Find your flow from the Outside solutions list, and then select Add to finish the process. If there are many flows, look at the Modified column to find the most recent flow.

Add your solution's flow to Power Virtual Agents

  1. Return to the browser tab with your bot in Power Virtual Agents. The authoring canvas should still be open.

  2. To insert a new step in the flow, above the Message action box, select the plus (+) icon. Then select Call an action.

  3. From the Flow pop-up window, select the new flow named Generate answers using QnA Maker knowledge base.... The new action appears in the flow.

    Partial Screenshot of Power Virtual Agent topic conversation canvas after adding QnA Maker flow.

  4. To correctly set the input variable to the QnA Maker action, select Select a variable, then select bot.UnrecognizedTriggerPhrase.

    Partial Screenshot of Power Virtual Agent topic conversation canvas selecting input variable.

  5. To correctly set the output variable to the QnA Maker action, in the Message action, select UnrecognizedTriggerPhrase, then select the icon to insert a variable, {x}, then select FinalAnswer.

  6. From the context toolbar, select Save, to save the authoring canvas details for the topic.

Here's what the final bot canvas looks like.

Screenshot shows the final agent canvas with Trigger Phrases, Action, and then Message sections.

Test the bot

As you design your bot in Power Virtual Agents, you can use the Test bot pane to see how the bot leads a customer through the bot conversation.

  1. In the test pane, toggle Track between topics. This allows you to watch the progression between topics, as well as within a single topic.

  2. Test the bot by entering the user text in the following order. The authoring canvas reports the successful steps with a green check mark.

    Question order Test questions Purpose
    1 Hello Begin conversation
    2 Store hours Sample topic. This is configured for you without any additional work on your part.
    3 Yes In reply to Did that answer your question?
    4 Excellent In reply to Please rate your experience.
    5 Yes In reply to Can I help with anything else?
    6 How can I improve the throughput performance for query predictions? This question triggers the fallback action, which sends the text to your knowledge base to answer. Then the answer is shown. the green check marks for the individual actions indicate success for each action.

    Screenshot of chat bot with canvas indicating green checkmarks for successful actions.

Publish your bot

To make the bot available to all members of your school or organization, you need to publish it.

Publish your bot by following the steps in Publish your bot.

Share your bot

To make your bot available to others, you first need to publish it to a channel. For this tutorial we'll use the demo website.

Configure the demo website by following the steps in Configure a chatbot for a live or demo website.

Then you can share your website URL with your school or organization members.

Clean up resources

When you are done with the knowledge base, remove the QnA Maker resources in the Azure portal.

Next step

Get analytics on your knowledge base

Learn more about: