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.

Dicas rápidas de solução de problemas

Se um Virtual Agent não estiver sendo descoberto, verifique o seguinte:

O NLU está habilitado para o idioma da sessão?

Ative o idioma nas configurações em Compreensão da linguagem natural (NLU) para . Virtual Agent. Para obter detalhes, consulte Habilitar idiomas NLU nas configurações Virtual Agent.

O Modelo de NLU foi treinado e publicado para o idioma da sessão?

Seu tópico pode não estar usando as mudanças mais recentes no seu modelo. Para NLU ServiceNow®, consulte Treinamento e teste do seu modelo NLU e Publicar um tópico Virtual Agent.

O tópico Virtual Agent é publicado, detectável e vinculado a um modelo e intenção de NLU publicados para o idioma da sessão?

O tópico deve ser vinculado a um único modelo e intenção para um determinado idioma. Certifique-se de que não haja intenções duplicadas vinculadas a outros tópicos. Verifique se o tópico, o modelo e a intenção estão no mesmo domínio. Para obter mais informações, consulte Publicar um tópico Virtual Agent.

Há funções ou condições especificadas para o tópico Virtual Agent na guia Propriedades no Virtual Agent Designer?

Se o tópico for mostrado somente para determinadas funções ou para determinadas condições, isso poderá impedir a descoberta do tópico. Para obter detalhes, consulte Guia Propriedades do tópico.

Por que Virtual Agent descobriu meu tópico em espanhol, mas não em francês?

Existem várias possibilidades:

• Nem todos os idiomas são compatíveis com todos os provedores de NLU. Para obter detalhes, consulte Suporte a idiomas para serviços NLU.
• Nem todos os tópicos estão vinculados a um modelo de NLU e a uma intenção específica do idioma.
  Por exemplo, o Tópico A pode ser mapeado da seguinte forma:

  • Vinculado ao Modelo A e à Intenção A para o inglês
  • Vinculado ao Modelo A e à Intenção A para o espanhol
  • NÃO vinculado a um modelo ou intenção para o francês

  Neste cenário, crie um modelo em francês e uma intenção para o tópico. Para obter mais informações, consulte Gestão de modelos multilíngue.

Por que uma vaga de variável de tópico NÃO preencheu?

Verifique o seguinte:

• O nó de entrada do usuário do tópico não foi configurado com uma entidade associada. Use a propriedade da Entidade NLU para o nó em Designer do Virtual Agent.

  

• O resultado da previsão continha uma entidade NLU com uma pontuação de confiança inferior ao limite de confiança configurado.
• O valor da entidade NLU para o nó era inválido. Por exemplo, você não pode aplicar a palavra "vermelho" a um tipo de entidade de Data / Hora.

Teste a descoberta do tópico.

Siga um destes procedimentos:

• Na página inicial, deslize o comutador de alternância de tipo de descoberta para NLU/Palavra-chave e selecione Testar tópicos de NLU/palavra-chave . Insira seu enunciado e observe a guia Analisar frases de teste.
• Abra o tópico em Designer do Virtual Agent e selecione Teste. Na janela Teste, marque a caixa de seleção Incluir descoberta de tópico. Insira seu enunciado e observe a guia Analisar frases de teste.

Para obter detalhes, consulte Como testar tópicos de NLU/Palavra-chave. Para obter uma compreensão de como a descoberta de tópico funciona, consulte Lógica de descoberta de tópico de Compreensão da linguagem natural em Virtual Agent.

"Tópico de configuração" é o tópico em questão?

Em caso afirmativo, ele precisa ser definido em Interfaces conversacionais Configurações de bate-papo para ser descoberto. Para obter detalhes, consulte Configurar uma experiência Virtual Agent de bate-papo.

Perguntas ou problemas com a alternância de tópico no meio.

Por que a conversa retornou ao tópico A após Virtual Agent alternada para o tópico B?

O fluxo do tópico Retomar após a habilitação do atributo de alternância de tópico no tópico. Este interrutor de alternância pode ser encontrado em Propriedades em Propriedades avançadas > Adicional.

Por que a conversa retornou ao tópico A após Virtual Agent alternada para o tópico B?

