--- sourceDocument: Interfaces conversacionais de Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Interfaces conversacionais de Yokohama ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Resolver Compreensão da linguagem natural(NLU) Problemas de descoberta de tópico # Resolver Compreensão da linguagem natural(NLU) Problemas de descoberta de tópico {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 min. de leitura Se uma intenção não estiver sendo escolhida quando esperado, você poderá solucionar erros de previsão de NLU. ## Dicas rápidas de solução de problemas {#va-topic-discovery-issues__section_nyy_4d3_y5b} Se for um Virtual Agentnão está sendo descoberto, verifique o seguinte: A NLU está habilitada para o idioma da sessão? : Habilite o idioma em Compreensão da linguagem natural(NLU) configurações para Virtual Agent. Para obter detalhes, consulte [Habilite os idiomas de NLU em Virtual Agentconfigurações](https://servicenow-prod.fluidtopics.net/nuQwSR5_voSMg~6B4KdreQ "Se você planeja usar modelos de NLU específicos do idioma, você deve habilitar os idiomas instalados na lista Idiomas de NLU compatíveis. Um idioma será habilitado se Habilitado a coluna exibe verdadeiro. O idioma inglês está habilitado por padrão."). O modelo de NLU é treinado e publicado para o idioma da sessão? : Seu tópico pode não estar usando as mudanças mais recentes em seu modelo. Para ServiceNow®NLU, consulte [Treine e experimente seu modelo de NLU](https://www.servicenow.com/docs/access?context=test-train-nlu-model&version=yokohama&pubname=yokohama-intelligent-experiences&ft:locale=en-US)e. [Publique um Virtual Agenttópico](https://servicenow-prod.fluidtopics.net/CDqxCt5MxByfC2dlIhMpEg "Implante um tópico inativo ou um tópico atualizado para salvá-lo e disponibilizá-lo para os usuários em Virtual Agentclientes."). . Virtual AgentTópico publicado, detectável e vinculado a um modelo de NLU publicado e intenção 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. Certifique-se de que o tópico, o modelo e a intenção estejam no mesmo domínio. Para obter mais informações, consulte [Publique um Virtual Agenttópico](https://servicenow-prod.fluidtopics.net/CDqxCt5MxByfC2dlIhMpEg "Implante um tópico inativo ou um tópico atualizado para salvá-lo e disponibilizá-lo para os usuários em Virtual Agentclientes."). Alguma função ou condição foi especificada para Virtual AgentNa guia Propriedades em Virtual AgentDesigner? : Se o tópico for mostrado somente para determinadas funções ou para determinadas condições, isso poderá impedir a descoberta de tópicos. Para obter detalhes, consulte [Guia Propriedades do tópico](https://servicenow-prod.fluidtopics.net/vqkjgpQw2JEE9qLvB~VnUA "Use o. Propriedades do tópico para identificar um tópico e como ele é usado. Você pode controlar quem usa o tópico e em quais canais ele pode ser executado."). Por que Virtual AgentMeu tópico está em espanhol, mas não em francês? : Há 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 NLUserviços](https://servicenow-prod.fluidtopics.net/yME0whP_DDWgkUaRVUGUTQ "A extração de entidade é compatível em ServiceNowModelos de NLU somente para idiomas específicos. Os idiomas restantes são compatíveis somente com correspondência de intenção. Se você estiver usando IBM Watson Assistantou Microsoft LUIS, os idiomas compatíveis variam."). * Nem todos os tópicos estão vinculados a um modelo e intenção de NLU específicos do idioma. Por exemplo, o tópico A pode ser mapeado da seguinte forma: * Vinculado ao Modelo A e Intenção A para inglês * Vinculado ao Modelo A e Intenção A para espanhol * NÃO vinculado a um modelo ou intenção para francês {#va-topic-discovery-issues__ul_eyy_hm1_1vb}Neste cenário, crie um modelo francês e uma intenção para o tópico. Para obter mais informações, consulte [Gestão de modelos multilíngue](https://www.servicenow.com/docs/access?context=multilingual-model-managent&version=yokohama&pubname=yokohama-intelligent-experiences&ft:locale=en-US). {#va-topic-discovery-issues__ul_jck_rl1_1vb} Por que uma variável de tópico NÃO preencheu o slot? : Verifique o seguinte: * O nó de entrada do usuário do tópico não foi configurado com uma entidade associada. Use o. Entidade de NLU propriedade do nó em Designer do Virtual Agent. ![Especifique uma entidade existente na lista de entidades de NLU.]() * O resultado da previsão continha uma entidade de NLU com uma pontuação de confiança menor que o 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. {#va-topic-discovery-issues__ul_vys_y14_1vb} Teste a descoberta do tópico. : Siga um destes procedimentos: * Na página inicial, deslize a chave de alternância do tipo de descoberta para NLU/Palavra-chave , em seguida, selecione Testar tópicos de NLU/palavra-chave . Insira seu enunciado e observe Analise frases de teste . * Abra o tópico em Designer do Virtual Agent, em seguida, selecione Teste . Na janela Teste, selecione Incluir descoberta de tópico caixa de seleção. Insira seu enunciado e observe Analise frases de teste . {#va-topic-discovery-issues__ul_ffl_pd1_1vb} Para obter detalhes, consulte [Teste NLU/Tópicos de palavra-chave](https://servicenow-prod.fluidtopics.net/3funQNeo26TqdbgfQYxCHQ "Use a janela de teste de bate-papo para visualizar, testar e depurar Compreensão de linguagem natural ( NLU)/Tópicos de palavra-chave."). Para entender como funciona a descoberta de tópicos, consulte [Compreensão da linguagem natural lógica de descoberta de tópicos em Virtual Agent](https://servicenow-prod.fluidtopics.net/wwP5eK4~pcIEA3P8H7R44A "Entenda como Virtual Agentretorna intenções e como ele seleciona quais intenções mostrar ao usuário."). "Tópico de configuração" é o tópico em questão? : Em caso afirmativo, ele precisa ser configurado em Interfaces conversacionaisConfigurações de bate-papo para que ele seja descoberto. Para obter detalhes, consulte [Configure um Virtual Agentexperiência de bate-papo](https://servicenow-prod.fluidtopics.net/irqYZalPmnXB0O8LYLYqUA "Mude o pré-configurado Virtual Agentexperiência de bate-papo padrão ou crie uma experiência de bate-papo personalizada para seus usuários. Você pode configurar tópicos de configuração, especificar tópicos promovidos e, se necessário, mudar o perfil de pesquisa."). Dúvidas ou problemas com a alternância de tópicos intermediários. : Por que a conversa retornou ao tópico A depois Virtual AgentMudou para o tópico B? : . Retome o fluxo do tópico após a troca de tópico o atributo está habilitado no tópico. Você pode encontrar esta chave de alternância em Propriedades em Propriedades avançadasAdicional. Por que a conversa NÃO retornou ao tópico A depois Virtual AgentMudou para o tópico B? : . Retome o fluxo do tópico após a troca de tópico o atributo está desabilitado no tópico. Você pode encontrar esta chave de alternância em Propriedades em Propriedades avançadasAdicional. Se Virtual Agentnão encontra uma intenção, ela usará uma pesquisa de palavra-chave no tópico intermediário? : Nº As variáveis do tópico A estão disponíveis para o tópico B após a mudança? : Nº As variáveis do tópico B estão disponíveis para o tópico A quando o tópico A é retomado? : Nº Para solucionar problemas adicionais, verifique as informações nas tabelas a seguir. ## Verifique as informações de previsão de NLU nas tabelas de NLU abertas {#va-topic-discovery-issues__section_xbt_zrn_vjb} 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 NLU abertos e Feedbacks de entidade de previsão de NLU abertos fornecem informações detalhadas sobre o processamento de NLU realizado pelas aplicações (como Virtual Agent) para determinar a intenção do tópico e as entidades (preenchimento de slot). Abrir tabela de feedbacks de intenção de previsão de NLU : Abrir feedbacks de intenção de previsão de NLU \[OPEN_nlu_PREDIDICT_Intent_FEEDBACK\] tabela mostra a intenção de processamento que uma aplicação (neste caso Virtual Agent) Executa em resposta a um resultado de previsão de intenção de NLU. O objetivo para Virtual AgentÉ mapear uma intenção de NLU prevista para um Virtual Agenttópico. Sempre que necessário Virtual Agentsugere um tópico, um registro do resultado da previsão é adicionado a esta tabela. Se Virtual Agentnão encontra um tópico, nenhuma previsão ocorre e um registro marcado Skippedfoi adicionado a esta tabela. Para exibir a tabela, navegue até Todos e, em seguida, insira open_nlu_predict_intent_feedback.list no filtro de navegação. {#va-topic-discovery-issues__table_ojs_j3y_vjb__entry__2} | Campo | Descrição | |-|-| | App | Aplicação usando NLU. Por exemplo: VA( Virtual Agent). | | Documento da aplicação | sys_id do registro da aplicação. Por exemplo: sys_cs_topic.sys_id. | | Tabela de documentos do app | Tabela do registro da aplicação. Por exemplo: sys_cs_topic(Tabela de tópicos). | | Selecionado automaticamente | Booliano 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 correspondia à mesma intenção: trueou 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 vazio (em branco). Por exemplo, uma intenção usada no Virtual Agenta 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 do IBM Watson AssistantAplicação de NLU. | | Causador da alternância de intenção | Nome do tópico de origem que solicita a confirmação do usuário. Há dois cenários possíveis para valores nesta coluna: * O usuário é solicitado a confirmar a correspondência de intenção inicial para o enunciado ( Pergunte ao usuário se o tópico escolhido pelo VA está correto a chave de alternância está habilitada em [Configurações de NLU](https://servicenow-prod.fluidtopics.net/wNCaw0J8lAfVq1dQzoCICg "Configurar Compreensão da linguagem natural( NLU) em Virtual Agentpara identificar o. NLUprovedor de serviços da sua instância. Você também pode especificar os idiomas de NLUmodelos usados durante o design de conversa, com base nos idiomas compatíveis com seu NLUe o. Now Platform.")). Se o usuário for solicitado a fornecer um enunciado inicial, esse valor pode 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 rejeitou a intenção do tópico correspondente inicialmente. * O usuário é solicitado a confirmar um comutador de intenção no tópico MID ( Pergunte ao usuário se o tópico alternado está correto a chave de alternância está habilitada em [Configurações de NLU](https://servicenow-prod.fluidtopics.net/wNCaw0J8lAfVq1dQzoCICg "Configurar Compreensão da linguagem natural( NLU) em Virtual Agentpara identificar o. NLUprovedor de serviços da sua instância. Você também pode especificar os idiomas de NLUmodelos usados durante o design de conversa, com base nos idiomas compatíveis com seu NLUe o. Now Platform.")). Se o usuário for solicitado a fornecer um switch no tópico MID, esse valor será o nome do tópico que ele estava exibindo no momento da troca. {#va-topic-discovery-issues__ul_y1q_rnl_lpb} Nota: As tarefas do sistema também podem ser exibidas aqui, o 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: As tarefas do sistema também podem ser exibidas aqui, o que você pode ignorar. Por exemplo: __silent_TerminateGoal_a3817a5f7ca7439b8. | | Mapeado | Booliano que indica se a aplicação ( Virtual Agent) considerou a previsão utilizável ao corresponder a intenção a um tópico disponível: trueou false. | | Nome de exibição do modelo | Nome do ServiceNowModelo de NLU. | | 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 de NLU | Resultado de previsão do enunciado inicial em uma conversa como parte da descoberta de tópicos: * Fallback da Pesquisa com IA Nenhuma previsão foi feita. Pesquisa com IAfoi 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 não categorizados. * 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. * Incorreto entre vários : Foram feitas várias previsões, 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. Os outros registros de previsão são marcados como não categorizados. * Configurar previsão de tópico A previsão relacionada ao tópico de configuração foi feita sem usar Pesquisa com IA. * Ignorado Nenhuma previsão foi feita. * Ignorado com novo enunciado : Quando o menu de tópico era exibido, o usuário digitava um novo enunciado. * Sem categoria : Nenhuma das condições acima foi atendida ou o usuário abandonou a conversa. {#va-topic-discovery-issues__ul_kkl_npx_rqb} | | Linguagem do modelo de NLU | Idioma do modelo de NLU usado para a previsão. | | Previsão | Nome da intenção prevista. | | Log de auditoria de previsão | Referência à tabela de logs de previsão de NLU em aberto \[OPEN_nlu_PREDIDIDICT_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âmicaestá habilitado. Por exemplo, se o usuário digitar em francês, o código frestá 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 Agentsolicita que o usuário confirme seu idioma. Se confirmado, o idioma detectado se torna o valor padrão para a sessão. | | Selecionado | Booliano 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: trueou false. | | Mostrado | Booliano que indica se a aplicação ( Virtual Agent) exibiu a intenção prevista como uma opção para o usuário final selecionar: trueou false. | | Tópico alternado | Nome do tópico, se o usuário foi solicitado a confirmar (independentemente de sua escolha, sim ou não). | | Enunciado | Frase inserida pelo usuário final na janela do cliente de bate-papo. | [Tabela 1. Campos-chave na tabela de feedbacks de intenção de previsão de NLU aberta] {#va-topic-discovery-issues__table_ojs_j3y_vjb} Abrir tabela de feedbacks de entidade de previsão de NLU : Abrir feedbacks de entidade de previsão de NLU \[OPEN_nlu_PREDIDICT_entity_feedback\] mostra a entidade (preenchimento de slot) que uma aplicação (neste caso Virtual Agent) Executa em resposta a um resultado de previsão de entidade de NLU. Por exemplo, o objetivo de Virtual AgentÉ mapear uma entidade de NLU prevista para um Virtual Agentvariável de entrada de tópico. Para exibir a tabela, insira open_nlu_predict_entity_feedback.list no filtro de navegação. {#va-topic-discovery-issues__table_u1p_kyx_vjb__entry__2} | Campo | Descrição | |-|-| | App | Aplicação usando NLU. Por exemplo, VA ( Virtual Agent). | | Documento da aplicação | sys_id do registro da aplicação. Por exemplo: sys_cs_topic.sys_id. | | Tabela de documentos da aplicação | Tabela do registro da aplicação. Por exemplo: sys_cs_topic. | | Selecionado automaticamente | Booliano que indica se a aplicação optou automaticamente por usar a entidade sem notificar o usuário: trueou false. | | Nome de exibição do modelo externo | Nome do modelo de NLU externo. Por exemplo, o nome do IBM Watson AssistantAplicação de NLU. | | Mapeado | Booliano que indica se a aplicação ( Virtual Agent) considerou a previsão utilizável: trueou false. | | Mapeado para | Item na aplicação para o qual a entidade foi mapeada. | | Nome de exibição do modelo | Nome do ServiceNowModelo de NLU. | | 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 de logs de previsão de NLU em aberto \[OPEN_nlu_PREDIDIDICT_LOG\]. | | Confiança da previsão | Valor de confiança para a previsão. | | Selecionado | Booliano que indica se a aplicação selecionou para usar a entidade: trueou false. | | Mostrado | Booliano que indica se a aplicação exibiu a entidade prevista para o usuário final como uma opção para selecionar: trueou false. | | Enunciado | Frase do usuário inserida na janela do cliente de bate-papo. | | Valor | Valor da entidade prevista. | [Tabela 2. Campos-chave na tabela de feedbacks de entidade de previsão de NLU aberta] {#va-topic-discovery-issues__table_u1p_kyx_vjb} Abrir Logs de Previsão de NLU : A tabela Abrir logs de previsão de NLU \[OPEN_nlu_PREDIDICT_LOG\] fornece uma visão geral consolidada dos registros de previsão de NLU para tópicos. Cada registro no log identifica o enunciado e as intenções correspondentes (tópicos) e entidades determinadas pelo serviço de NLU. Cada registro também inclui as pontuações de previsão de NLU calculadas durante a descoberta de tópicos (correspondência de intenção) e a extração de entidade. Nota: Os logs do nó de previsão de 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 o. com.glide.opennlu.predict.node_logging_enablede defina o valor como falso. Para exibir os logs de previsão de NLU abertos, insira open_nlu_predict_log.list no filtro de navegação. {#va-topic-discovery-issues__table_ns3_fmg_yhb__entry__2} | Campo | Descrição | |-|-| | Assíncrono | Indicador para processamento assíncrono de previsão: trueou false. Verdadeiro indica que a previsão foi realizada de forma assíncrona, permitindo Virtual Agentthreads do trabalhador para continuar. | | Criação em | Data e hora em que o registro de previsão de NLU foi criado. | | Duração | Tempo de processamento da previsão para retornar valores de intenção e entidade. | | Idioma | O idioma da solicitação de previsão de 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 de NLU que contém o enunciado e o modelo de NLU para a intenção reconhecida. | | Resposta | Resultados de previsão de NLU, que contêm 0 (nenhuma) ou mais intenções pontuadas e entidades pontuadas. | | Origem | Processo ou área: OpenNLU - Predict. | | Enunciado | Declaração do usuário reconhecida pelo bot, que mapeia para uma intenção definida em um modelo de NLU. | [Tabela 3. Campos-chave na tabela de logs de previsão de NLU aberta] {#va-topic-discovery-issues__table_ns3_fmg_yhb} Nota: Você pode exibir a intenção detalhada e os resultados da entidade nas tabelas Feedbacks de intenção de previsão de NLU abertas e Feedbacks de entidade de previsão de NLU abertas. ## Revise as informações de conexão HTTP para integrações de NLU abertas {#va-topic-discovery-issues__section_wcv_djw_wjb} Use a tabela Conexão HTTP de driver de NLU aberta \[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 para seu provedor de serviços de NLU. Para exibir a tabela, insira open_nlu_driver_http_connection.list no filtro de navegação.