Convalida dell'agente

Come spiegato nella pagina Design dell'agente, il design dell'agente può influire notevolmente sulla sua qualità. 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 viene eseguita e completata la formazione 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 che devi correggere per migliorare la qualità e il rendimento dell'agente. Se l'agente presenta errori, puoi scegliere di ignorarli e lanciarlo. La convalida dell'agente non influisce in alcun modo sul comportamento di un agente.

Ecco alcuni esempi di risultati 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'intent di riserva.
• Questo 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 Dialogflow ES.
2. Seleziona il tuo 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 agente (impostazione predefinita).

Pagina di convalida dell'agente

Per accedere ai dati di convalida dell'agente:

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

Risultati di convalida per intent ed entità

Quando visiti le pagine dell'elenco di intent o delle entità, accanto al nome di qualsiasi intent o entità con errori di convalida viene visualizzato un indicatore di errore .

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

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 una gravità pari a CRITICAL o ERROR. Puoi attivare/disattivare i tipi di gravità per visualizzare anche WARNING e INFO.

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

Risultati di convalida per versioni e ambienti

Quando visualizzi versioni e ambienti, ogni versione dell'agente potrebbe avere errori di convalida unici. Se sono presenti errori, accanto alla versione viene visualizzata l'icona di convalida.

Se fai clic sull'icona, vengono visualizzati i dettagli.

Risultati di convalida con l'API

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

REST

Chiama il metodo getValidationResult sul tipo Agents.

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

• PROJECT_ID: il tuo ID 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:

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 ti consente di accedere automaticamente all'interfaccia a riga di comando 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 comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . 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 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.
CRITICA	L'agente potrebbe non riuscire a completare l'operazione.
SEVERITY_UNSPECIFIED	Non specificato. Questo valore non deve mai essere utilizzato. (questa gravità è possibile tramite l'API)

Convalida forzata

I risultati della convalida dell'agente sono disponibili automaticamente ogni volta che viene eseguita e completata la formazione dell'agente. Per forzare nuovi risultati di convalida, puoi disattivare la convalida automatica e attivarla manualmente. Consulta la pagina Impostazioni ML dell'agente nella console.

Gestire molti problemi

Quando vengono rilevati un numero elevato di problemi, devi prendere in considerazione quanto segue:

• Risolvi i problemi in piccoli batch. Se ci sono molti problemi simili, la risoluzione di un problema potrebbe risolvere anche problemi simili dopo la riqualificazione dell'agente.
• Vengono visualizzati al massimo 5000 problemi alla volta. Se hai più di 5000 problemi, potresti non notare una riduzione del conteggio finché non ne rimarranno meno di 5000.