edits

diberry · diberry · commit 7597f7f51656 · 2020-03-11T08:44:02.000-07:00
diff --git a/articles/cognitive-services/QnAMaker/How-To/integrate-with-power-virtual-assistant-fallback-topic.md b/articles/cognitive-services/QnAMaker/How-To/integrate-with-power-virtual-assistant-fallback-topic.md
@@ -5,9 +5,9 @@ ms.topic: conceptual
 ms.date: 03/09/2020
 ---
 
-# How to add a QnA Maker knowledge base to Power Virtual Agent as the fallback action
+# How to add a QnA Maker knowledge base to Power Virtual Agent
 
-Extend your [Power Virtual Agent](https://powervirtualagents.microsoft.com/) bot to provide the bot's fallback answer from your knowledge base. Use Power Automate to send the user's question to your knowledge base, and receive the knowledge base answer. Configure your bot's fallback action as part of your conversation flow from within the Power portal.
+Extend your [Power Virtual Agent](https://powervirtualagents.microsoft.com/) bot to provide answers from your knowledge base. You can configure your bot topic _conversation path_ to send the user's text, as the _trigger phrase_, to your knowledge base, then return the answer to your user shown in a message.
 
 ## Use QnA Maker knowledge base with a Power Virtual Agent
 
@@ -17,25 +17,30 @@ QnA Maker is a cloud-based API service that lets you create a conversational que
 
 A Power Virtual Agent is created with a series of topics (subject areas), in order to answer user questions by performing actions. If an answer can't be found, a system fallback can return an answer.
 
-You can send the question to your knowledge base as part of a topic's action or as the fallback action. They both use the same mechanism (action) to connect to your knowledge base and return an answer.
+You can send the question to your knowledge base as part of a topic's action or as part of the System Fallback topic path. They both use the same mechanism of an action to connect to your knowledge base and return an answer.
 
 ## Power Automate connects to GenerateAnswer action
 
-To connect your agent to your knowledge base, use Power Automate. Power Automate provides a process **flow, which connects to QnA Maker's GenerateAnswer API.
+To connect your agent to your knowledge base, use Power Automate to create the action. Power Automate provides a process **flow**, which connects to QnA Maker's GenerateAnswer API.
 
 Once the **flow** is designed and saved, it is available from a Power Automate **Solution**.  Once the GenerateAnswer flow is added to a solution, use that solution as an action in your agent.
 
 ## Process steps to connect an agent to your knowledge base
+
 Steps to use a Power Virtual agent with QnA Maker:
-* In QnA Maker portal
+* In [QnA Maker](https://www.qnamaker.ai/) portal
     * Build and publish knowledge base
-    * Copy knowledge base details
-* In Power Virtual Agent
+    * Copy knowledge base details including knowledge base ID, runtime endpoint key, and runtime endpoint host.
+* In [Power Virtual Agent](https://powerva.microsoft.com/) portal
     * Build agent topic
     * Call an action (to Power Automate Flow)
-* In Power Automate
-    * Build a flow with connector to QnA
-    Maker's GenerateAnswer
+* In [Power Automate](https://us.flow.microsoft.com/) portal
+    * Build a flow with connector to [QnA
+    Maker's GenerateAnswer](https://docs.microsoft.com/connectors/cognitiveservicesqnamaker/)
+        * QnA Maker published knowledge base information
+            * Knowledge base ID
+            * QnA Maker resource endpoint host
+            * QnA Maker resource endpoint key
         * Input - user query
         * Output - knowledge base answer
     * Create solution and add flow
@@ -46,36 +51,34 @@ Steps to use a Power Virtual agent with QnA Maker:
 
 Before you build your agent, create and publish your knowledge base. Next, find the endpoint key, endpoint host, and knowledge base ID 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.
+You will need this information for the [Power Automate step](#create-power-automate-flow-to-connect-to-your-knowledge-base) to configure your QnA Maker GenerateAnswer connection.
 
 ## Create Power Virtual Agent's System fallback topic
 
-The first step is to configure an agent topic. While it can be any topic, this procedure uses the System **fallback** topic. If the agent can't find an answer, it should pass the answer to QnA Maker's GenerateAnswer API.
-
-1. In the [Power Virtual Agents](https://powerva.microsoft.com/#/) portal, on the top-right corner of the navigation, select the **Settings** page. The icon for this page is the gear.
+The first step is to configure an agent topic. While it can be any topic, this procedure uses the System **Fallback** topic. If the agent can't find an answer, it should pass the answer to QnA Maker's GenerateAnswer API.
 
-1. Select **System Fallback**.
+1. In the [Power Virtual Agents](https://powerva.microsoft.com/#/) portal, on the top-right corner of the navigation, select the **Settings** page. The icon for this page is the gear. Select **System Fallback**.
 
     ![Power Virtual agent menu item for System Fallback](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-settings-system-fallback.png)
 
-1. On the pop-up **Settings** window, select **+ Add** to add a System fallback topic to your default list of topics.
+1. On the pop-up **Settings** window, select **+ Add** to add a System Fallback topic.
 
     ![On Settings window, add fallback topic.](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-settings-add-fallback-topic.png)
 
-1. After the topic is added, select the button  **Go to fallback topic** to author the fallback topic on the authoring canvas.
+1. After the topic is added, select **Go to Fallback topic** to author the Fallback topic on the authoring canvas.
 
     > [!TIP]
-    > If you need to return to the fallback topic, the fallback topic is under **Topics** section, as part of the **System** topics.
+    > If you need to return to the Fallback topic, it is available in the **Topics** section, as part of the **System** topics.
 
 ## Use authoring canvas to add an action
 
-Use the Power Virtual agent's authoring canvas to connect the fallback topic to your knowledge base. The topic starts with the **unrecognized user text**. You need to add an action that passes that text to QnA Maker, then displays the answer as a message. The last step of displaying an answer is handled as a separate step later.
+Use the Power Virtual Agent's authoring canvas to connect the Fallback topic to your knowledge base. The topic starts with the **unrecognized user text**. You need to add an action that passes that text to QnA Maker, then shows the answer as a message. The last step of displaying an answer is handled as a separate step later.
 
-1. The new fallback action may already have a flow designed. Delete all items in the flow except for the first item, **Trigger Phrases**, with the `Unrecognized user input`.
+1. The new Fallback action may already have conversation flow elements. Delete all items in the flow except for the first item, **Trigger Phrases**, with the `Unrecognized user input`.
 
     ![Start fallback action with trigger phrases](../media/how-to-integrate-power-virtual-agent/fallback-action-start-trigger-phrases.png)
 
-1. Select the **+** connector under the **Trigger Phrases** box, then select **Call an action**.
+1. Select the **+** connector flowing from the **Trigger Phrases** box, then select **Call an action**.
 
     ![Call an action](../media/how-to-integrate-power-virtual-agent/create-new-item-call-an-action.png)
 
@@ -85,15 +88,21 @@ Use the Power Virtual agent's authoring canvas to connect the fallback topic to
 
 ## Create Power Automate Flow to connect to your knowledge base
 
-1. In **Power Automate**, the **Flow Template** is started. On the **Power Virtual agents** item, select **Edit** to configure the input variable coming from your agent to your knowledge base. The text-based input variable is the user-submitted text question from your agent.
+The following procedure creates an action that:
+* takes the incoming user text
+* sends it to QnA Maker
+* assigns the QnA Maker response to a variable
+* sends only the top answer as the response back to your agent
+
+1. In **Power Automate**, the **Flow Template** is started. On the **Power Virtual Agents** item, select **Edit** to configure the input variable coming from your agent to your knowledge base. The text-based input variable is the user-submitted text question from your agent.
 
     ![Configure your input variable as a text string](../media/how-to-integrate-power-virtual-agent/power-automate-configure-input-variable.png)
 
-1. Add a text input and name the variable `InputText` with a description of `IncomingUserQuestion`.
+1. Add a text input and name the variable `InputText` with a description of `IncomingUserQuestion`. This naming helps distinguish the input text from the output text you create later.
 
     ![Add a text input and name the variable `InputText` with a description of `UserQuestion`](../media/how-to-integrate-power-virtual-agent/power-automate-configure-input-variable-name-and-description.png)
 
-1. Select the **+** connector under the **Power Virtual Agents** box, to insert a new step in the flow (before the **Return value(s) to Power Virtual Agent**), then select **Add an action**.
+1. Select the **+** connector flowing from the **Power Virtual Agents** box, to insert a new step in the flow (before the **Return value(s) to Power Virtual Agent**), then select **Add an action**.
 
 1. Search for `Qna` to find the **QnA Maker** actions, then select **Generate answer**.
 
@@ -103,35 +112,33 @@ Use the Power Virtual agent's authoring canvas to connect the fallback topic to
 
     ![The connections settings for QnA Maker appear in the action.](../media/how-to-integrate-power-virtual-agent/generate-answer-knowledge-base-settings.png)
 
-1. Configures the action to take the InputText, and pass it to the GenerateAnswer API.
-
-    Enter your published knowledge base settings found on the **Settings** page in the [QnA Maker](https://www.qnamaker.ai/) portal.
+1. Configure the action with your knowledge base ID, endpoint host and endpoint key. These are found on the **Settings** page of your knowledge base, in the QnA Maker portal.
 
     ![Enter your published knowledge base settings found on the **Settings** page in the [QnA Maker](https://www.qnamaker.ai/) portal.](../media/how-to-integrate-power-virtual-agent/published-knowledge-base-settings.png)
 
-   Select the **Question** text area. This displays a list of choices. Select `InputText`.
+1. To configure the **Question**, select the text box, then select the  `InputText` from the list.
 
-1. Select the **+** connector under the **Generate answer** action box to insert a new step in the flow, then select **Add an action**.
+1. Select the **+** connector flowing from the **Generate answer** action box to insert a new step in the flow, then select **Add an action**.
 
-1. To add a variable to capture the answer text returned from GenerateAnswer, search for and select the`Initialize variable` action.
+1. To add a variable to capture the answer text returned from GenerateAnswer, search for and select the `Initialize variable` action.
 
-    Set the name of the variable to `OutgoingQnAAnswer`, and select the type as **String**.
+    Set the name of the variable to `OutgoingQnAAnswer`, and select the type as **String**. Don't set the **Value**.
 
     ![Set the name of the variable to `QnAAnswer`, and select the type as **String**](../media/how-to-integrate-power-virtual-agent/initialize-output-variable-for-qna-answer.png)
 
-1. Select the **+** connector under the **Initialize variable** action box to insert a new step in the flow, then select **Add an action**.
+1. Select the **+** connector flowing from the **Initialize variable** action box to insert a new step in the flow, then select **Add an action**.
 
 1. To set the knowledge base answer to the variable, search for and select the`Apply to each` action.
 
     Select the GenerateAnswer `answers`, which is the entire JSON from the GenerateAnswer API call. In the same **Apply to each** box, select **Add an action**. This subsequent action gets only the top answer and sets that to the variable.
 
-1. In the **Set variable** box, select the text box for name, then select **OutgoingQnAAnswer** from the list.
+1. In the **Set variable** box, select the text box for **Name**, then select **OutgoingQnAAnswer** from the list.
 
-    Select the text box for value, then select **Answers Answer** from the list.
+    Select the text box for **Value**, then select **Answers Answer** from the list.
 
     ![Set the name and value for the variable ](../media/how-to-integrate-power-virtual-agent/power-automate-flow-apply-to-each-set-variable.png)
 
-1. To return the variable (and its value), select the **Return value(s) to Power Virtual Agent** then select **Add an output**. Select a **Text** output type then select a **Title** you will see in the Power Virtual Agent, such as `FinalAnswer`. Select the text box for the value, then select the `OutgoingQnAAnswer` variable.
+1. To return the variable (and its value), select the **Return value(s) to Power Virtual Agent** then select **Add an output**. Select a **Text** output type then enter the **Title** of `FinalAnswer`. Select the text box for the **Value**, then select the `OutgoingQnAAnswer` variable.
 
     ![Set the return value](../media/how-to-integrate-power-virtual-agent/power-automate-flow-return-value.png)
 
@@ -147,17 +154,17 @@ In order for the Power Virtual Agent to find and connect to the flow, the flow m
 
     ![Create new solution](../media/how-to-integrate-power-virtual-agent/power-automate-create-new-solution.png)
 
-1. In the list of solutions, select the solution you just created.
+1. In the list of solutions, select the solution you just created. It should be at the top of the list.
 
 1. In the solution, select **+ Add existing**, then select **Flow** from the list.
 
 1. Select the **Outside solutions** tab, then select the flow you just created. Select **Add** to finish the process.
 
-![Add flow to solution](../media/how-to-integrate-power-virtual-agent/power-automate-add-flow-to-solution.png)
+    ![Add flow to solution](../media/how-to-integrate-power-virtual-agent/power-automate-add-flow-to-solution.png)
 
 ## Add solution's flow to Power Virtual Agent
 
-1. Return to the browser tab with your Power Virtual agent. The authoring canvas should still be open.
+1. Return to the browser tab with your Power Virtual Agent. The authoring canvas should still be open.
 
 1. Select the **+** connector under the **Trigger Phrases** action box to insert a new step in the flow, then select **Call an action**.
 
@@ -181,10 +188,15 @@ The final canvas is shown below.
 
 ## Test Power Virtual Agent
 
-Test the agent by typing in a question that your knowledge base can answer. The authoring canvas reports the successful steps with a green checkmark.
+Test the agent by typing in a question that your knowledge base can answer. The authoring canvas reports the successful steps with a green check mark.
 
 [![Test you Power Virtual Agent with a query meant for your knowledge base.](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-test.png)](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-test.png#lightbox)
 
 ## Next step
 
-[Get analytics on your knowledge base](get-analytics-knowledge-base.md)
+[Get analytics on your knowledge base](get-analytics-knowledge-base.md)
+
+Learn more about:
+* [Power Virtual Agents](https://docs.microsoft.com/power-virtual-agents/)
+* [Power Automate](https://docs.microsoft.com/power-automate/)
+* [QnA Maker connector](https://us.flow.microsoft.com/connectors/shared_cognitiveservicesqnamaker/qna-maker/) and the [settings for the connector](https://docs.microsoft.com/connectors/cognitiveservicesqnamaker/)
