# Improving Your Bot with Unhandled Phrases

## Introduction

Managing unhandled phrases allows you to quickly view common phrases asked by the users that the VA could not confidently answer. It allows you to manage previous conversation data to resolve these unhandled phrases by either creating new intent or assigning the phrases to an existing intent.

In addition, you can group these phrases that are similar so it can be processed as a batch. These phrases are sorted by the system based on the total frequency of occurrences.

You can mark a phrase as invalid for those out of scope or spam user inputs. Furthermore, you can undo or revert invalid phrases back to unhandled for further verification.

In the Unhandled Phrases Manager, phrases are categorised into three categories:

1. Unhandled – Phrases that the bot was unable to handle
2. Resolved – Previously unhandled phrases that has been assigned to an intent
3. Invalid – Previously unhandled phrases deemed to be invalid

The manager also displays the number of times each category of phrases appeared in conversations.

There are 2 main steps to process unhandled phrases.

1. Identifying and “marking” invalid Unhandled Phrases
2. Identifying valid Unhanded Phrases and resolving them

## Step 1: Mark Invalid Unhandled Phrases

To begin processing unhandled phrases, it is important to first identify and “mark” and invalid phrases. Phrases are considered Invalid if any of the following is being identified:

* Phrase is a single term OR could mean many things (vague phrasing leads to errors and lower accuracy). For example, “want to go”, the bot responds “that’s kind of vague…can you please rephrase?”.
* There is a spelling error in the phrase. Do not teach the system with broken spelling, unless it is a common spelling error.
* There is more than one intention in the phrase (Multiple intents = vague!).
* It is not phrased as a question. For example, feedback from the user.

### Marking Phrases as Invalid

1. Navigate to the Unhandled Phrases tab. A list of all unhandled phrases for the selected bot will be displayed.
2. For each phrase, you will be able to view each conversation log by selecting the phrase. The conversation log will allow you to review the context of conversation which led to the unhandled phrase.
3. You can also see the number of times each unhandled phrase appeared in conversations.

![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr02nZctzzUJoSR%2F117.png?generation=1602575515346867\&alt=media)

1. Click the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr15S8sdTcwrtn7%2F118.png?generation=1602575514929722\&alt=media)button. Upon clicking, the system will attempt to group the unhandled phrases together based on their meaning.
2. Once the intents are grouped, toggle the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr2TgvnCr5UN4w7%2F119.png?generation=1602575514966801\&alt=media) switch to **ON**. The checkboxes for the intents and their parent group will turn red.
3. Start “marking” invalid intents by checking the checkboxes. ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr3Vc8L9EOHsQYZ%2F120.png?generation=1602575515329057\&alt=media)
4. To confirm “marking”, click on the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr4ejtJ1OD5RfIK%2F121.png?generation=1602575514933964\&alt=media) button. A pop-up window will be displayed asking for confirmation. Select **Yes** to confirm “marking”.
5. Toggle the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr5DM1Z8DLbuXKE%2F122.png?generation=1602575514942780\&alt=media) switch to OFF.

### Viewing Invalid Phrases

To view invalid phrases, select the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr6dQ0oCisgHpg6%2F123.png?generation=1602575514940170\&alt=media) phrases tab on the left hand panel of the unhandled phrases manager. All phrases marked as invalid will be displayed. For invalid phrases, you will be able to:

1. View each conversation log by selecting ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr7JbLY4sVxnIBU%2F124.png?generation=1602575514942849\&alt=media). The conversation log will allow you to review the context of conversation which led to the unhandled phrase.
2. Revert invalid phrases to become “unmarked”.

### Reverting Invalid Phrases

To revert previously resolved unhandled phrases:

1. Under the Actions column for the selected phrase, click the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr81kwIAUbYIh9F%2F125.png?generation=1602575514939949\&alt=media) button.
2. A pop-up window will appear asking for confirmation of reversion for the selected phrase.

## Step 2: Identify and Resolve Valid Unhandled Phrases

Now that you have removed the invalid phrases, the next step will be to teach the system to understand the remaining phrases by **Resolving** them.

### Selecting Phrases with the same Intents for Resolving

As multiple Unhandled Phrases can have the same meaning, they should be resolved to the same Intent.

1. Select the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIr9K8kL7jBujl6N%2F126.png?generation=1602575514935171\&alt=media) phrases tab on the left hand panel of the unhandled phrases manager.
2. For each group of unhandled phrases, select the unhandled phrases with the same intent by checking the Blue Checkboxes of each phrase. You can also select all phrases at once by clicking on the first checkbox.
3. Repeat **Step 2** for each group of unhandled phrases.

![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrA9ajzJHXb2D6z%2F127.png?generation=1602575515325687\&alt=media)

####

### Resolving by Adding to Existing Intent

To resolve the selected unhandled phrases within each group, select the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrB-Og15UrrgB5J%2F128.png?generation=1602575514936103\&alt=media)button on the top-right corner of the group. A pop-up window is displayed with the following sections:

1. Phrase(s) Involved – This section displays the list of phrases that you selected and want to resolve.
2. How to Resolve? – This section allows you to select the method you wish to resolve the selected unhandled phrases with.

![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrCN6zPOHAByAqm%2F129.png?generation=1602575515330890\&alt=media)

The **Add phrase to existing intent** option will be selected by default. For this option, the system will suggest a list of existing intents segregated into 3 categories to choose from.&#x20;

* Suggested by AI – This intent is suggested by the system (AI engine).
* Suggested both by User & AI – This intent is suggested by the system based on user feedback.
* Manually searching for a suitable intent.

For phrases with no suitable existing intent, you will need to _Resolve by Creating New Intent_ (see next section)

For each listed intent, you can view and edit the intent details by clicking ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrDdd70AT2DZRZO%2F130.png?generation=1602575514934653\&alt=media).

**To resolve phrases with this method,**

1. Select one from the suggested intents or search for an intent by name. If there is no suitable existing intent, skip this step and click Create new intent for this phrase.
2. Click the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrE2Ntwvzde6G4y%2F131.png?generation=1602575514933190\&alt=media) button. Once done, the resolved unhandled phrases will be moved to the Resolved section.

### Resolving by Creating New Intent

To resolve phrases with this method,

1. Select the **Create new intent for this phrase** option.
2. Add a name for the new intent.
3. Select a library.
4. Click the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrGzXM2_57L4MgU%2F133.png?generation=1602575514976877\&alt=media) button. Once done, the resolved phrase is immediately added to the newly created intent and taught to the bot. These phrases will then be moved to the Resolved section.

### Viewing Previously Resolved Phrases

To view previously resolved phrases, select the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrHMWYeHhExQh6q%2F134.png?generation=1602575514936129\&alt=media) tab on the left hand panel of the unhandled phrases manager. All resolved phrases will be displayed and you will be able to:

1. View each conversation log by selecting ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrI-Pk8t6GNl_6P%2F135.png?generation=1602575514935347\&alt=media). The conversation log will allow you to review the context of conversation which led to the unhandled phrase.
2. Revert resolved phrases.

### Reverting Previously Resolved Phrases

To revert previously resolved unhandled phrases:

1. Under the Actions column for the selected phrase, click the ![](https://1141356578-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Ftaiger-converse%2F-MJVuHz_bCDmA218kKwc%2F-MJVwIrJjtLsPidu0eV-%2F136.png?generation=1602575514934656\&alt=media) button.
2. A pop-up window will appear asking for confirmation of reversion for the selected phrase.
