Skip to content

Virtual Assistant Health and Monitoring

The Health and Monitoring dashboard offers a goal-driven approach to improving the accuracy of the virtual assistant’s Natural Language Processing (NLP) model. The training data is analyzed along with the test coverage and test results of the test suites to provide insights into the NLP Model’s performance.

This dashboard lets you achieve the following:

  • Run the test suites against the in-development version of the bot to see the Virtual Assistant’s health.
  • Review the test execution summary for every intent type.
  • Drill down and view the coverage and key metrics of the virtual assistant determined by the Batch Test and Conversation Test executions.
  • Identify incorrect intent patterns, short training utterances, incorrect entity annotations, and training recommendations and take corrective action.
  • View the expected and matched results, and the detailed NLP analysis.
  • Tag specific test case results that need follow-up actions and collaborate with your team to improve the performance.

Note

The Health & Monitoring Dashboard is available only post 9.3 release, i.e. post-July 24, 2022. This feature only considers the latest In-development test executions.

To navigate to the Health and Monitoring dashboard, follow these steps:

  1. Click Health & Monitoring tab under Testing > Regression Testing in the left navigation menu.
    Health and Monitoring dashboard

Dashboard Sections and Components

The Health and Monitoring Dashboard is divided into two sections that include the following:

  1. NLP: This panel extracts all test suite results from Batch Testing and presents insights into your test cases with performance analytics. The key components of this panel include the execution summary, the key performance metrics, and the total test coverage of the selected test suites for the Dialog intents, FAQs, Small Talks, and Traits. The key recommendation scores presented here depict if your virtual assistant is trained sufficiently or not.
  2. Flow: This panel summarizes the coverage of all the conversation flows by the Virtual Assistant you’ve defined including its performance, intents’ coverage and transitions. Learn more. The key components of the Flow panel include transition coverage and intent summary panels for the test suites. Learn more.

Health and Monitoring Metrics

NLP Intent Coverage Metrics

The following metrics extracted from Batch Testing results are displayed in two ways:

  1. As aggregate values in the Bot Health summary section.
    aggregate values

  2. As individual scores in the Dialog Intents, FAQs, Small Talk, and Traits summary panels.
    individual scores

  3. Accuracy: Determines if the intent identified by your ML model is correct or not.

  4. F1 Score: Classifies the distribution and balances precision and recall scores. It is calculated as the weighted average of Precision and Recall.
  5. Precision Score: Defines how precise/accurate your model is and is calculated as the ratio of true positives over total predicted positives (sum of true and false positives).
  6. Recall Score: Defines the fraction of the relevant utterances that are successfully identified and is calculated as the ratio of true positives over actual positives (sum of true positives and false negatives).
  7. Total Test Coverage %: The average of the Total Test Coverage scores for Dialog Intents, FAQs, Small Talk, Traits, and Entities.

These metrics help gain actionable insights into your test cases to perform ML Model Validation.

Flow Health Metrics

The Flow Health metrics display all the test suite results from the conversation testing and present insights into your test cases with performance analytics. Learn more.

Test Cases Detailed Analysis

To get the detailed NLP data of all the test cases executed for all the test suites that are considered in the VA, click the View Test Cases link in the NLP section.

detailed NLP data

The Test Cases- Detailed Analysis window displays test results for Intents, Entities, and Traits as described below. The summary data helps identify the errors or areas of improvement for each category and fix them.

To view the Details section, in the Test Cases – Detailed Analysis window, click the Intents, Entities, or Traits tab. A summary table with the following details is displayed:

Intents

  • Test Cases: The test case name.
  • Intent Type: Displays if the intent is a Dialog intent, FAQ, or Small Talk.
  • Expected Intent: Intent expected in the user utterance.
  • Matched Intent: Intent actually matched in the utterance.
  • Result Type: Displays if the match detected is True Positive, False Positive, or False Negative.
  • Tags: The tag labeled for the conversation by the analyst.

Intents

Entities

