Como testar tópicos de NLU/Palavra-chave

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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 estiver configurado para sua instância, você também poderá executar a janela de teste na aplicação Microsoft Teams.

    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.

    Nota:
    Se o painel do Now Assist ou a aplicação Microsoft Teams estiverem configurados para o seu ambiente, as opções de visualização desses canais serão exibidas na lista de botões de teste. 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 na tela Designer do Virtual Agent e na página de tópicos.
    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. Você também pode testar tópicos ativos (publicados) selecionando Testar tópicos de NLU/palavra-chave no botão Testar tópicos ativos na página Tópicos.
    Nota:
    Se o seu tópico não tiver materiais necessários, um selo de incompleto aparecerá 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ó. Selecionar Testar quando há problemas presentes abre uma janela Problemas na parte inferior, que conta e detalha todos os problemas que precisam de correção. Esses detalhes incluem uma descrição completa e um hiperlink para cada item incompleto.
    A janela de teste de bate-papo é aberta no cliente Web 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 do 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 a opção ou as subopções Testar tópicos ativos da página Tópicos, a descoberta de tópicos estará habilitada e, portanto, não será 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
    Analisar guia de frases de teste, mostrando resultados de frases 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 de 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.