SQL ou IA: as duas formas de montar uma consulta

Todo widget do Metrics é alimentado por uma consulta que busca os dados a serem exibidos. Você pode montar essa consulta de duas formas: escrevendo você mesmo, ou pedindo pra IA gerar a partir de uma pergunta em linguagem natural.

Escrevendo a consulta você mesmo

Se você já sabe exatamente quais dados quer buscar, pode escrever a consulta diretamente. É a forma mais direta para quem já tem familiaridade com esse tipo de linguagem de busca de dados.

Pedindo pra IA gerar

Se preferir, é só descrever o que você quer ver em uma pergunta normal — a IA monta a consulta pra você, já considerando os filtros e variáveis que o painel já tem configurados. A consulta gerada aparece no editor e já é testada automaticamente, mostrando as colunas e uma prévia; você revisa e ajusta antes de salvar o widget. Se já houver uma consulta, também dá para pedir à IA que a altere com Alterar atual. Se algo não sair certo na primeira tentativa, o próprio sistema tenta se corrigir automaticamente antes de te entregar o resultado. A geração por IA está disponível para o perfil Administrador e consome créditos de IA.

O que as duas têm em comum

Não importa qual caminho você escolhe: toda consulta passa pelas mesmas proteções de segurança do Metrics antes de rodar — validações que garantem que ela só busca dados, sem alterar nada no seu sistema. Isso significa que usar a IA pra gerar a consulta não abre nenhuma exceção nessas regras.

Veja também

• [Metrics] O que são os créditos de IA do Metrics
• [Metrics] Por que o Metrics só executa SELECT
• [Metrics] Como montar o seu primeiro dashboard
• [Metrics] Como usar filtros e variáveis nos dashboards

Atualizado em: 08/10/2026