Alcuni prodotti e funzionalità sono in fase di rinominazione. Anche le funzionalità di playbook e flusso generativi sono in fase di migrazione a un'unica console consolidata. Consulta i dettagli.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Per aiutare i designer di agenti a creare agenti di alta qualità,
Conversational Agents (Dialogflow CX) fornisce una funzionalità di convalida.
La convalida dell'agente viene eseguita su richiesta.
Puoi richiedere la convalida dell'agente dalla console Dialogflow o dall'API al termine della modifica dell'agente e della riqualificazione dei modelli NLU.
Puoi anche eseguire query sugli ultimi risultati di convalida
senza eseguire una nuova convalida.
I risultati della convalida sono solo informativi.
Forniscono un elenco di messaggi di convalida classificati
che puoi correggere per migliorare la qualità e il rendimento
del tuo agente.
La convalida dell'agente non influisce in alcun modo sul comportamento di un agente.
Puoi ignorare i messaggi di convalida e comunque avviare l'agente.
I messaggi di convalida riguardano la qualità dei dati di addestramento del modello NLU, inclusi gli intent e i tipi di entità, nonché la qualità della struttura del flusso basata su pagine, come le regole di transizione.
Ecco alcuni esempi di messaggi di convalida che potresti trovare:
Intent diversi hanno frasi di addestramento troppo simili.
Non sono presenti esempi negativi per l'intenzione negativa predefinita.
Questo testo è annotato in alcune frasi di addestramento, ma non in altre.
Lo stesso sinonimo viene utilizzato per valori diversi in un tipo di entità.
Questo parametro della condizione di routing dell'intent non è definito.
Questo parametro del modulo è definito con il tipo "sys.any".
Accedere ai risultati
Per accedere ai risultati di convalida del tuo agente:
Vengono mostrati i risultati di convalida più recenti, che potrebbero essere obsoleti.
Per attivare nuovi risultati, fai clic sul pulsante refresh Aggiorna nella parte superiore del riquadro.
Per attivare nuovi risultati solo per un flusso,
fai clic su Aggiorna nella riga dei risultati specifici per il flusso.
Per filtrare i messaggi di convalida, inserisci una parola chiave nella casella Messaggi di convalida della ricerca. Utilizza l'operatore "-" davanti alla parola chiave per escludere i messaggi di convalida. Esempi:
Inserisci "bolletta" per cercare i messaggi di convalida contenenti "bolletta".
Inserisci "-bill" per cercare i messaggi di convalida che NON contengono "bill".
Risultati in linea per intent, entità e pagine
I messaggi di convalida vengono visualizzati anche nell'elenco delle intenzioni, nell'elenco delle entità e nell'elenco delle pagine.
Ad esempio, nell'elenco delle pagine, nella riga della pagina viene visualizzata un'icona che indica il livello di gravità quando sono presenti messaggi di convalida per quella pagina.
Quando passi il mouse sopra l'icona, viene visualizzata una descrizione comando che mostra i messaggi di convalida dettagliati.
Livelli di gravità
La convalida può mostrare i seguenti livelli di gravità:
Gravità
Descrizione
INFO
L'agente non segue la best practice.
AVVISO
L'agente potrebbe non comportarsi come previsto.
ERRORE
L'agente potrebbe riscontrare errori.
Controlli
Dal riquadro di convalida,
puoi filtrare i risultati della convalida in base al livello di gravità
o cercando il testo del messaggio di convalida:
Utilizza le caselle di controllo del livello di gravità.
Inserisci il testo nella casella di ricercasearch.
L'opzione di attivazione/disattivazione Mostra convalida nel Visual Builder nel riquadro di convalida controlla se i risultati della convalida vengono visualizzati in linea per intent, entità e pagine.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-18 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."]]
