Come discusso nella pagina Progettazione dell'agente, il design dell'agente può influire notevolmente sulla qualità dell'agente. Per aiutare i progettisti degli agenti a creare agenti di alta qualità, Dialogflow offre una funzionalità di convalida. I risultati di convalida dell'agente sono disponibili automaticamente ogni volta che viene eseguito e completato l'addestramento dell'agente. Puoi accedere ai risultati della convalida dalla console Dialogflow o dall'API.
I risultati della convalida sono solo informativi. Forniscono un elenco di errori da correggere per migliorare la qualità e le prestazioni dell'agente. Se l'agente contiene errori, puoi scegliere di ignorarli e avviare l'agente. La convalida dell'agente non influenza in alcun modo il comportamento di un agente.
Di seguito sono riportati alcuni risultati di esempio che potresti trovare:
- L'intent contiene frasi di addestramento troppo simili.
- L'intent contiene un parametro non utilizzato in un numero sufficiente di frasi di addestramento.
- Non sono presenti esempi negativi per l'intent di riserva.
- Questo testo è annotato in alcune frasi di addestramento, ma non in altre.
Abilitare e disabilitare la convalida automatica
Per impostazione predefinita, la convalida dell'agente viene eseguita automaticamente ogni volta che l'agente viene addestrato. Puoi attivare e disattivare questa impostazione:
- Vai alla console Dialogflow ES.
- Seleziona l'agente.
- Fai clic sull'icona delle impostazioni settings accanto al nome dell'agente.
- Seleziona la scheda Impostazioni ML.
- Attiva o disattiva l'impostazione Convalida agente (impostazione predefinita).
Pagina di convalida agente
Per accedere ai dati di convalida per l'agente:
- Vai alla console Dialogflow ES.
- Seleziona l'agente.
- Fai clic su Convalida nel menu della barra laterale.
Risultati della convalida per intent ed entità
Quando visiti le pagine dell'elenco di intent o delle entità, tutti gli intent o le entità con errori di convalida mostrano un indicatore di errore error_outline accanto al nome.
Quando visiti una pagina per un intent o un'entità specifica che presenta errori di convalida, accanto al pulsante Salva viene visualizzato un indicatore di errore error_outline.
Se fai clic su questo pulsante viene visualizzato un elenco di errori relativi all'intent o all'entità.
Per impostazione predefinita, vengono mostrati solo gli errori con gravità CRITICAL o ERROR.
Puoi attivare/disattivare i tipi di gravità in modo da mostrare anche WARNING e INFO.
Potresti anche visualizzare indicatori di errore per frasi e parametri di addestramento specifici. Puoi passare il mouse sopra questi indicatori per visualizzarne i dettagli.
Risultati della convalida per versioni e ambienti
Quando visualizzi versioni e ambienti, ogni versione dell'agente potrebbe presentare errori di convalida univoci. Se sono presenti errori, accanto alla versione viene visualizzata l'icona di convalida.
Fai clic sull'icona per visualizzare i dettagli.
Risultati della convalida con l'API
Nella maggior parte dei casi, i risultati della convalida verranno visualizzati utilizzando la console di Dialogflow. Tuttavia, puoi accedere a questi dati anche dall'API.
REST
Chiama il metodogetValidationResult nel tipo Agents.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud
Metodo HTTP e URL:
GET https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/validationResult?languageCode=en
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"validationErrors": [
{
"severity": "ERROR",
"entries": [
"projects/my-project/agent/intents/58b44b2d-4967-4a81-b017-12623dcd5d28/parameters/bf6fdf55-b862-4101-b5b1-36f1423629d0"
],
"errorMessage": "Parameter 'test' has an empty value."
},
{
"severity": "WARNING",
"entries": [
"projects/my-project/agent/intents/271e3808-3c91-4e6b-89e8-47951abcec8d"
],
"errorMessage": "Intent 'app.current.update' does not have enough unique training phrases. Consider adding more different examples."
},
{
"severity": "ERROR",
"entries": [
"projects/my-project/agent/intents/26e64b1b-eaa7-4ce2-be46-631a501fccbe/trainingPhrases/a650375e-083c-4bb5-9794-ba9453e51282",
"projects/my-project/agent/intents/58b44b2d-4967-4a81-b017-12623dcd5d28/trainingPhrases/1d947780-22d3-4f80-8d7a-3f86efbf0be3"
],
"errorMessage": "Multiple intents share training phrases which are too similar:\n - Intent 'app.notifications.open': training phrase 'open allo notifications settings'\n - Intent 'app.current.notifications.open': training phrase 'open notifications settings'"
},
]
}
Stati di gravità
La convalida può mostrare i seguenti stati 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 parziali. |
| CRITICO | L'agente potrebbe non riuscire completamente. |
| SEVERITY_UNSPECIFIED | Non specificato. Questo valore non deve mai essere utilizzato. (Questa gravità è possibile tramite l'API) |
Forza convalida
I risultati di convalida dell'agente sono disponibili automaticamente ogni volta che viene eseguito e completato l'addestramento dell'agente. Per forzare i nuovi risultati della convalida, puoi disabilitare la convalida automatica e attivarla manualmente. Consulta la pagina Impostazioni ML dell'agente sulla console.
Gestione di molti problemi
Se viene rilevato un numero elevato di problemi, considera quanto segue:
- Risolvi i problemi in piccoli batch. Se ci sono molti problemi simili, la risoluzione di un problema potrebbe risolvere problemi simili dopo aver riaddestrato l'agente.
- Vengono visualizzati al massimo 5000 problemi alla volta. Se hai più di 5000 problemi, potresti non vedere una riduzione del conteggio finché non ne rimangono meno di 5000.