Validación del agente

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 desvío.
• 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 ES.
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.

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 ES.
2. Selecciona el agente.
3. Haz clic en Validación en el menú de la barra lateral.

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 error_outline junto a su nombre.

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).

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.

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.

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.

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

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.

GET https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/validationResult?languageCode=en

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"

$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

{
  "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:

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.