communications-mining
latest
false
UiPath logo, featuring letters U and I in white

Communications Mining User Guide

Last updated Nov 27, 2024

Filtering Reports

In Reports you can apply filters to enhance data insights.

Note: This article explains the filters in Communications Mining and how to apply them. To see how to leverage conversational filters (an Autopilot for Communications Mining feature) to turn a natural language query into the correct set of filters automatically, check the Autopilot for Communications Mining - Conversational filters (Preview) page.

Applying filters in Reports

User permissions required: ‘View Sources’ AND ‘View Labels’.

In Reports you can use the filter bar to manipulate the charts and update the summary statistics presented.

The filter bar and adding or removing filters

The filter bar works mostly in the same way as in Explore. The key difference is that in Reports, you can use thread filters for conversational datasets containing threads (including email threads, chats and call transcripts). See below more details on thread filters.

It's important to remember that you can add multiple filters (including multiple metadata fields) in Reports (and Explore), and that all of the filters will determine the messages in scope (as shown by the summary stats at the top of the page).

When selecting which labels to appear in the label-specific charts, use the Charted labels dropdown menu in the top bar on either the Trends or Segments page.

Label filter

The label filter bar in Reports works in the same way as in Explore. For more information and a detailed explanation of the Advanced Prediction filters check Advanced prediction filters.

Note:

The label filters do not determine which labels are actually plotted on the label-specific chart. This is determined by the 'Charted labels' selector. See below for more detail.

Threads filter

At the top of the filter bar, you can toggle between Messages and Threads. This allows you to apply analytics at the level of conversations, instead of individual messages.

The threads filter is applicable for longer-form conversations like email threads, phone calls, and live chats. Once the Threads filter is selected, a fourth reports tab will become available, containing charts relating to thread properties and label volumes.

Message-Threads toggle on the filter bar

Attachment filter

The attachment based properties are available for each message that supports attachments.

These properties include:

  • Has Attachment (Yes/No)
  • Number of attachments
  • Attachment Size (Mb)
  • Total Attachment Size (Mb)
  • Attachment Name Includes - Provides a fuzzy search capability


You can filter and run analytics on messages with specific attachment properties:


Time series filtering

There are two methods for filtering the time series within Reports, using the time series filter in the filter bar, or selecting an area on a time series chart.

This will filter the messages in scope to only the select period, as well as adjust any time series charts to the filtered period.

Using the time series filter in the filter bar is the same as in Explore - simply select a 'From' and/or a 'To', or choose a preset custom range such as 'Last 7 days'.

Time series filter on the filter bar

To select the area on a time series chart:

  1. Select a chart that shows a trend over time
  2. Highlight a time period on the chart by clicking your mouse at the start of the time period you want to filter and drag it to the point in time you want to finish on
  3. This will filter the chart for the specific time period that you highlighted
Example time period filter using the highlight method

Once the chart refreshes, you will see the time period that you selected has automatically been applied to the timestamp in the filter bar. You can see the time period in the summary statistics, at the top of the page.

Chart time sequence

In the Trends tab, you can select which time sequence you want the time series charts to be displayed in using the dropdown menu just below the summary statistics.

This allows you to plot the time series charts as:

  • Daily
  • Weekly
  • Monthly
  • Yearly
Trends tab showing time sequence dropdown menu

Advanced prediction filters

Overview

Advanced prediction filters represent a significant step forward in how the label filters work in both the Explore and Reports pages in the platform.

We've significantly expanded the platform's capability to support intelligent filter combinations on label predictions.

Here are some of the things you can now do when filtering by label predictions:

  • Apply multiple label filters at once, in both Explore and Reports
  • Filter for messages that have one of a number of selected labels predicted (i.e., Label X OR Label Y OR ...)
  • Filter for messages that have multiple different labels predicted (i.e. Label X AND Label Y AND ...)
  • Filter for messages that do not have certain label(s) predicted (i.e. NOT Label Y)
  • Search for messages containing specific search terms, whilst having label filters applied

