Criar um sinônimo de NLQ

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • Adicione sinônimos para melhorar a capacidade de NLQ de reconhecer as várias maneiras pelas quais os usuários solicitam dados. Com sinônimos, você pode mapear palavras ou termos usados com frequência para colunas da tabela.

    Antes de Iniciar

    Função necessária: admin, nlq_admin ou pa_analyst

    Por Que e Quando Desempenhar Esta Tarefa

    NLQ Os sinônimos permitem mapear palavras comuns nas solicitações dos usuários para as colunas nas tabelas de instâncias. Quando essas palavras são detectadas em consultas de idioma natural, NLQ as substitui por nomes reais de coluna e tabela e envia a consulta formal.

    Vários sinônimos são fornecidos no sistema de base e você pode adicionar mais para seus casos de uso e requisitos de negócios. Revise os logs NLQ de enunciados reais do usuário para encontrar possíveis sinônimos a serem adicionados. Para obter mais informações, consulte Exibir logs de NLQ.

    Você pode criar um novo sinônimo ou modificar um sinônimo existente, da seguinte forma.

    • Se já existir algum sinônimo para a tabela e a coluna de destino, você deverá adicionar o novo sinônimo ao registro atual. Separe vários sinônimos com uma vírgula.
    • Os sinônimos podem apontar para campos de referência, usando referência com pontos. Para obter mais informações, consulte Dot-walking examples.
    • Os sinônimos não diferenciam maiúsculas de minúsculas nas consultas.
    • Os sinônimos podem conter apóstrofos e pontos, mas não vírgulas.
    • Registros de sinônimos são associados a uma tabela. Você pode usar o mesmo termo sinônimo para mais de uma tabela, mas deve criar um registro para cada tabela.

    Procedimento

    1. Verifique se você está no escopo da aplicação desejado para o sinônimo e navegue até Tudo > NLQ > Sinônimos.
    2. Selecione Novo.
      Se você estiver atualizando um registro existente, selecione o nome da coluna na lista.
    3. No formulário, preencha os campos.
      Campo Descrição
      Tipo de sinônimo
      Tipo de sinônimo.
      • Tabela ou coluna: sinônimo de um valor em uma tabela ou uma coluna específica nessa tabela.
      • Registro: sinônimo de um valor nas tabelas do CMDB [cmdb_rel_type_table]. Para obter mais informações, consulte Consulta do CMDB.
        Nota:
        Compatível com as tabelas cmdb_rel_type, cmdb_group, cmdb_ci_service_technical, cmdb_ci_service_discovered e cmdb_ci_query_based_service.
      Aplicação

      [Somente leitura] Escopo da aplicação que pode usar o sinônimo em uma consulta. O padrão é Global.

      Ao criar um sinônimo, verifique se você está no escopo desejado para o sinônimo.
      Tabela

      Tabela de origem.

      Você pode usar o mesmo termo para mais de uma tabela, mas deve criar um registro de sinônimo para cada tabela. O mapeamento do sinônimo é exclusivo para a tabela.
      Nome da coluna

      Coluna específica na tabela de origem.
      Idioma

      Idioma do sinônimo. Deve corresponder ao idioma do valor de origem.
      Sinônimos

      Palavras ou frases curtas que o sistema deve mapear para nomes de colunas ou tabelas ao converter o enunciado em uma consulta formal.

      Separe vários sinônimos com uma vírgula.
      Estender a todas as tabelas secundárias

      Somente tipoTabela ou Coluna.

      Selecione esta opção para fazer com que as tabelas secundárias da tabela de origem herdem os sinônimos.
    4. Selecione Enviar se for novo ou Atualizar se estiver modificando um registro existente.

    Resultado

    O novo sinônimo está disponível para os usuários assim que eles atualizam a janela do navegador da lista.

    Sinônimo de NLQ para o campo Ativo

    A imagem a seguir mostra um exemplo de um registro de sinônimo de NLQ para o campo Ativo em uma solicitação de mudança. Os sinônimos abertos e em andamento são substituídos pelo termo ativo quando o sistema envia uma consulta.

    Formulário de registro de sinônimo de NLQ para um sinônimo de coluna.

    Com este registro de sinônimo, um usuário pode digitar mostrar solicitações de mudança em aberto ou solicitações de mudança em andamentoe o sistema exibirá as solicitações de mudança ativas.