Crie um atalho de NLQ

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Crie um atalho semântico para ajudar a melhorar a capacidade de NLQ reconhecer as várias maneiras como seus usuários solicitam dados. Os atalhos semânticos operam de forma semelhante a NLQ mapeando palavras comuns para colunas, mas para uma tabela selecionada quando determinadas condições são atendidas.

    Antes de Iniciar

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

    Por Que e Quando Desempenhar Esta Tarefa

    Curtir NLQ sinônimos e atalhos semânticos permitem mapear palavras comuns nas solicitações de seus usuários para as colunas em suas tabelas de instância. Quando essas palavras são detectadas em consultas de linguagem natural, NLQ substitui-os por nomes de coluna e tabela reais e envia a consulta formal.

    Os atalhos semânticos fornecem um construtor de condições para que você possa filtrar quais registros são cobertos pelos termos fornecidos.

    Alguns atalhos semânticos são fornecidos no sistema de base e você pode adicionar mais para seus casos de uso e requisitos de negócios. Revisão NLQ logs de enunciados reais do usuário para encontrar possíveis termos a serem adicionados. Para obter mais informações, consulte Exibir logs de NLQ.

    Você pode criar um novo atalho ou modificar um atalho existente, da seguinte forma.

    • Se já existir algum atalho para a tabela de destino e as condições de filtro, você deverá adicionar o novo atalho ao registro atual. Separe vários atalhos com uma vírgula.
    • Os atalhos 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.
    • Sinônimos podem conter parênteses e pontos, mas não vírgulas.
    • Registros de sinônimos e atalhos são associados a uma tabela. Você pode associar o mesmo termo sinônimo a mais de uma tabela, mas deve criar um registro para cada tabela.

    Procedimento

    1. Certifique-se de que você esteja no escopo da aplicação desejado para o atalho e navegue até Tudo > NLQ > Atalhos de Semântica.
    2. Selecione Novo.
      Se você estiver atualizando um registro existente, selecione sua linha na lista.
    3. No formulário, preencha os campos.
      Campo Descrição
      Tabela

      Tabela de origem.

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

      Condições

      Condições na tabela de origem que devem ser atendidas para que o sinônimo funcione.

      Sinônimos

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

      Separe vários sinônimos com uma vírgula.

      Aplicação

      [Somente leitura] Escopo da aplicação que pode usar o sinônimo em uma consulta. O padrão é Global . Certifique-se de que você esteja no escopo da aplicação de destino do atalho antes de criá-lo.

    4. Selecione Enviar se novo, ou Atualização se você estiver modificando um registro existente.

    Resultado

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

    Atalho semântico para backlog de incidentes

    A imagem a seguir mostra um exemplo de atalho semântico usado em registros de incidentes. Os incidentes contêm Atribuído a. campo. Usando o Construtor de condições, você pode fornecer sinônimos para quando o campo estiver vazio. Quando NLQ detecta não atribuído e. backlog Na entrada dos usuários, ele os substitui pela cláusula SQL Assigned_toISEMPTY .

    Novo formulário de registro para um atalho semântico de NLQ.

    Um usuário pode inserir mostrar backlog de incidentes ou incidentes não atribuídos e o sistema exibe incidentes com um vazio Atribuído a. campo.