Depurar um tópico Virtual Agent

Investigue e resolva comportamentos inesperados em seus tópicos personalizados Virtual Agent, blocos de tópicos e controles.

Para obter informações sobre problemas de descoberta de tópico, consulte Descoberta de tópico do LLM no Virtual Agent e Resolver problemas de descoberta do tópico Compreensão da linguagem natural (NLU).

Duplicar um tópico dinâmico antes de depurá-lo e alterá-lo

Duplique um tópico em vez de atualizar um tópico dinâmico. O tópico original não modificado pode servir como referência e backup, e manter o original permite que você restaure o tópico rapidamente. Lembre-se de desativar o tópico original antes de publicar a duplicata.

Depurar um tópico ao testar suas conversas

Conforme você cria ou atualiza um tópico em Designer do Virtual Agent, use o botão Teste na barra de cabeçalho do tópico para visualizar a conversa. A janela de teste de bate-papo mostra a conversa como ela aparece em Portal de serviços. Elementos em sua conversa podem aparecer de forma diferente em aplicações de mensagens de terceiros. Teste suas conversas em qualquer aplicação de terceiros onde você pretenda implantar Virtual Agent.

A janela de bate-papo de teste exibe quatro guias que fornecem informações detalhadas para depurar e refinar seu tópico: Analisar frases de teste, Variáveis, Contexto e Logs. Para obter detalhes sobre essas guias, consulte Como testar tópicos de NLU/Palavra-chave. O exemplo a seguir mostra as mensagens de processamento e os erros registrados durante o teste.

Fique atento a avisos nos controles do seu tópico

Figura 1. Avisos em um nó de tópico na guia Fluxo

Os controles que não têm informações necessárias mostram um ícone vermelho no canto superior esquerdo do controle. O selo mostra um número indicando o número de problemas nesse controle. Selecione este selo para ver uma lista dos problemas no controle.

Outro selo de aviso aparece no canto superior esquerdo da tela para indicar o número de problemas em todo o tópico.

Verificar se há erros quando uma visualização de tópico não é executada

Figura 2. Erros de visualização de tópico na tela

As informações adicionais aparecem em uma guia Problemas de validação na barra lateral da tela Designer do Virtual Agent quando um erro impede a execução do tópico. O número total de problemas é listado, junto com detalhes e um hiperlink para cada nó. Selecione um link para acessar o nó e use as informações fornecidas para corrigir erros em sua conversa. Você pode fechar a guia sem corrigir os problemas, mas até que os problemas sejam corrigidos, a guia Problemas de validação aparecerá quando você selecionar Publicar. A guia Problemas de validação será fechada se você selecionar Publicar após corrigir todos os problemas.

Problemas comuns Virtual Agent

Problema	Possível resolução
Não é possível ver o designer do módulo em Interfaces conversacionais	O usuário pode não ter a função virtual_agent_admin. O plug-in Virtual Agent pode não estar ativado.
Não é possível editar um tópico	O usuário conectado deve estar no mesmo escopo da aplicação que o tópico.
Não é possível visualizar o tópico	Certifique-se de que todos os campos obrigatórios estejam preenchidos nas propriedades do nó. Certifique-se de que seu navegador esteja configurado para permitir pop-ups de sua instância.
widget de bate-papo travado em Conectando...	Um ou mais tópicos podem estar ausentes. Verifique o para garantir que os tópicos estejam presentes na instância e no estado Ativo.

Revisar tópicos que são executados em um fluxo de conversa

Cada conversa Virtual Agent (VA) em uma instância gera automaticamente um registro de interação na tabela Interações [interações], que registra a conversa entre um solicitante e um agente virtual. Você pode revisar a transcrição da conversa entre o solicitante e o agente virtual, incluindo transferências de atendente (se estiver usando o bate-papo do agente). Para obter detalhes, consulte Registros de interação do Virtual Agent.

• Resolver problemas de descoberta do tópico Compreensão da linguagem natural (NLU)
  Se uma intenção não estiver sendo escolhida quando esperado, você poderá solucionar os erros de previsão do NLU.
• Lógica de descoberta de tópico de Compreensão da linguagem natural em Virtual Agent
  Entenda como Virtual Agent retorna as intenções e como ele seleciona quais intenções serão mostradas ao usuário.