--- sourceDocument: Interfaces conversacionais do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Interfaces conversacionais do Xanadu ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Depurar um tópico Virtual Agent # Depurar um tópico Virtual Agent {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura 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ópicos, consulte [Resolver problemas de descoberta do tópico Compreensão da linguagem natural (NLU)](https://servicenow-prod.fluidtopics.net/TCuLVtY4Lh4ORmBBaCLDPA "Se uma intenção não estiver sendo escolhida quando esperado, você poderá solucionar os erros de previsão do NLU."). ## Duplicar um tópico dinâmico antes de depurá-lo e alterá-lo {#virtual-agent-troubleshooting-guide__section_bbn_d12_d2b} 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 {#virtual-agent-troubleshooting-guide__section_ehd_j5d_12b} 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](https://servicenow-prod.fluidtopics.net/tci1nrs56ZvKMpuWRZ1ZAg "Use a janela de teste de bate-papo para visualizar, testar e depurar tópicos de Compreensão da linguagem natural (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 {#virtual-agent-troubleshooting-guide__section_plt_gbx_c2b} 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 do designer 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 {#virtual-agent-troubleshooting-guide__section_pzf_vkd_12b} Figura 2. Erros de visualização de tópico na tela Informações adicionais aparecem na 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 link para cada um. Selecione um link para acessar o nó e use as informações fornecidas para corrigir erros em sua conversa. ## Problemas comuns Virtual Agent {#virtual-agent-troubleshooting-guide__section_trx_w3z_12b} {#virtual-agent-troubleshooting-guide__table_j3r_2jz_12b__entry__2} | 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. {#virtual-agent-troubleshooting-guide__ul_tfv_mwf_d2b} | | 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. {#virtual-agent-troubleshooting-guide__ul_d1l_wvf_d2b} | | Cliente Web travado em Conectando ... | Um ou mais tópicos podem estar ausentes. Verifique a página Tópicos para garantir que os tópicos estejam presentes na instância e no estado Ativo. | [ ] {#virtual-agent-troubleshooting-guide__table_j3r_2jz_12b} ## Revisar tópicos que são executados em um fluxo de conversa {#virtual-agent-troubleshooting-guide__section_dc2_vgl_xhb} 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](https://servicenow-prod.fluidtopics.net/rjxD6tMxWvyqfKgnw3u4nQ "Sempre que uma conversa do Virtual Agent ocorre, um registro de interação captura toda a conversa como um tipo de registro de bate-papo na tabela Interações [interaction]. O registro inclui todos os elementos de tópico usados na conversa, bem como as transferências para o atendente."). * **[Resolver problemas de descoberta do tópico Compreensão da linguagem natural (NLU)](https://servicenow-prod.fluidtopics.net/TCuLVtY4Lh4ORmBBaCLDPA)** 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](https://servicenow-prod.fluidtopics.net/cuNUXL7dQC9sZiIFHXjY0Q)** Entenda como Virtual Agent retorna as intenções e como ele seleciona quais intenções serão mostradas ao usuário.