A summary table with the following details is displayed:

  • Utterances: The user utterance captured in the test case.
  • Entity Name: The entity name mapped to the test case for the utterance.
  • Expected Value: The Entity expected in the user utterance.
  • Matched Value: The Entity actually matched in the utterance.
  • Entity Result: Displays if an entity is matched (True), or not (False).
  • Tags: The tag labeled for the conversation by the analyst.
    Entities

Traits

A summary table with the following details is displayed:

  • Test Cases: The test case of the trait.
  • Intent Type: Displays Trait.
  • Trait Name: The name of the trait analyzed in the test case.
  • Expected Trait: The trait expected in the user utterance.
  • Matched Trait: Displays the actual trait matched in the utterance.
  • Trait Result: Displays if the match detected is True Positive, False Positive, or False Negative.
  • Tags: The tag labeled for the conversation by the analyst.

Traits

Tags

After analyzing the reason for failure, you can collaborate with your team members using tags for test case executions. Tags are labels mapped to the test case results of intents, entities, and traits, indicating follow-up actions or suggestions.

The following tags are available for intents, entities, and traits:

  • Add Negative Pattern: Indicates that the user has to add a negative pattern to the intent/entity/trait test execution.
  • NeedNLPHelp: Indicates that the test execution requires explicit NLP help.
  • Needs Negative Pattern: Indicates that the intent/entity/trait test execution needs a negative pattern to execute as expected.
  • Needs Training: Indicates that the virtual assistant needs training for the identified intent/entity/trait after the test execution.
  • New Intent: Indicates a new intent during test execution.

Hover over the desired entry, and click the detailed view icon.
Test cases detailed analysis

A sliding window with the test results for the selected test case and intent type appears.

Intent and Entity Details
Intent and Entity Details

Trait Details are displayed in the test case details window if you select the trait intent type.
Trait Details

Click the expansion arrow icon under Entity to view the entity order expected by the ML engine and the actual entity order.
Entity

NLP Analysis

The NLP Analysis section displays the detailed view of the historic analysis generated at the time of the test case execution for failed and successful test cases. For the selected intent type, this section gives an overview of the intents that are qualified (the definitive and probable matches) and disqualified to serve as crucial information for users trying to decode the reason for failed test cases. The following details are displayed as a graphical representation in this section:

This is different from analyzing the test results under Utterance Testing where the current analysis information is displayed based on the changes to the trained data. Learn more.

To view the NLP Analysis section, follow these steps:

  1. Please follow steps 1 to 3 mentioned in the Navigating to the Test Case Details section.
  2. Click the NLP Analysis tab as shown below:
    NLP Analysis

Test Suite Summary

For Flow Health, clicking the View Test Suites link displays the following details:

  • Test Suite
  • Result
  • Duration
  • Test Cases
  • Pass
  • Fail
  • Not Executed
  • Pass percentage

Please click here to learn more about Test Suite Performance and Test Coverage Analysis.

Utterance Testing

Based on the test case failures, you can retrain your virtual assistant using the Utterance testing option for all possible user utterances and inputs. Training is how you enhance the performance of the NLP engine to prioritize one task or user intent over another based on the user input. To learn more, please refer to this link.

To navigate to the Utterance Testing window, click the go to utterance testing (magic wand) icon on the Test Cases – Detailed Analysis page.
go to utterance testing

In the Utterance Testing window shown below, you can do the following:

  • Test & Train your virtual assistant based on these recommendations to understand different user utterances and match them with intents and entities.
  • View the NLP analysis flow and Fields/Entities analysis data including the confidence score based on the NER training.
  • Use the Mark as an incorrect match link to match the user input with the right intent when it is mapped to an incorrect task.
    Utterance Testing window

Dialog Intent Summary

This section provides the performance metrics, test coverage and analytics for only the Dialog Intents test cases.
Dialog Intent Summary

The sub-sections available include:

Test Coverage

This section displays the count and percentage of the intents covered and not covered. You can find the list of intents not covered using the View details option and start adding test cases for them. An Intent is considered as covered when the intent has at least one test case in the selected test suite(s).

NLP Performance Metrics

