Feature de Busca por Linguagem Natural

General
1

Feature de Busca por Linguagem Natural

O que ela faz

Permite que o usuário digite em texto livre e o próprio sistema se encarrega de buscar os dados desejados.

Como funciona atualmente

O usuário digita uma consulta em FUQL (ex.: ONDE "Pessoa/Empresa -> Código Máxima" = 200). Essa busca funciona bem, mas depende que o usuário leia a documentação e tenha um perfil mais técnico para utilizá‑la.

Novo formato

Agora o processo é mais simples: o usuário apenas descreve o que quer e o sistema realiza a busca automaticamente. Exemplo: codigo máxima 200.

Como configurar

  1. O usuário deve possuir a permissão:
{
  "description": "Permissão para editar exemplos de consultas em linguagem natural",
  "name": "natural-language-query-examples-editor"
}
  1. Acessar a tela de configuração pelo ícone disponível no componente de busca.
  2. Cadastrar a busca informando os campos tabela, descrição, entrada e saída.
    • tabela: a tabela onde a busca será usada.
    • descrição: caso de uso da busca.
    • entrada: exemplo do que o usuário pode digitar.
    • saída: exemplo de consulta FUQL com os campos args, where e query. Consulte a documentação em Como criar uma Query Puca?.

Exemplo de configuração

  • tabela: puca_crm_api_person
  • descrição: “Busca por pessoas jurídicas”
  • entrada: “filtre por empresas”
  • saída:
{
  "args": { "type": "J" },
  "where": { "v1": "type", "operator": "equals", "v2": "$type" }
}

Importante: Apenas as tabelas com exemplos definidos terão suporte a esta feature.

Query Builder como Solução para Criação de Queries PQL