Convalida dell'agente

Come descritto nella pagina Progettazione dell'agente, il design dell'agente può influenzare notevolmente la qualità dell'agente. Per aiutare i designer di agenti a creare agenti di alta qualità, Dialogflow fornisce una funzionalità di convalida. I risultati della convalida dell'agente sono disponibili automaticamente ogni volta che l'addestramento dell'agente viene eseguito e completato. Puoi accedere ai risultati della convalida dalla console Dialogflow o dall'API.

I risultati della convalida sono solo informativi. Fornisce un elenco di errori da correggere per migliorare la qualità e le prestazioni dell'agente. Se l'agente ha errori, puoi scegliere di ignorarli e avviarlo. La convalida dell'agente non influisce in alcun modo sul 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 che non viene utilizzato in un numero sufficiente di frasi di addestramento.
• Non sono presenti esempi negativi per l'intento di riserva.
• Il testo è annotato in alcune frasi di addestramento, ma non in altre.

Attivare e disattivare 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:

1. Vai alla console di Dialogflow ES.
2. Seleziona un agente.
3. Fai clic sull'icona delle impostazioni accanto al nome dell'agente.
4. Seleziona la scheda Impostazioni ML.
5. Attiva o disattiva l'impostazione Convalida dell'agente.

Pagina di convalida dell'agente

Per accedere ai dati di convalida per il tuo agente:

1. Vai alla console di Dialogflow ES.
2. Seleziona un agente.
3. Fai clic su Convalida nel menu della barra laterale.

Risultati della convalida di intent ed entità

Quando visiti le pagine relative all'elenco degli intent o alle entità, gli intent o le entità con errori di convalida mostrano un indicatore di errore accanto al nome.

Quando visiti una pagina per un intent o un'entità specifica con errori di convalida, accanto al pulsante Salva viene visualizzato un indicatore di errore.

Se fai clic su questo pulsante, viene mostrato un elenco di errori per l'intent o l'entità. Per impostazione predefinita, vengono mostrati solo gli errori con gravità CRITICAL o ERROR. Puoi attivare/disattivare i tipi di gravità per mostrare anche i valori WARNING e INFO.

Puoi anche visualizzare indicatori di errore per frasi e parametri di addestramento specifici e passare il mouse sopra questi indicatori per visualizzare i dettagli.

Risultati della convalida di versioni e ambienti

Quando visualizzi versioni e ambienti, ogni versione dell'agente potrebbe presentare errori di convalida univoci. In caso di errori, viene visualizzata l'icona di convalida accanto alla versione.

Fai clic sull'icona per visualizzare i dettagli.

Risultati della convalida con l'API

Nella maggior parte dei casi, i risultati della convalida vengono visualizzati utilizzando la console di Dialogflow. Tuttavia, puoi accedere a questi dati anche dall'API.

REST

Chiama il metodo getValidationResult nel tipo Agents.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto Google Cloud

Metodo e URL HTTP:

GET https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/validationResult?languageCode=en

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all' interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login, oppure utilizzando Cloud Shell, che esegue automaticamente l'accesso all'interfaccia a riga di comando di gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "x-goog-user-project: PROJECT_ID" \
    "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/validationResult?languageCode=en"

PowerShell (Windows)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all' interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login, oppure utilizzando Cloud Shell, che esegue automaticamente l'accesso all'interfaccia a riga di comando di gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/validationResult?languageCode=en" | Select-Object -Expand Content

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 con gravità

La convalida può mostrare i seguenti stati di gravità:

Gravità	Descrizione
INFO	L'agente non segue le best practice.
AVVISO	L'agente potrebbe non funzionare come previsto.
ERRORE	L'agente potrebbe riscontrare guasti 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 della convalida dell'agente sono disponibili automaticamente ogni volta che l'addestramento dell'agente viene eseguito e completato. Per forzare i nuovi risultati della convalida, puoi disattivare la convalida automatica e attivarla manualmente. Consulta la pagina Impostazioni ML Agent sulla console.

Gestire molti problemi

Quando trovi un numero elevato di problemi, considera questi aspetti:

• Risolvi i problemi in piccoli batch. Se esistono molti problemi simili, la risoluzione di un problema potrebbe risolverli dopo aver riaddestrato l'agente.
• Vengono mostrati al massimo 5000 problemi alla volta. Se hai più di 5000 problemi, potresti non notare una riduzione del conteggio finché non rimangono meno di 5000.