This section gives the breakdown of the test case results for the given intent type. The result type could have one of the following values:

  • True Positive (TP): Percentage of utterances that have correctly matched expected intent. In the case of Small Talk, it would be when the list of expected and actual intents are the same. In the case of Traits, this would include the traits matched over and above the expected matches.
  • False Positive (FP): Percentage of utterances that have matched an unexpected intent. In the case of Small Talk, it would be when the list of expected and actual intents are different.
  • False Negative (FN): Percentage of utterances that have not matched expected intent. In the case of Small Talk, it would be when the list of expected Small Talk intent is blank but the actual Small Talk is mapped to an intent.

Recommendation Notification: Shows any training recommendations available for the dialog intents.

The test execution results for the selected test suite(s) and intent type can be analyzed in the details window which provides a drill-down view of the following performance metrics for intents, entities, and traits

METRIC NAME DESCRIPTION INTENT ENTITY TRAIT
Expected Intent/Value Please refer to Intents in this section. Yes Yes Yes
Matched Intent/Value Please refer to Intents in this section. Yes Yes Yes
Parent Intent Learn more. Yes No Yes
Task State The status of the intent or task against which the intent is identified. Possible values include Configured or Published.
.
Yes No Yes
Result Type Please refer to Intents in this section. Yes No Yes
Matched Intent Score and Expected Intent Score Displays the individual scores for the following Yes No Yes
Entity Name Please refer to Entities in this section.. No Yes No
Result Returns True if an entity is identified and False if not. No Yes No
Identified by The NLU engine that identified the entity. No Yes No
Identified using The reference entity type that was used to identify the entity during test execution. No Yes No
Confidence Score A score to determine if the test execution resulted in a favorable outcome (high score) or not (low score) when an utterance is trained for the entity. No Yes No

Dialog Intent Flow Health

Please refer to this link for more information.

The following sections can be accessed from the Dialog Intent Summary panel:

Conversation Test Results Analysis

Please refer to this link for more information.

Transitions Coverage

Please refer to this link for more information.

View Intents Summary

Please refer to this link for more information.

View Recommendations

You can view relevant training recommendations for dialog intents, FAQs, or Small Talks when errors and warnings are triggered during the test execution. To view the recommendations summary, click View Recommendations on the top right of the details page.

To view the details of the utterance validations, errors, warnings, and recommendations and correct them, click the Recommendations column.
Recommendations

Viewing Specific Test Results

To know how to get the drill-down view of a specific NLP test case execution, please refer to the Test Cases – Detailed Analysis section.

NLP- FAQs Summary

The FAQ Summary section displays the recommendation scores generated for FAQs from the latest batch test executions.
FAQ Summary

Viewing Additional FAQ Recommendations: For FAQ Details, clicking View Recommendations will display the report that was already run during the previous run time. To know how to view and manage additional recommendations, please refer to this link.
Viewing Additional FAQ Recommendations

Report

Knowledge Graph: Clicking this button will take you to the Knowledge Graph section where you can perform KG Analysis.
Knowledge Graph button

Knowledge Graph window

Flow- FAQs Summary

Please refer to this link for more information.

NLP- Small Talk Summary

The Small Talk Summary panel displays the recommendation scores generated for Small Talk interactions from the latest batch test executions.
Small Talk Summary

Small Talk button: Click this button to view the group name and the relevant user utterances, and Bot utterances.
Small Talk button

Flow- Small Talk Summary

Please refer to this link for more information.

Trait and Entity Summary Information

The Trait Summary and Entity Summary sections display the recommendation scores generated for traits and entities respectively from the latest batch test executions.

Trait Summary
Trait Summary

Entity Summary
Entity Summary

Test Coverage and Test Results Analysis

Please refer to Test Coverage and Test Results Analysis for information on the sub-sections of these summary panels.

NLP Batch Test Results Summary for Universal Bots

The XO Platform now displays batch test results for Universal bots for each test run in the summary view for FAQs, Dialog Intents, and Small Talk during Batch Testing. The actionable insights help understand the test coverage and NLP performance for each intent type in the Universal Bot.

The only difference between Standard and Universal Bots is that the insights derived are based on the intents of all the linked bots. For instance, the intent coverage is based on the comparison of the intents covered in the test suite and the total number of intents present in all the linked bots.

Test Suite Summary

