Some products and features are in the process of being renamed. Generative playbook and flow features are also being migrated to a single consolidated console. See the details.
Stay organized with collections
Save and categorize content based on your preferences.
To help agent designers create high-quality agents,
Conversational 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.
The latest validation results are shown, which may be outdated.
To trigger new results, click the refresh Refresh button
at the top of the panel.
To trigger new results for one flow only,
click Refresh in the flow-specific results row.
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".
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.
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
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eAgent validation, available in Conversational Agents (Dialogflow CX), is an on-demand feature that analyzes agent quality and performance, providing a list of classified validation messages for improvement.\u003c/p\u003e\n"],["\u003cp\u003eValidation results are purely informational and do not impact the agent's behavior, allowing developers to ignore messages while still launching the agent.\u003c/p\u003e\n"],["\u003cp\u003eThe validation process examines the quality of NLU model training data (intents and entity types) and the structure of page-based flows, identifying issues like similar training phrases or missing negative examples.\u003c/p\u003e\n"],["\u003cp\u003eValidation results can be accessed via the Dialogflow CX console by navigating to the "Validation" panel under the "Manage" tab, where you can trigger new results and filter messages.\u003c/p\u003e\n"],["\u003cp\u003eValidation messages are shown within the intents, entities, and pages lists with severity level icons (INFO, WARNING, ERROR) and can be filtered by severity or search terms, and inline display can be toggled in the validation panel.\u003c/p\u003e\n"]]],[],null,["# Validation\n\nTo help agent designers create high-quality agents,\nConversational Agents (Dialogflow CX) provides a validation feature.\nAgent validation is performed on-demand.\nYou can request agent validation from either the Dialogflow Console\nor the API when you complete editing your agent\nand retraining the NLU models.\nYou can also query the latest validation results\nwithout performing new validation.\n\nThe validation results are informational only.\nThey provide a list of classified validation messages\nthat you can correct to improve the quality and performance\nof your agent.\nAgent validation does not affect the behavior of an agent in any way.\nYou can ignore the validation messages and still launch your agent.\nThe validation messages cover the quality of the NLU model training data\nincluding the intents and entity types,\nand the quality of the page-based flow structure such as transition rules.\nHere are some example validation messages that you might find:\n\n- Different intents have training phrases which are too similar.\n- There are no negative examples for the default negative intent.\n- This text is annotated in some training phrases but not others.\n- The same synonym is used for different values in an entity type.\n- This intent route condition parameter is not defined.\n- This form parameter is defined with 'sys.any' type.\n\nAccess results\n--------------\n\nTo access the validation results for your agent:\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your project.\n3. Select your agent.\n4. Select the **Manage** tab.\n5. Click **Validation** in the **Manage** panel.\n6. Select a flow.\n7. The latest validation results are shown, which may be outdated.\n8. To trigger new results, click the **refresh Refresh** button at the top of the panel.\n9. To trigger new results for one flow only, click **Refresh** in the flow-specific results row.\n10. To filter validation messages, enter a keyword in the **Search validation\n messages** box. Use the \"-\" operator in front of the keyword to filter out the validation messages. Examples:\n - Enter \"bill\" to search validation messages containing \"bill\".\n - Enter \"-bill\" to search validation messages NOT containing \"bill\".\n\n| **Note:** Intent and entity issues will only be updated after NLU training is done.\n\nInline results for intents, entities, and pages\n-----------------------------------------------\n\nValidation messages are also shown in the intents list,\nthe entities list and the pages list.\nFor example, in the pages list, an icon indicating the severity level\nis shown in the page row when there are validation messages for that page.\nA tooltip showing the detailed validation messages appears\nwhen hovering over the icon.\n\nSeverity levels\n---------------\n\nValidation can show the following severity levels:\n\nControls\n--------\n\nFrom the validation panel,\nyou can filter validation results by severity level\nor by searching for validation message text:\n\n- Use the severity level checkboxes.\n- Enter text in the search search box.\n\nThe **Show validation in visual builder** toggle on the validation panel\ncontrols whether validation results are displayed inline\nfor intents, entities, and pages."]]
