Convalida dell'agente

Come discusso nelle Design dell'agente pagina, il design dell'agente può influire notevolmente sulla sua qualità. Per aiutare i designer degli agenti a creare agenti di alta qualità, Dialogflow fornisce una funzionalità di convalida. I risultati della convalida dell'agente sono disponibili automaticamente 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 che devi correggere per migliorare la qualità e le prestazioni dell'agente. Se l'agente presenta errori, puoi scegliere di ignorarli e avviare l'agente. La convalida dell'agente non influisce in alcun modo sul comportamento di un agente.

Ecco alcuni risultati di esempio che potresti trovare:

• L'intent ha frasi di addestramento troppo simili.
• L'intent contiene un parametro che non viene utilizzato in un numero sufficiente di frasi di addestramento.
• Non ci sono esempi negativi per l'intent di riserva.
• Questo testo è annotato in alcune frasi di addestramento, ma non in altre.

Abilita e disabilita 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 l'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 per l'agente:

1. Vai alla console Dialogflow ES.
2. Seleziona l'agente.
3. Fai clic su Convalida nella menu della barra laterale.

Risultati di convalida per intent ed entità

Quando visiti le pagine dell'elenco di intent o di entità, eventuali intent o entità con errori di convalida mostrano un errore accanto al nome.

Quando visiti una pagina di un intent o di un'entità specifici 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 gravità CRITICAL o ERROR. Puoi attivare/disattivare i tipi di gravità in modo che vengano visualizzati anche WARNING e INFO.

Potresti anche vedere indicatori di errore per frasi e parametri di addestramento specifici, e passa il mouse sopra questi indicatori per visualizzarne i dettagli.

Risultati di convalida per versioni e ambienti

Durante la visualizzazione versioni e ambienti, ciascuna versione dell'agente può avere 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, visualizzerai i risultati di convalida utilizzando la console Dialogflow. Tuttavia, puoi accedere a questi dati anche dall'API.

REST

Chiama il metodo getValidationResult sulla Agents di testo.

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 delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'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 a l'interfaccia a riga di comando 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.
CRITICO	L'agente potrebbe non riuscire del tutto.
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 l'addestramento dell'agente. Per forzare nuovi risultati di convalida, puoi disabilitare la convalida automatica e attivarla manualmente. Consulta le impostazioni di Agent ML sulla console.

Gestione di molti problemi

Quando viene trovato un gran numero di problemi, devi prendere in considerazione quanto segue:

• Risolvi i problemi in piccoli batch. Se sussistono molti problemi simili, risolvere 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 notare una riduzione del conteggio fino a quando non rimangono meno di 5000.