Essentially, the new filters let you apply any combination of 'AND', 'OR' and 'NOT' when applying more than one label filter. These filters can give you much greater flexibility when training and interpreting your data, and can provide much deeper insights on what's happening in your communication channels.

Impact on model training and filtering charts

As a result of these changes, we've also updated the way you select a label to sort by when training in Explore, and how you select labels to appear in the charts in Reports.

When you filter to a label now in Explore, this no longer determines the training mode or the sort order of the current training mode. Instead this is determined by a taxonomy dropdown menu that appears when you select a training mode that is specific to a certain label (e.g. 'Check label' or 'Missed label').

This is to enable you to be sort by a certain label for a training mode and have an additional label filter applied.

How this works in practice is discussed in more detail further down this article.

Similarly, when you filter to labels in Reports this no longer determines which labels appear in charts. Instead, this also acts exclusively as a filter and the dropdown 'Charted labels' menu determine which labels are shown in the charts. How this works in practice is also discussed in more detail at the end of this article.

Applying advanced prediction filters

There are now two ways to apply label filters, and they can be used in combination with each other to create the right type of query.

Taxonomy Bar

The taxonomy of labels functions as a normal filter bar, and allows you to select multiple labels at once with a single click for each.

Selecting multiple labels from the taxonomy creates an 'OR' type query.

If you selected Label A, Label B and Label C in the taxonomy, this creates a 'Show me messages with Label A, Label B, or Label C predicted' query.

The following example would return messages that contained at least one of the three selected labels:

Combined label filter returning messages containing any one of the three select labels

Add Label Filter

The second filter option is the + Add Label Filter button above the taxonomy bar.

This enables a dropdown taxonomy that allows you to select more complex filters, including excluding certain labels from consideration.

'+ Add Label Filter' dropdown menu

From this dropdown menu, you can select multiple labels that you want to include or exclude, by clicking the plus or minus buttons.

The result would be something like the following example, which would return messages predicted to have the label 'Billing/Refund', but that also do not have the label 'Chaser/Urgent' predicted:

Example label filter combination

You can click + Add Label Filter multiple times to add additional layers to your query. Two separate label filters create an 'AND' type query, whilst multiple labels selected in the same label filter create an 'OR' type query.

In the example below, multiple label filters have been applied individually. This creates a filter that will return messages predicted to have either of the 2 labels in the first filter, but that also have the 'Policy' label predicted, and do not have the 'Quote' label predicted.

An example of complex label query combining 'OR', 'AND' and 'NOT' label filters

A helpful tip is that by clicking the '&' sign in an individual filter containing multiple labels, you can automatically split them out into individual filters. This would change the query from 'OR' (i.e. any of these labels predicted) to 'AND' (i.e. all of these labels predicted).

Combining taxonomy bar filters and added label filters

It's possible to combine filters from both the taxonomy bar, and individually added label filters. Filters applied in the taxonomy bar are treated as an 'AND' query with any individually applied label filters.

Combined label filter using taxonomy bar and individually added label filters

Combining label filters and sorting by label for training

What these new filters also mean, is that you can now apply label filters and sort by a specific label for a training mode.

Explore page showing 'Check label' mode for a specific label, with an additional label exclusion filter applied

Sorting by label for training modes in Explore

To enable the advanced prediction filters, a number of other updates have been made that do change the way you select labels to train in Explore. Overall, these changes make the platform more consistent across the platform, as well as providing greater capabilities to run detailed queries on your data.

The top bar in Explore now shows the selected training mode and sort order in the top left, with the search bar on the top right (see below).

Importantly, when selecting a specific label to train you no longer use the filter bar on the left, but rather you select the training mode first and a taxonomy dropdown then prompts you to select the label you wish to sort by.

The following example shows a user having selected 'Check Label' and then being prompted to select which label to sort by:

Sort order label dropdown showing pinned label counts and label warnings

You can also see that the pinned label counts, red dial indicators, and any performance warnings for a label are also displayed in the taxonomy dropdown, giving you all the information you need to select the right label to sort by.

