Create topics from existing online support content

مقالة
04/04/2022
قراءة خلال 6 دقائق

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

You can use content from existing webpages when creating a Power Virtual Agents bot. This is useful if you already have help or support content, such as FAQ pages or support sites.

Rather than copying and pasting or manually re-creating this content, you can use AI-assisted authoring to automatically extract and insert relevant content from existing online resources into your bot.

The underlying capability identifies the structure and content on a webpage or online file, isolates content blocks that pertain to a support issue or question, and then classifies them into topics with corresponding Trigger phrase and Message nodes for each topic.

There are three main steps to using the feature:

Select Suggest topics on the Topics page to extract content from FAQ/support pages or online files.
Add the suggested topics to your bot.
Enable the topics.

You can test the topics in the test chat, but you'll need to publish your bot for customers to see the latest changes.

Prerequisites

Learn more about what you can do with Power Virtual Agents.

Extract content from webpages or online files

First, you'll need to point to the webpages or online files from which you want to extract content.

After the extraction is complete, you'll be shown the suggested topics for further review. Suggested topics aren't automatically added to your bot, but you can easily add them.

Important

The Suggest topics command is built to run on online FAQ or support content. Other types of content with a different structure might not work as expected.

Select Topics on the side pane.
Go to the Suggested tab.
If it's the first time you're getting suggestions, the list of suggested topics will be blank. A link to Get started or Learn more appears instead.
Select Get started or Suggest topics.
Enter links to each webpage or online file from which you want to extract content, and then select Add. If you add a link by mistake, you can remove it by selecting Delete .
Important
- The URLs must be secure (they must start with https://).
- The URLs must be publicly available, that is, they can't need a user to log in.
- For online files, we do not support file upload. You must provide the full URL to the location of the file, including the file extension, as in the example https://www.microsoft.com/thisisafile.pdf.
- For online files, we currently support PDF, DOCX, PPTX, TXT files and 2-column formats in TSV, XLSX (first sheet only), and CSV. The file extension must be included in the URL.
When you're done adding links to webpages and/or online files, select Start. The process can take several minutes, depending on the complexity and number of webpages or files you added. The message "Getting your suggestions. This may take several minutes" appears at the top of the screen while the extraction is in progress.

Tip

You can add multiple webpages and links to online files, but we recommend that you include only a few at a time to keep the list of suggestions manageable.

Important

You won't be able to add more URLs while the Suggest topics command is running.

The tool provides explicit feedback about errors so that you can understand and address any issues. For example, you might be unable to extract content because the site you're referencing is down or it may be gated behind a user login, such as a SharePoint page.

A red banner alert that says We ran into problems getting suggestions appears at the top of the page with a link to more details.

A pop-up window that describes the errors encountered when trying to get suggestions from a web page.

After you've successfully extracted content, a number of suggestions will appear. These may be either single-turn or multi-turn topics. You can now review these suggestions to see which ones you want to add to your bot.

The Suggested tab on the Topics page lists each topic by name, trigger phrase, source, and date it was received.

Single-turn and multi-turn topic suggestions

When Power Virtual Agents extracts content, it generates single-turn or multi-turn topic suggestions, based on the structure of the document.

A single-turn topic has a trigger phrase that contains a single answer. Topics such as these are typically generated if your online content has simple "question-and-answer" pairs, such as an FAQ page.

A multi-turn topic contains multiple bot responses, and is often associated with multiple dialog branches.
It provides a guided experience for your bot's users to navigate through a problem and reach a solution. These topics are typically generated when your online content is similar to a troubleshooting page or a reference manual or guidebook.

The original content's structure or hierarchy (such as headings and subheadings) will contribute to whether a multi-turn or single-turn topic is generated.

A screenshot of the preview for a multi-turn topic suggestion showing multiple branches from the original question.

How the AI creates topic suggestions

The Power Virtual Agents AI engine applies a number of steps to the content when it extracts topics and generates suggestions. These steps utilize AI to identify and parse visual and semantic cues from the content.

Document parsing: the Power Virtual Agents engine identifies and extracts the basic components of the document, such as text and image blocks.
Layout understanding: the document is segmented into different zones that consist of the blocks of content.
Structure understanding: the logical structure of the content is analyzed by determining the "role" of each zone (for example, what is actual content and what are headings). Power Virtual Agents creates a hierarchical map or "heading tree" of the content, based on the headings and their associated content.
Augmentation: the Power Virtual Agents AI engine adds context to the tree by analyzing how the headings relate to each other and their content. At this point, it generates single-turn topics from identified simple "question-and-answer" pairs of headings and content.
Dialog generation: multi-turn topics are generated from the augmented knowledge tree, depending on whether the topic's intent is a simple answer from a group of many, or if the topic has multiple solutions that are equally different, and are chosen based on a user's input or choices.

Add suggested topics to an existing bot

After the extraction process has been completed, the topic suggestions appear on the Suggested tab. Review them individually to decide which ones you want to include in your bot. You can also add suggestions without reviewing them.

Select the name of the suggested topic.
Review the trigger phrase and suggested Message node. (Each topic will end with a survey, so your customers can let you know whether they found it helpful.) You have the following three options for dealing with the topic:
1. To make edits to the topic, select Add to topics and edit. The topic will open, where you can edit the trigger phrases or enter the authoring canvas to make changes to the conversation flow. The topic will also be removed from the list of suggestions.
2. To add the suggested topic without making any changes, select Add to topics. The topic is added and saved, but you'll stay on the list of suggested topics. The topic will also be removed from the list of suggested topics.
3. To completely remove the suggestion, select Delete suggestion. The topic will be deleted from the list of suggested topics. You can run the Suggest topics command again if you want to restore it.
In the suggested topics list, hover over the name of the suggested topic you want to add or delete.
1. To add the topic to your bot, select Add to topics . You won't see a preview of the topic and the topic will be moved from the list of Suggested topics into Existing topics.
You can also add or delete multiple topic suggestions at a time. If you select multiple rows, you'll see options to Add to topic or Delete.