Convalida dell'agente

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Come spiegato nella pagina Progettazione agente, il design dell'agente può influire notevolmente sulla 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 degli agenti sono disponibili automaticamente ogni volta che l'addestramento e l'addestramento degli agenti vengono eseguiti. Puoi accedere ai risultati della convalida dalla console di 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 avviare l'agente. La convalida degli agenti 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.
  • Intent contiene un parametro che non viene utilizzato in frasi di addestramento sufficienti.
  • Non sono presenti esempi negativi per l'intenzione 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 il tuo agente.
  3. Fai clic sull'icona delle impostazioni accanto al nome dell'agente.
  4. Seleziona la scheda ML Settings (Impostazioni ML).
  5. Attiva o disattiva l'opzione Convalida degli agenti (impostazione predefinita).

Screenshot di convalida dell'agente

Pagina di convalida dell'agente

Per accedere ai dati di convalida dell'agente:

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

Screenshot di convalida dell'agente

Risultati della convalida di intent ed entità

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

Screenshot dell'errore di convalida dell'agente

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.

Screenshot dell'errore di convalida dell'agente

Se fai clic su questo pulsante, viene visualizzato 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.

Screenshot dell'errore di convalida dell'agente

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

Screenshot dell'errore di convalida dell'agente

Risultati di convalida per versioni e ambienti

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

Screenshot dell'errore di convalida dell'agente

Fai clic sull'icona per visualizzare i dettagli.

Screenshot dell'errore di convalida dell'agente

Risultati di convalida con l'API

Nella maggior parte dei casi, puoi visualizzare i risultati della convalida 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, apporta 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:

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'"
    },
  ]
}

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.
SEVERITY_UNSPECIFIED Non specificato. Questo valore non deve mai essere utilizzato. (Questa gravità è possibile tramite l'API)

Forza convalida

I risultati della convalida degli agenti sono disponibili automaticamente ogni volta che l'addestramento e l'addestramento degli agenti vengono eseguiti. Per forzare nuovi risultati di convalida, puoi disattivare la convalida automatica e attivarla manualmente. Consulta la pagina Impostazioni ML Agent nella console.

Gestione di molti problemi

Quando vengono rilevati molti problemi, dovresti prendere in considerazione quanto segue:

  • Risolvi i problemi in piccoli gruppi. Se sono presenti molti problemi simili, la risoluzione di un problema potrebbe risolvere quelli simili dopo aver riaddestrato l'agente.
  • Vengono mostrati al massimo 5000 problemi alla volta. Se hai più di 5000 problemi, potresti perdere il conteggio fino a quando non ne resteranno meno di 5000.