Validación de agentes

beta

Como se explicó en la página Diseño de agentes, el diseño de un agente tener un efecto considerable en su calidad. Para ayudar a los diseñadores a crear agentes de alta calidad, Dialogflow proporciona una función de validación. Los resultados de la validación del agente se encuentran disponibles de forma automática cada vez que se realiza y completa la capacitación de un agente. Puedes acceder a los resultados de la validación desde la consola de Dialogflow o desde la API.

Los resultados de la validación proporcionan una lista de errores que recomendamos corregir para mejorar su calidad y rendimiento. Sin embargo, si tu agente tiene errores, puedes iniciarlo sin antes repararlos. A continuación, se muestran algunos ejemplos con los que te puedes encontrar:

  • El intent tiene frases de entrenamiento demasiado similares.
  • El intent contiene un parámetro que no se usa en suficientes frases de entrenamiento.
  • No hay ejemplos negativos para el intent de resguardo.
  • Este texto se anotó en algunas frases de entrenamiento, pero no en otras.

Inhabilita y habilita la validación automática

Según la configuración predeterminada, la validación del agente se realiza de forma automática cada vez que se entrena al agente. Puedes inhabilitar y habilitar esta configuración mediante los siguientes pasos:

  1. Ve a la Consola de Dialogflow.
  2. Selecciona el agente.
  3. Haz clic en el ícono de configuración settings junto al nombre del agente.
  4. Selecciona la pestaña Configuración del AA.
  5. En Agent Validation (Validación del agente), elige si quieres que esta función esté habilitada (la opción predeterminada) o no.

Captura de pantalla de la validación del agente

Página de validación del agente

Para acceder a los datos de validación de tu agente, realiza los siguientes pasos:

  1. Ve a la Consola de Dialogflow.
  2. Selecciona el agente.
  3. Haz clic en Validación en el menú de la barra lateral.

Captura de pantalla de la validación del agente

Resultados de la validación de intents y entidades

Cuando visitas la lista de intents o de entidades, los elementos con errores de validación tendrán un indicador de error error_outline junto a su nombre.

Captura de pantalla de un error de validación del agente

Si visitas la página de un intent o una entidad en particular con errores de validación, verás un indicador de error error_outline cerca del botón Save (Guardar).

Captura de pantalla de un error de validación del agente

Si haces clic en este botón, verás una lista de los errores del intent o la entidad. Según la configuración predeterminada, solo se muestran los errores con una gravedad de CRITICAL o ERROR. Puedes activar o desactivar los tipos de gravedad para que también se muestren WARNING y INFO.

Captura de pantalla de un error de validación del agente

También puedes ver los indicadores de error de las frases y los parámetros de entrenamiento específicos, y puedes colocar el cursor sobre estos indicadores para ver los detalles.

Captura de pantalla de un error de validación del agente

Resultados de la validación de versiones y entornos

Cuando se visualizan las versiones y los entornos, cada versión del agente puede tener errores de validación únicos. Si hay algún error, aparecerá el ícono de validación junto a la versión.

Captura de pantalla de un error de validación del agente

Si haces clic en el ícono, se mostrarán los detalles.

Captura de pantalla de un error de validación del agente

Resultados de la validación con la API

En la mayoría de los casos, verás los resultados de la validación a través de la consola de Dialogflow. Sin embargo, también puedes acceder a estos datos desde la API.

REST Y LÍNEA DE COMANDOS

Realiza una llamada al método getValidationResult en el tipo Agents.

Antes de usar cualquiera de los datos de solicitud que se muestran a continuación, realiza los siguientes reemplazos:

  • project-id: el ID de tu proyecto de GCP

Método HTTP y URL:

GET https://dialogflow.googleapis.com/v2beta1/projects/project-id/agent/validationResult?languageCode=en

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Fuerza la validación

Los resultados de la validación del agente se encuentran disponibles de forma automática cada vez que se realiza y completa la capacitación de un agente. Para forzar los resultados de una nueva validación, puedes inhabilitar la validación automática y activarla de forma manual. Consulta la página Configuración del AA de los agentes en la consola.