Validación de agentes

Como se discutió en la página Diseño de agentes, el diseño de tu agente puede influir en gran medida en la calidad del agente. Para ayudar a los diseñadores de agentes a crear agentes de alta calidad, Dialogflow proporciona una característica 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 la API.

Los resultados de validación son solo informativos. Proporcionan una lista de errores que debes corregir para mejorar la calidad y el rendimiento del agente. Si el agente tiene errores, puedes ignorarlos y, luego, iniciar el agente. La validación de agentes no afecta el comportamiento de un agente de ninguna manera.

Estos son algunos resultados de ejemplo que 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 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 la página de la lista de entidades, los intents o las entidades con errores de validación tendrán un indicador de error 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 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, el ícono de la validación se muestra 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 siguientes datos de solicitud, realiza los siguientes reemplazos:

  • project-id: Es el ID del proyecto de GCP.

Método HTTP y URL:

GET https://dialogflow.googleapis.com/v2/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'"
    },
  ]
}

Estados de gravedad

La validación puede mostrar los siguientes estados de gravedad:

Gravedad Descripción
INFO El agente no sigue las prácticas recomendadas.
WARNING Es posible que el agente no se comporte como se espera.
ERROR El agente puede experimentar fallas parciales.
CRÍTICO El agente puede fallar por completo.
SEVERITY_UNSPECIFIED No especificado Este valor nunca debe usarse. (Esta gravedad es posible a través de la API)

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 de AA de agentes en la consola.

Controla muchos problemas

Cuando se detecta una gran cantidad de problemas, esto es lo que debes considerar:

  • Soluciona los problemas en lotes pequeños. Si hay muchos problemas similares, solucionar un problema puede resolver problemas similares después de volver a entrenar el agente.
  • Se muestran, como máximo, 5,000 problemas a la vez. Si tienes más de 5,000 problemas, es posible que no veas una reducción del recuento hasta que queden menos de 5,000.