Como testar tópicos de NLU/Palavra-chave

  • Versão de lançamento: Zurich
  • Atualizado 6 de ago. de 2025
  • 5 min. de leitura
  • Use a janela de teste de bate-papo para visualizar, testar e depurar tópicos de Compreensão da linguagem natural (NLU)/Palavra-chave.

    Ao trabalhar em um tópico em Designer do Virtual Agent, é possível executar sua conversa em uma janela de teste de bate-papo. A janela de teste padrão é o cliente de bate-papo da Web (Portal de serviços).

    Se você estiver usando as Integrações com Virtual Agent com apps de mensagens envio de mensagens terceiros, os elementos na sua conversa poderão aparecer de formas diferentes em aplicações de envio de mensagens de terceiros. Teste suas conversas em qualquer aplicação de terceiros onde você quiser implantar o Virtual Agent.

    . Now Assist painel, Microsoft Teams ou Slack A aplicação está configurada para o seu ambiente, as opções de visualização desses canais são exibidas na lista do botão Testar. Clique em Visualizar no painel do Now Assist ou em Exibição no Microsoft Teams na lista para testar seu tópico nesses ambientes.

    Como testar seu tópico de NLU/Palavra-chave na janela de teste de bate-papo

    Figura 1. Exemplo de opções de teste de NLU/palavra-chave
    As opções de teste de NLU/palavra-chave estão disponíveis em ambos Designer do Virtual Agent tela e a página inicial.
    Para executar o tópico na janela de teste do bate-papo, clique na opção Testar na barra de cabeçalho do tópico. Como alternativa, você pode testar tópicos ativos (publicados) selecionando Testar tópicos ativos durante a exibição NLU tópicos na página inicial.
    Nota:
    Se o tópico não tiver as informações necessárias, um selo incompleto será exibido no canto do painel do diagrama de fluxo. Um selo de aviso amarelo ou vermelho também vai aparecer ao lado de cada nó. O selo incompleto lista o número total de problemas, enquanto os selos de aviso locais mostram quantos foram encontrados em cada nó. Selecionando Teste Quando há problemas presentes, abre uma guia Problemas de validação na barra lateral, que conta e detalha todos os problemas que precisam de correção. Esses detalhes incluem uma descrição completa e um hiperlink para cada nó incompleto.
    A janela de teste de bate-papo é aberta no widget de bate-papo e exibe guias adjacentes que fornecem detalhes sobre o tópico conforme você o testa. Você pode usar estas guias:
    • Analisar frases de teste: os resultados da correspondência de intenção e do reconhecimento de entidade são exibidos com base no que você inseriu na conversa.
    • Variáveis - Lista de todas as variáveis usadas na conversa, como variáveis de entrada e atendente.
    • Contexto: opções para especificar o contexto (usando variáveis de contexto) no qual um tópico será executado.
    • Logs: uma lista do processamento realizado.
    Figura 2. Exemplo de janela de teste de bate-papo de Compreensão da linguagem natural (NLU) e guias de teste
    Guias de teste de conversa mostradas na janela de teste de bate-papo, com as opções Analisar frases de teste, variáveis, contexto e logs realçadas.

    Por padrão, a opção Incluir Descoberta de tópico está habilitada. Esta opção executa automaticamente a descoberta de tópicos e gera resultados de previsão para tópicos de NLU usando frases de teste que você insere na janela de teste. A conversa começa com a saudação Virtual Agent e o botão do menu de tópicos disponíveis.

    Se você estiver usando Testar tópicos ativos opção ou suboções na página inicial, a descoberta de tópicos está habilitada, portanto, não está listada como uma opção. O teste de tópicos ativos se comporta da mesma forma que o teste de um tópico, exceto que os casos de teste não podem ser criados.

    Analisar a guia de frases do teste

    Para tópicos habilitados para NLU, a guia Analisar frases de teste fornece uma análise das possíveis intenções que correspondem à frase de teste (enunciado) que você inseriu na janela de teste de bate-papo. A guia lista os resultados de previsão, que incluem intenções correspondentes e suas pontuações de previsão, junto com qualquer reconhecimento de entidade e resultados de preenchimento de slot. A principal correspondência é listada primeiro. As intenções previstas dependem do limite de confiança de previsão definido no serviço de NLU.

    Figura 3. Exemplo da guia Analisar frases de teste para tópicos de NLU/Palavras-chave
    Guia Analisar frases de teste, mostrando os resultados da frase de teste para várias correspondências de intenção.

    Se um enunciado não corresponder a uma intenção atual, você poderá adicionar ou alterar os enunciados em Designer do Virtual Agent. Para obter mais informações, consulte Modificar enunciados e entidades NLU para um tópico Virtual Agent.

    Faça mudanças, treine o modelo novamente e teste novamente até ficar satisfeito com os resultados. Quando o tópico estiver pronto, você poderá publicar o tópico e o modelo de Designer do Virtual Agent.

    Guia Variáveis

    A guia Variáveis exibe uma lista de todas as variáveis usadas na conversa e os valores associados capturados conforme o andamento da conversa, para que você possa acompanhar. Uma conversa pode ter estes tipos de variáveis:
    • Variáveis de entrada
    • Variáveis do Script
    • Variáveis do atendente
    • Variáveis passadas entre um tópico de chamada e um bloco de tópicos
    • Entidades NLU "sem nó" declaradas como uma variável preenchida por slot para o tópico
    A lista é separada em seções, por tipo de variável. O exemplo a seguir mostra a seção Variáveis de entrada. Observe que, para o controle de lista estática, o rótulo de exibição e o valor são capturados para a opção selecionada.
    Figura 4. Exemplo de lista de variáveis de entrada
    Guia Variáveis que mostra as variáveis de entrada e os valores, ao lado de uma captura de tela do fluxo de conversa.

    O exemplo a seguir mostra a seção Variáveis de entrada para o controle de lista agrupada. Essas informações de variável são exibidas semelhantes ao controle de lista estática, mas as variáveis são separadas por cada grupo da opção agrupada.

    Figura 5. Exemplo de lista de variáveis de opção agrupadas
    Guia Variáveis separada por grupo, com o nó e o nome do grupo realçados.

    Guia Contexto

    Use a guia Contexto para especificar um contexto diferente para o bate-papo. Escolha uma variável de contexto na lista. Essas variáveis contêm informações contextuais que podem ser usadas para determinar a intenção do tópico ou controlar como os bate-papos são encaminhados para atendentes. Por exemplo, você pode selecionar portal na lista de variáveis e inserir o nome do portal, IT Express. A guia Contexto não está disponível ao criar casos de teste.

    Para obter mais informações sobre como definir variáveis de contexto, consulte Como configurar variáveis de contexto para armazenar informações relacionadas ao bate-papo. Para obter mais informações sobre variáveis de agente dinâmico incluídas com Virtual Agent, consulte Variáveis de contexto do atendente..

    Figura 6. Exemplo de guia de contexto
    Guia Contexto com o valor do portal de contexto do IT Express.

    Guia Logs

    A guia Logs exibe o processamento e as mensagens de erro que são registradas durante a execução da conversa. Se você estiver usando scripts em Designer do Virtual Agent, use as instruções gs.log, gs.printe gs.warn em seus scripts para obter informações neste log.

    Figura 7. Guia Logs de Exemplo
    Guia Logs que contém informações de processamento sobre o tópico.

    Próximas etapas

    Quando terminar de testar seu tópico, feche a janela de bate-papo de teste. Se necessário, você pode usar as informações de teste para ajustar sua conversa. Por exemplo, se os resultados na guia Analisar frases de teste retornarem várias correspondências possíveis para o seu enunciado, você poderá atualizar os enunciados para sua intenção e NLU o modelo de na guia Intenção de NLU do seu tópico.