Criar um atalho de NLQ

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

    • Crie um atalho semântico para ajudar a melhorar a capacidade de NLQ de reconhecer as várias maneiras pelas quais os usuários solicitam dados. Os atalhos semânticos operam de forma semelhante aos sinônimos 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

    Como os sinônimos NLQ, os atalhos semânticos permitem mapear palavras comuns nas solicitações dos usuários para as colunas nas tabelas de instância. 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.

    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. Revise os logs NLQ 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 do 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.
    • Os sinônimos podem conter apóstrofos 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. Verifique se você está 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. Verifique se você está no escopo da aplicação de destino do atalho antes de criá-lo.
    4. Selecione Enviar se for novo ou Atualizar se 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 um atalho semântico usado em registros de incidentes. Os incidentes contêm o campo Atribuído a. 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 assign_toISEMPTY.

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

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