Depure um Virtual Agenttópico

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura
  • Investigue e resolva o comportamento inesperado em seu personalizado Virtual Agenttópicos, blocos de tópicos e controles.

    Para obter informações sobre problemas de descoberta de tópicos, consulte Descoberta de tópico de LLM em Virtual Agente. Resolver Compreensão da linguagem natural(NLU) Problemas de descoberta de tópico.

    Duplique um tópico dinâmico antes de depurar e alterá-lo

    Duplicar 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 restaurar o tópico rapidamente. Lembre-se de desativar o tópico original antes de publicar a duplicata.

    Depure um tópico ao testar suas conversas

    À medida que você cria ou atualiza um tópico em Designer do Virtual Agent, use o. Teste botão 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 Portal de serviços. 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 em que você pretende 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: Analise frases de teste , Variáveis , Contexto e. Logs . Para obter detalhes sobre essas guias, consulte Teste NLU/Tópicos de palavra-chave. O exemplo a seguir mostra as mensagens de processamento e os erros registrados durante o teste.

    Logs de visualização da conversa mostrados na janela de visualização do tópico.

    Fique atento a avisos sobre controles em seu tópico

    Figura 1. Avisos em um nó de tópico na guia Fluxo
    Número de avisos mostrados em vermelho na tela e nos controles individuais. Para o controle Entrada de usuário de texto, o Nome do nó e o prompt são obrigatórios

    Os controles sem as informações necessárias mostram um selo vermelho incompleto no canto superior esquerdo do controle. O selo mostra um número que indica o número de ocorrências 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 ocorrências em todo o tópico.

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

    Figura 2. Erros de visualização de tópico na tela
    A janela do validador de tópico que fornece uma visualização dos erros na tela.

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

    Comum Virtual Agentproblemas

    Ocorrência Possível resolução
    Não é possível ver o designer de módulo nas interfaces conversacionais
    • O usuário pode não ter a função virtual_agent_admin.
    • Virtual Agent o plug-in 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 o navegador esteja configurado para permitir pop-ups da sua instância.
    Widget de bate-papo travado na conexão... Um ou mais tópicos podem estar ausentes. Verifique para garantir que os tópicos estejam presentes na instância e no estado Ativo.

    Revise tópicos executados em um fluxo de conversa

    Cada Virtual Agent(VA) A conversa 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 e ao vivo. Você pode revisar a transcrição da conversa entre o solicitante e o virtual agent, incluindo transferências do atendente (se estiver usando o bate-papo do agente). Para obter detalhes, consulte Registros de interação do Virtual Agent .