The Test Suite Summary for the Universal Bot is the same for Dialog Intents, FAQs, and Small Talk. However, for the Universal Bot, the system takes the total number of respective intents in all the linked bots as the denominator to calculate the coverage metrics.

Intent Summary

The NLP Intent Summary sections are the same for Universal Bots, except the Recommendations information is not displayed for Dialogs and FAQs, as shown below:
NLP Intent Summary

Dialog Intents

The Dialog Intent Details page for Universal Bot summarizes the following information:

  • Intent Name
  • Bot Name
  • Training Utterance
  • Test Cases
  • NLP performance metrics: TP, FP, FN, and F1.
  • Coverage metrics: Precision, Recall, and Accuracy.
  • Covered In (The Test Suites that cover the intent).
    Dialog Intent Details

Please refer to Intent Details Window for more information on the above values.

Note: The Recommendations option is not available for Universal Bot on this page.

To view the intents not covered on the Dialog Intent Details page, click the Three-dotted/Ellipses icon and select View Intents Not Covered.
Dialog Intent-Intents Not Covered

In the Not Covered Intents List, you can view the respective Bot Name, as shown below. This helps analyze which Bots don’t identify the tested intents and improve test execution accordingly.
Dialog Intent-Not Covered Intent

The Search and Filter options help select specific intents not covered by a Bot.

FAQ

The FAQ Details page for Universal Bot summarizes the following information:

Please refer to Intent Details Window for more information on the above values.

Note

The 'Knowledge Graph' and 'Recommendations' options are not available for Universal Bot on this page.

To view the intents not covered on the FAQ Details page, click the Three-dotted/Ellipses icon and select View Intents Not Covered.
FAQ-Intents Not Covered

In the Not Covered Intents List, you can view the respective Bot Name, as shown below.
FAQ-Not Covered Intents

Small Talk

The Small Talk Details page for Universal Bot summarizes the following information:

Please refer to Intent Details Window for more information on the above values.

Note

The 'Small Talk' option is not available for Universal Bot on this page.

To view the intents not covered on the Small Talk Details page, click the Three-dotted/Ellipses icon and select View Intents Not Covered.
Small Talk-Intents Not Covered

In the Small Talk-Intents Not Covered List, you can view the respective Bot Name, as shown below.
Small Talk-Small Talk-Intents Not Covered

Intent Details Window

The View Details link in the Dialog intent, FAQ, and Small Talk summary sections provides access to a drill-down view of the key performance metrics and recommendations of the covered intents.

The given data helps identify the intent-related issues proactively in the training phase itself to work on fixing them accordingly.
Intent Details

Here’s what you can do:

View the Training Data Summary

You can view the training data summary with the relevant recommendation metrics for Dialog Intents, FAQs, and Small Talks in the details panel.
Training Data Summary

The summary of all the metrics displayed is given below:

RECOMMENDATION METRIC DIALOG INTENT FAQ SMALL TALK
Intent The name of the dialog intent. The name of the FAQ intent. The name of the Small Talk intent.
Utterances The count of the training utterances for that intent. N/A
Test Cases The count of the test cases that are present in the selected test suites for that intent.
True Positive (TP) The count of the intent test cases that resulted in TP.
False Negative (FN) The count of the intent test cases that resulted in FN.
False Positive (FP) The count of the intent test cases that resulted in FP.
Covered In Name of the test suites in which the intent test cases are present.
F1, Accuracy, Precision, and Recall scores These recommendation scores are displayed based on the outcomes.
Recommendations Displays the count of training recommendations for that intent. Clicking on it will display the summary of the training recommendations and their probable corrective actions. N/A N/A
Group N/A N/A The group to which the Small Talk interaction is mapped.
Path N/A The node path in the Knowledge Graph. N/A
Alt Question N/A The number of alternative questions mapped to an FAQ. N/A

View Intents Not Covered

This feature helps identify the intents not covered so as to include them in the test data for better and holistic testing of the virtual assistant. Click the three-dot menu on the right side of the panel to view the list of intents not covered in batch testing.
Training data-intents not covered

You can include the intents from this list to retrain your virtual assistant and improve performance.
Training data-Not covered intents