O atributo Continuar fluxo de tópico após troca de tópico é desativado no tópico. Este interrutor de alternância pode ser encontrado em Propriedades em Propriedades avançadas > Adicional.

Se Virtual Agent não encontrar uma intenção, ele usará uma pesquisa de palavra-chave no mid-topic?

Não.

As variáveis do Tópico A estão disponíveis para o Tópico B após a alternância?

Não.

As variáveis do tópico B estão disponíveis para o tópico A quando o tópico A é reiniciado?

Não.

Para solução de problemas adicional, verifique as informações nas tabelas a seguir.

Verifique as informações de previsão de NLU nas tabelas de NLU abertas

Ao revisar ou depurar tópicos que usam Compreensão da linguagem natural (NLU), você pode usar várias tabelas de NLU abertas para exibir os resultados de previsão de NLU para seus tópicos. Por exemplo, as tabelas Feedbacks de intenção de previsão de NLUs e Feedbacks de entidade de NLUs abertas fornecem informações detalhadas sobre o processamento de NLU realizado por aplicações (como Virtual Agent) para determinar a intenção e as entidades do tópico (preenchimento de slot).

Abra a tabela de feedbacks de intenção de previsão de NLUs

A tabela Feedbacks de intenção de previsão de NLUs abertas [open_nlu_predict_intent_feedback] mostra o processamento de intenção que uma aplicação (neste caso Virtual Agent) executa em resposta a um resultado de previsão de intenção de NLU. O objetivo de Virtual Agent é mapear uma intenção NLU prevista para um tópico Virtual Agent. Sempre que Virtual Agent sugere um tópico, um registro do resultado da previsão é adicionado a esta tabela. Se Virtual Agent não encontrar um tópico, nenhuma previsão ocorrerá e um registro marcado como Skipped será adicionado a esta tabela.

Para visualizar a tabela, navegue até Todos e insira open_nlu_predict_intent_feedback.list no filtro de navegação.

Tabela 1. Campos-chave na tabela Feedbacks de intenção de previsão de NLUs abertas

