Skip to content

Commit de27d08

Browse files
committed
grey border
1 parent 7597f7f commit de27d08

File tree

1 file changed

+41
-21
lines changed

1 file changed

+41
-21
lines changed

articles/cognitive-services/QnAMaker/How-To/integrate-with-power-virtual-assistant-fallback-topic.md

Lines changed: 41 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Integrate Power Virtual Agent - QnA Maker
33
description: Improve the quality of your knowledge base with active learning. Review, accept or reject, add without removing or changing existing questions.
44
ms.topic: conceptual
5-
ms.date: 03/09/2020
5+
ms.date: 03/11/2020
66
---
77

88
# How to add a QnA Maker knowledge base to Power Virtual Agent
@@ -59,11 +59,13 @@ The first step is to configure an agent topic. While it can be any topic, this p
5959

6060
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**.
6161

62-
![Power Virtual agent menu item for System Fallback](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-settings-system-fallback.png)
62+
> [!div class="mx-imgBorder"]
63+
> ![Power Virtual agent menu item for System Fallback](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-settings-system-fallback.png)
6364
6465
1. On the pop-up **Settings** window, select **+ Add** to add a System Fallback topic.
6566

66-
![On Settings window, add fallback topic.](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-settings-add-fallback-topic.png)
67+
> [!div class="mx-imgBorder"]
68+
> ![On Settings window, add fallback topic.](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-settings-add-fallback-topic.png)
6769
6870
1. After the topic is added, select **Go to Fallback topic** to author the Fallback topic on the authoring canvas.
6971

@@ -76,15 +78,18 @@ Use the Power Virtual Agent's authoring canvas to connect the Fallback topic to
7678