Once a label is selected, it will be shown next to the training mode alongside the number of pinned examples and any performance warning indicators.

Now, if you select a label from the label filter bar, the platform will prompt you to select it from the sort order dropdown menu if you intend to train the selected label:

Explore page showing warning to use Label sort menu if intending to train selected label

You can see a specific mode in Explore, 'Sentiment', to sort by positive or negative sentiment only (see below). If you want to sort by label(s) and sentiment, you can still do that using the 'Label' sort order and adding a sentiment filter:

Explore page showing 'Sentiment' sort mode

Selecting labels to appear in charts in Reports

The label filters act exclusively as filters to update the messages that are in consideration (much like any other user property filter) by including or removing messages that have or don't have certain labels predicted.

To select which labels actually appear in the charts in the Reports page, there is now a 'Charted labels' dropdown menu in the top bar.

Simply select whichever combination of labels you want to appear and these will be plotted on the charts which distinguish between different labels, as in the example below.

Remember, this does not change the messages that are in consideration by the platform, merely which labels are plotted on the label specific charts. An easy way to remind yourself of this is to note that the total number of messages shown at the top of the page does not change when you select any labels from the 'Charted labels' dropdown.

Updated Reports page with 'Charted labels' selected

All of the labels that you select will appear highlighted at the top of the page as a visual reminder, and can easily be removed by clicking the 'x' icon next to each label name.

Charting specific labels and property values

User permissions required: ‘View Sources’ AND ‘View Labels’.

Charting specific labels

Near the top right of the page on the 'Label Summary', 'Trends', 'Segments', 'Threads', and 'Comparison' page is the 'Chart labels' dropdown option, which you can use to select which labels appear or do not appear in the charts in the Reports page

Simply select whichever combination of labels you want to appear (the plus symbol) and these will be plotted on the charts that distinguish between different labels, as in the example below. Alternatively, you can select labels you don't want to appear by using the exclude button (the minus symbol).

'Chart Labels' button

Including labels within Reports

If you select a number of labels, they will appear in a bar at the top of the page (see below) as a visual indicator of which labels have been selected to appear on the charts.

All of the labels that you select or exclude will appear highlighted at the top of the page as a visual reminder, and can easily be removed by clicking the 'x' icon next to each label name.

Reports page showing 'Charted labels' selected

Note:

This action does not change the messages that are in consideration by the platform, merely which labels are plotted on the label specific charts.

An easy way to remind yourself of this is to note that the total number of messages shown at the top of the page does not change when you select any labels from the 'Charted labels' dropdown.

Chart specific property values

In Segments, much like you can choose to chart labels (see above), you can also chart specific string property values.

You can click a number of property values you wish to plot on the chart, and this will override the default values plotted, which are typically the property values that have the highest corresponding message volumes.

In the example below, the email property of 'Sender Domain' is shown. Using the dropdown at the top-right of the chart, you can select a number values to plot instead of the default ones shown.

Example property chart in Segments showing charted value dropdown

Chart buttons

User permissions required: ‘View Sources’ AND ‘View Labels’.

Beneath each chart you’ll see a number of buttons when you hover over it with your mouse. These buttons allow you to change the chart view and are tailored to each graph.

The buttons available change depending on the exact chart type. They are a reflection of the current view shown in the chart, and so in some instances clicking them will change the mode to an alternative view, and the button displayed will also update.

Check out the table below to see the chart manipulation buttons.

docs imageAdd this chart to your dashboard
docs imageOption to download an image of the chart, download the raw data for the chart as CSV, or add chart to your dashboard
docs imageShow percentages
docs imageShow totals
docs imageDisplay as column/bar chart
docs imageDisplay as line chart
docs imageDisplay as scatter graph
docs imageDisplay as doughnut chart
docs imageSort by prominence
docs imageSort alphabetically
docs imageSort reverse alphabetically
docs imageView labels with the biggest changes in rank
docs imageChange the number of labels displayed

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.