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

REST

Llama al método getValidationResult en la Agents el tipo de letra.

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

• PROJECT_ID: El ID del proyecto de Google Cloud.

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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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

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.