Validação do agente

Conforme abordado na página Design do agente, o design do seu agente pode influenciar bastante a qualidade do mesmo. Para ajudar os criadores de agentes a criar agentes de alta qualidade, o Dialogflow oferece uma funcionalidade de validação. Os resultados da validação do agente estão disponíveis automaticamente sempre que o agente é preparado e a preparação é concluída. Pode aceder aos resultados da validação a partir da consola do Dialogflow ou da API.

Os resultados da validação são apenas informativos. Fornecem uma lista de erros que deve corrigir para melhorar a qualidade e o desempenho do seu agente. Se o seu agente tiver erros, pode optar por ignorá-los e iniciar o agente. A validação de agentes não afeta o comportamento de um agente de forma alguma.

Seguem-se alguns exemplos de resultados que pode encontrar:

• A intenção tem expressões de preparação demasiado semelhantes.
• A intenção contém um parâmetro que não é usado em frases de preparação suficientes.
• Não existem exemplos negativos para a intenção de recurso.
• Este texto está anotado em algumas expressões de preparação, mas não noutras.

Ative e desative a validação automática

Por predefinição, a validação do agente é realizada automaticamente sempre que o agente é preparado. Pode ativar e desativar esta definição:

1. Aceda à consola do Dialogflow ES.
2. Selecione o seu agente.
3. Clique no ícone de definições settings junto ao nome do agente.
4. Selecione o separador Definições de ML.
5. Ative (predefinição) ou desative a definição Validação do agente.

Página de validação do agente

Para aceder aos dados de validação do seu agente:

1. Aceda à consola do Dialogflow ES.
2. Selecione o seu agente.
3. Clique em Validação no menu da barra lateral.

Resultados da validação para intenções e entidades

Quando visita as páginas da lista de intenções ou da lista de entidades, as intenções ou as entidades com erros de validação mostram um indicador de erro error_outline junto ao nome.

Quando visita uma página para uma entidade ou uma intenção específica que tem erros de validação, é apresentado um indicador error_outline de erro junto ao botão Guardar.

Se clicar neste botão, é apresentada uma lista de erros para a intenção ou a entidade. Por predefinição, apenas são apresentados erros com uma gravidade de CRITICAL ou ERROR. Pode ativar/desativar os tipos de gravidade para também mostrar WARNING e INFO.

Também pode ver indicadores de erro para parâmetros e expressões de preparação específicos. Pode passar o cursor do rato sobre estes indicadores para ver os detalhes.

Resultados da validação para versões e ambientes

Quando visualiza as versões e os ambientes, cada versão do agente pode ter erros de validação únicos. Se existirem erros, o ícone de validação é apresentado junto à versão.

Se clicar no ícone, são apresentados os detalhes.

Resultados da validação com a API

Na maioria dos casos, vê os resultados da validação através da consola do Dialogflow. No entanto, também pode aceder a estes dados a partir da 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 gravidade

A validação pode apresentar os seguintes estados de gravidade:

Forçar validação

Os resultados da validação do agente estão disponíveis automaticamente sempre que o agente é preparado e a preparação é concluída. Para forçar novos resultados da validação, pode desativar a validação automática e acioná-la manualmente. Consulte a página Definições de ML do agente na consola.

Processamento de muitos problemas

Quando são encontrados muitos problemas, deve considerar o seguinte:

• Corrija problemas em pequenos lotes. Se existirem muitos problemas semelhantes, a correção de um problema pode corrigir problemas semelhantes depois de voltar a formar o agente.
• São apresentados, no máximo, 5000 problemas de cada vez. Se tiver mais de 5000 problemas, pode não ver uma redução na contagem até ficarem menos de 5000.