Campo	Descrição
App	Aplicação usando NLU. Por exemplo: VA (Virtual Agent).
Documento do aplicativo	sys_id do registro da aplicação. Por exemplo: sys_cs_topic.sys_id.
Tabela de documentos do aplicativo	Tabela do registro da aplicação. Por exemplo: sys_cs_topic (Tabela de tópicos).
Selecionado automaticamente	Booleano que indica se o sistema detectou apenas uma intenção acima do limite de previsão e, portanto, a aplicação optou por executar o tópico que correspondeu à mesma intenção: true ou false.
Intenção Atual	Intenção de NLU que foi usada pela aplicação quando a previsão de NLU foi enviada. Este campo pode ficar em branco (em branco). Por exemplo, uma intenção usada na Virtual Agent aplicação pode ser Change password.
Domínio	O domínio da intenção. Por exemplo, Global ou ITSM.
Nome de exibição do modelo externo	Nome do modelo de NLU externo. Por exemplo, o nome da aplicação NLU IBM Watson Assistant.
Causador da alternância de intenção	Nome do tópico de origem que solicita a confirmação do usuário. Existem dois cenários possíveis para os valores nesta coluna: O usuário é solicitado a confirmar a correspondência de intenção inicial do enunciado (Pergunte ao usuário se o tópico que o VA escolheu se o comutador correto está habilitado em Configurações de NLU). Se o usuário for solicitado a fornecer um enunciado inicial, este valor poderá ser o tópico Saudações. Se o valor for empty, o usuário não foi solicitado a fornecer a correspondência inicial ou o usuário rejeitou a intenção de tópico correspondente inicialmente. O usuário é solicitado a confirmar uma troca de intenção no meio do tópico (Pergunte ao usuário se o tópico trocado está correto , a chave de alternância está habilitada nas configurações de NLU). Se uma alternância for solicitada ao usuário no mid-topic, este valor será o nome do tópico que ele estava exibindo no momento da alternância. Nota: Tarefas do sistema também podem ser exibidas aqui, que você pode ignorar. Por exemplo: __silent_TerminateGoal_a3817a5f7ca7439b8.
Tarefa atual do causador da alternância de intenção	Nome da tarefa (nó) da qual o usuário alterna. Nota: Tarefas do sistema também podem ser exibidas aqui, que você pode ignorar. Por exemplo: __silent_TerminateGoal_a3817a5f7ca7439b8.
Mapeado	Booleano que indica se a aplicação (Virtual Agent) considerou a previsão utilizável, correspondendo a intenção a um tópico disponível: true ou false.
Nome de exibição do modelo	Nome do modelo de NLU ServiceNow.
ID do modelo	ID do modelo de NLU para o qual a previsão foi enviada.
Nome do modelo	Nome do modelo de NLU para o qual a previsão foi enviada.
Resultado da Descoberta de tópico NLU	Resultado de previsão para enunciado inicial em uma conversa como parte da descoberta de tópico: Fallback da Pesquisa com IA: nenhuma previsão foi feita. Pesquisa com IA foi usado como fallback. Correto: uma única previsão foi feita. O usuário confirmou que o tópico estava correto. Correto entre vários: várias previsões foram feitas. Este resultado indica que o usuário selecionou esta previsão. Outros registros de previsão são marcados como Sem categoria. Saiu sem confirmação: o usuário sai sem confirmação. Incorreto: uma única previsão foi feita. O usuário confirmou que o tópico estava incorreto. Incorreta entre várias: várias previsões foram feitas, mas o usuário não selecionou nenhum dos tópicos sugeridos. Este resultado indica que esta previsão teve o maior valor de Confiança de previsão. Outros registros de previsão são marcados como Sem categoria. Previsão do tópico de configuração: a previsão relacionada ao tópico de configuração foi feita sem o uso do Pesquisa com IA. Ignorado: nenhuma previsão foi feita. Ignorado com o novo enunciado: quando o menu Tópico foi exibido, o usuário digitou um novo enunciado. Sem categoria: nenhuma das condições acima foi atendida ou o usuário abandonou a conversa.
Idioma do modelo NLU	Idioma do modelo NLU usado para a previsão.
Previsão	Nome da intenção prevista.
Log de auditoria de previsão	Referência à tabela Logs de previsão de NLUs abertas [open_nlu_predict_log].
Confiança da previsão	Valor de confiança da previsão.
Idioma da sessão do solicitante	Código do idioma da sessão do solicitante quando Tradução dinâmica estiver habilitado. Por exemplo, se o usuário digitar em francês, o código fr será armazenado. Se a detecção de idioma estiver habilitada e o usuário inserir texto em um idioma que não seja o padrão, Virtual Agent solicitará que o usuário confirme o idioma. Se confirmado, o idioma detectado se tornará o valor padrão da sessão.
Selecionado	Booleano que indica se as várias intenções previstas mostradas aos usuários finais como tópicos correspondentes foram realmente selecionadas pelos usuários finais: true ou false.
Mostrado	Booleano que indica se a aplicação (Virtual Agent) exibiu a intenção prevista como uma opção para o usuário final selecionar: true ou false.
Tópico alternado	Nome do tópico, se a confirmação foi solicitada ao usuário (independentemente de sua escolha, sim ou não).
Enunciado	Frase inserida pelo usuário final na janela do cliente de bate-papo.

Abrir a tabela de feedbacks de entidades de previsão de NLUs

A tabela Feedbacks de entidades de previsão de NLUs [open_nlu_predict_entity_feedback] mostra o processamento de entidade (preenchimento de slot) que uma aplicação (neste caso ) Virtual Agent executa em resposta a um resultado de previsão de entidade NLUs. Por exemplo, em Virtual Agent o objetivo é mapear uma entidade NLU prevista para uma variável de entrada em um tópico Virtual Agent.

Para visualizar a tabela, insira open_nlu_predict_entity_feedback.list no filtro de navegação.

Tabela 2. Campos-chave na tabela Feedbacks de intenção de previsão de NLUs abertas

