Test your Power Virtual Agents bot

Note

There is additional information available for people using Power Virtual Agents (preview).

Select the version of Power Virtual Agents you're using here:

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.

To help you find and fix unexpected behavior, you can enable tracking between topics to take you through the bot conversation step-by-step, and go to the corresponding node in the authoring canvas.

Prerequisites

Test a topic in the Test bot pane

  1. If the Test bot pane is hidden, open it by selecting Test your bot.

    The Test your bot button is at the bottom of the navigation menu.

  2. It's a good idea to select Reset at the top of the Test bot pane to clear previous conversations. Clearing previous conversations makes it easier to see the flow of the topic you want to see without getting confused by previous conversations.

    Click Reset at the top of the Test bot pane to clear conversation history.

  3. At the Type your message prompt at the bottom of the Test bot pane, enter a trigger phrase for the topic.

    The trigger phrase starts the topic's conversation, and the Test bot pane displays the bot responses and user response choices you specified.

  4. Continue the conversation, testing that it flows in the intended as designed in the topic.

  5. Select a response in the Test bot pane, which will take you to the response in the conversation editor for that topic. The authoring canvas displays highlighted nodes in green.

Select any response in the conversation to see the authoring canvas highlighted to that response.

You can return to the authoring canvas for the topic at any time to revise it's conversation path. The Test chat pane will automatically refresh itself when you save changes to a topic.

Track through the topic's conversation path

As you fine-tune your bot, it can be useful to enable tracking between topics so you can follow through the conversation path step by step.

  1. At the top of the Test bot pane, set Track between topics to On.

    Switch the track between topics toggle at the top of th test bot pan.

  2. Enter a trigger phrase for the topic you want to check, and then continue testing the conversation.

  3. As you move through the conversation in the Test bot pane, the authoring canvas highlights the current place in the conversation path. The authoring canvas displays highlighted nodes in green.

  4. To navigate to an earlier place in the conversation path in the authoring canvas, select it in the Test bot pane.

If the conversation path in the Test your bot pane moves from one topic to another topic, the authoring canvas refreshes and moves between topics to the appropriate highlighted nodes.

Save conversation snapshots

While testing your bot in the Test bot pane, you can use the Save snapshot command to get conversational diagnostics data. This data can help you troubleshoot issues, such as the bot not responding in the way you expect.

Warning

The snapshot contains all of your bot content, which may include sensitive information.

  1. At the top of the Test bot pane, select the menu icon (three vertical periods) and then Save snapshot.

    Save snapshot.

  2. In the window that appears, select Save.

    Save snapshot message.

  3. The bot's content and conversational diagnostics will be saved in a .zip archive file called DSAT.zip.

    Conversational diagnostics archive.

  4. The DSAT.zip file contains two files: botContent.json and dialog.json.

    1. dialog.json contains conversational diagnostics, including detailed descriptions of errors.

      Conversational diagnostics file.

    2. botContent.json contains the bot's topics and other content, including entities and variables used in the bot.

Help us improve Power Virtual Agents by flagging issues with the Flag an issue command on the test bot pane. This submits your conversation ID to Microsoft, which is a unique identifier that Microsoft uses to troubleshoot the issue of the conversation. Other information, such as that in the DSAT.zip file, is not sent when you flag an issue.

Flag an issue.

All information collected is anonymous and will be used to help improve bot quality.