Validation

To help agent designers create high-quality agents, Dialogflow CX provides a validation feature. Agent validation is performed on-demand. You can request agent validation from either the Dialogflow Console or the API when you complete editing your agent and retraining the NLU models. You can also query the latest validation results without performing new validation.

The validation results are informational only. They provide a list of classified validation messages that you can correct to improve the quality and performance of your agent. Agent validation does not affect the behavior of an agent in any way. You can ignore the validation messages and still launch your agent. The validation messages cover the quality of the NLU model training data including the intents and entity types, and the quality of the page-based flow structure such as transition rules. Here are some example validation messages that you might find:

  • Different intents have training phrases which are too similar.
  • There are no negative examples for the default negative intent.
  • This text is annotated in some training phrases but not others.
  • The same synonym is used for different values in an entity type.
  • This intent route condition parameter is not defined.
  • This form parameter is defined with 'sys.any' type.

Access results

To access the validation results for your agent:

  1. Open the Dialogflow CX Console.
  2. Choose your GCP project.
  3. Select your agent.
  4. Select the Manage tab.
  5. Click Validation in the Manage panel.
  6. The latest validation results are shown, which may be outdated.
  7. To trigger new results, click the Refresh button at the top of the panel.
  8. To trigger new results for one flow only, click Refresh in the flow-specific results row.
  9. To filter validation messages, enter a keyword in the Search validation messages box. Use the "-" operator in front of the keyword to filter out the validation messages. Examples:
    • Enter "bill" to search validation messages containing "bill".
    • Enter "-bill" to search validation messages NOT containing "bill".

Validation screenshot.

Inline results for intents, entities, and pages

Validation messages are also shown in the intents list, the entities list and the pages list. For example, in the pages list, an icon indicating the severity level is shown in the page row when there are validation messages for that page. A tooltip showing the detailed validation messages appears when hovering over the icon.

Validation screenshot.

Severity levels

Validation can show the following severity levels:

Severity Description
INFO The agent doesn't follow the best practice.
WARNING The agent might not behave as expected.
ERROR The agent may experience failures.

Controls

From the validation panel, you can filter validation results by severity level or by searching for validation message text:

  • Use the severity level checkboxes.
  • Enter text in the search box.

The Show validation in visual builder toggle on the validation panel controls whether validation results are displayed inline for intents, entities, and pages.