Campo	Descrição
App	Aplicação usando NLU. Por exemplo, VA (Virtual Agent).
Documento do aplicativo	sys_id do registro da aplicação. Por exemplo: sys_cs_topic.sys_id.
Tabela de documentos do aplicativo	Tabela do registro da aplicação. Por exemplo: sys_cs_topic.
Selecionado automaticamente	Booleano que indica se a aplicação optou automaticamente por usar a entidade sem notificar o usuário: true ou false.
Nome de exibição do modelo externo	Nome do modelo de NLU externo. Por exemplo, o nome da aplicação IBM Watson Assistant NLU.
Mapeado	Booleano que indica se a aplicação (Virtual Agent) considerou a previsão utilizável: true ou false.
Mapeado para	Item na aplicação para a qual a entidade foi mapeada.
Nome de exibição do modelo	Nome do modelo de NLU ServiceNow.
ID do modelo	ID do modelo de NLU para o qual a previsão foi enviada.
Nome do modelo	Nome do modelo de NLU para o qual a previsão foi enviada.
Previsão	Nome da entidade prevista.
Log de auditoria de previsão	Referência à tabela Logs de previsão de NLUs abertas [open_nlu_predict_log].
Confiança da previsão	Valor de confiança para a previsão.
Selecionado	Booleano que indica se a aplicação foi selecionada para usar a entidade: true ou false.
Mostrado	Booleano que indica se a aplicação exibiu a entidade prevista para o usuário final como escolha para selecionar: true ou false.
Enunciado	Frase inserida pelo usuário final na janela do cliente de bate-papo.
valor	Valor da entidade prevista.

Abrir Logs de Previsão de NLU

A tabela Logs de previsão de NLUs abertas [open_nlu_predict_log] fornece uma visão geral consolidada dos registros de previsão de NLUs para tópicos. Cada registro no log identifica o enunciado e as intenções (tópicos) e entidades correspondentes determinadas pelo serviço de NLU. Cada registro também inclui as pontuações de previsão do NLU calculadas durante a descoberta de tópico (correspondência de intenção) e a extração de entidade.

Nota:

Os logs do nó de previsão do NLU são gerados automaticamente. Se você estiver usando logs de nó para depuração, mas quiser suprimir a geração automática de logs de nó de previsão de NLU, adicione a propriedade do sistema com.glide.opennlu.predict.node_logging_enabled e defina o valor como falso.

Para visualizar os Logs de previsão de NLUs abertas, insira open_nlu_predict_log.list no filtro de navegação.

Tabela 3. Campos-chave na tabela Logs de previsão de NLUs abertas

Campo	Descrição
Assíncrono	Indicador para processamento de previsão assíncrona: true ou false. Verdadeiro indica que a previsão foi realizada de forma assíncrona, permitindo que os threads de trabalho Virtual Agent continuem.
Criado	Data e hora em que o registro de previsão NLU foi criado.
Duração	Período de tempo de processamento para a previsão retornar valores de intenção e entidade.
Idioma	O idioma da solicitação de previsão do NLU.
Nível	Tipo de mensagem: nível de informação.
Mensagem	Resultados de previsão retornados: número de intenções e entidades.
Solicitação	Parâmetro de previsão da NLU que contém o enunciado e o modelo de NLU para a intenção reconhecida.
Resposta	Resultados de previsão da NLU, que contêm 0 (nenhuma) ou mais intenções e entidades pontuadas.
Fonte	Processo ou área: OpenNLU - Predict.
Enunciado	Declaração do usuário reconhecida pelo bot, que é mapeada para uma intenção definida em um modelo de NLU.

Nota:

Você pode exibir os resultados detalhados da intenção e da entidade nas tabelas Feedbacks de intenção de previsão de NLUs abertas e Feedbacks de entidade de NLUs abertas.

Revise as informações de conexão HTTP para integrações de NLU abertas

Use a tabela Abrir conexão HTTP do driver de NLU [open_nlu_driver_http_connection] para verificar rapidamente as credenciais HTTP, os detalhes da conexão e os métodos das intenções, entidades, modelos de NLU e previsões do provedor de serviços de NLU.

Para visualizar a tabela, insira open_nlu_driver_http_connection.list no filtro de navegação.