7779
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`.
7880

79-
![Start fallback action with trigger phrases](../media/how-to-integrate-power-virtual-agent/fallback-action-start-trigger-phrases.png)
81+
> [!div class="mx-imgBorder"]
82+
> ![Start fallback action with trigger phrases](../media/how-to-integrate-power-virtual-agent/fallback-action-start-trigger-phrases.png)
8083
8184
1. Select the **+** connector flowing from the **Trigger Phrases** box, then select **Call an action**.
8285

83-
![Call an action](../media/how-to-integrate-power-virtual-agent/create-new-item-call-an-action.png)
86+
> [!div class="mx-imgBorder"]
87+
> ![Call an action](../media/how-to-integrate-power-virtual-agent/create-new-item-call-an-action.png)
8488
8589
1. Select **Create a flow**. The process takes you to **Power Automate**, a different browser-based portal.
8690

87-
![Call an action](../media/how-to-integrate-power-virtual-agent/create-a-flow.png)
91+
> [!div class="mx-imgBorder"]
92+
> ![Call an action](../media/how-to-integrate-power-virtual-agent/create-a-flow.png)
8893
8994
## Create Power Automate Flow to connect to your knowledge base
9095

@@ -96,25 +101,30 @@ The following procedure creates an action that:
96101

97102
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.
98103

99-
![Configure your input variable as a text string](../media/how-to-integrate-power-virtual-agent/power-automate-configure-input-variable.png)
104+
> [!div class="mx-imgBorder"]
105+
> ![Configure your input variable as a text string](../media/how-to-integrate-power-virtual-agent/power-automate-configure-input-variable.png)
100106
101107
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.
102108

103-
![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)
109+
> [!div class="mx-imgBorder"]
110+
> ![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)
104111
105112
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**.
106113

107114
1. Search for `Qna` to find the **QnA Maker** actions, then select **Generate answer**.
108115

109-
![Search for `Qna` to find the **QnA Maker** actions, then select **Generate answer**](../media/how-to-integrate-power-virtual-agent/generate-answer-action-selected.png)
116+
> [!div class="mx-imgBorder"]
117+
> ![Search for `Qna` to find the **QnA Maker** actions, then select **Generate answer**](../media/how-to-integrate-power-virtual-agent/generate-answer-action-selected.png)
110118
111119
The connections settings for QnA Maker appear in the action.
112120

113-
![The connections settings for QnA Maker appear in the action.](../media/how-to-integrate-power-virtual-agent/generate-answer-knowledge-base-settings.png)
121+
> [!div class="mx-imgBorder"]
122+
> ![The connections settings for QnA Maker appear in the action.](../media/how-to-integrate-power-virtual-agent/generate-answer-knowledge-base-settings.png)
114123
115124
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.
116125

117-
![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)
126+
> [!div class="mx-imgBorder"]
127+
> ![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)
118128
119129
1. To configure the **Question**, select the text box, then select the `InputText` from the list.
120130

@@ -124,7 +134,8 @@ The following procedure creates an action that:
124134

125135
Set the name of the variable to `OutgoingQnAAnswer`, and select the type as **String**. Don't set the **Value**.
126136

127-
![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)
137+
> [!div class="mx-imgBorder"]
138+
> ![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)
128139
129140
1. Select the **+** connector flowing from the **Initialize variable** action box to insert a new step in the flow, then select **Add an action**.
130141

@@ -136,11 +147,13 @@ The following procedure creates an action that:
136147

137148
Select the text box for **Value**, then select **Answers Answer** from the list.
138149

139-
![Set the name and value for the variable ](../media/how-to-integrate-power-virtual-agent/power-automate-flow-apply-to-each-set-variable.png)
150+
> [!div class="mx-imgBorder"]
151+
> ![Set the name and value for the variable ](../media/how-to-integrate-power-virtual-agent/power-automate-flow-apply-to-each-set-variable.png)
140152
141153
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.
142154

143-
![Set the return value](../media/how-to-integrate-power-virtual-agent/power-automate-flow-return-value.png)
155+
> [!div class="mx-imgBorder"]
156+
> ![Set the return value](../media/how-to-integrate-power-virtual-agent/power-automate-flow-return-value.png)
144157
145158
1. Select **Save** to save the Flow.
146159

@@ -152,45 +165,52 @@ In order for the Power Virtual Agent to find and connect to the flow, the flow m
152165

153166
1. Select **+ New solution** and configure the solution. Select **Create** to finish the process.
154167

155-
![Create new solution](../media/how-to-integrate-power-virtual-agent/power-automate-create-new-solution.png)
168+
> [!div class="mx-imgBorder"]
169+
> ![Create new solution](../media/how-to-integrate-power-virtual-agent/power-automate-create-new-solution.png)
156170
157171
1. In the list of solutions, select the solution you just created. It should be at the top of the list.
158172

159173
1. In the solution, select **+ Add existing**, then select **Flow** from the list.
160174

161175
1. Select the **Outside solutions** tab, then select the flow you just created. Select **Add** to finish the process.
162176

163-
![Add flow to solution](../media/how-to-integrate-power-virtual-agent/power-automate-add-flow-to-solution.png)
177+
> [!div class="mx-imgBorder"]
178+
> ![Add flow to solution](../media/how-to-integrate-power-virtual-agent/power-automate-add-flow-to-solution.png)
164179
165180
## Add solution's flow to Power Virtual Agent
166181

167182
1. Return to the browser tab with your Power Virtual Agent. The authoring canvas should still be open.
168183

169184
1. Select the **+** connector under the **Trigger Phrases** action box to insert a new step in the flow, then select **Call an action**.
170185

171-
![Call an action from the authoring canvas](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-topic-authoring-canvas-call-an-action.png)
186+
> [!div class="mx-imgBorder"]
187+
> ![Call an action from the authoring canvas](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-topic-authoring-canvas-call-an-action.png)
172188
173189
1. In the new action, select the input value of **UnrecognizedTriggerPhrase**.
174190

175-
![In the new action, select the input value of **UnrecognizedTriggerPhrase**.](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-select-unrecognized-trigger-phrase.png)
191+
> [!div class="mx-imgBorder"]
192+
> ![In the new action, select the input value of **UnrecognizedTriggerPhrase**.](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-select-unrecognized-trigger-phrase.png)
176193
177194
1. Select the **+** connector under the **Action** box to insert a new step in the flow, then select **Show a message**.
178195

179196
1. Enter the message text and the `FinalAnswer` from the Power Automate Flow.
180197

181-
![Enter the message text and the `FinalAnswer` from the Power Automate Flow.](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-topic-authoring-canvas-show-message-final-answer.png)
198+
> [!div class="mx-imgBorder"]
199+
> ![Enter the message text and the `FinalAnswer` from the Power Automate Flow.](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-topic-authoring-canvas-show-message-final-answer.png)
182200
183201
1. Select **Save** from the context toolbar to save the authoring canvas details for the topic.
184202

185203
The final canvas is shown below.
186204

187-
![Final agent canvas](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-topic-authoring-canvas-full-flow.png)
205+
> [!div class="mx-imgBorder"]
206+
> ![Final agent canvas](../media/how-to-integrate-power-virtual-agent/power-virtual-agent-topic-authoring-canvas-full-flow.png)
188207
189208
## Test Power Virtual Agent
190209

191210
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.
192211

193-
[![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)
212+
> [!div class="mx-imgBorder"]
213+
> [![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)
194214
195215
## Next step
196216

0 commit comments

Comments
 (0)