Pular para o conteúdo

Perguntar aos dados (primeira pergunta à IA)

Nesta página (9)

A IA da ingestia.io traduz linguagem natural em SQL sobre o seu datamart, responde com citações e proveniência e sabe recusar quando não tem base.

Disponibilidade#

  • Planos: perguntar aos dados é o mesmo entitlement de IA da narrativa executiva (aiNarrative) — ou seja, Growth ou superior. No Starter a chamada é recusada com 403, e a própria tela de Consultas diz que o plano não inclui. O que depende de plano mais alto é o relatório completo (PDF anexo e alertas inteligentes: Business+). Os nomes dos planos são Starter, Growth, Business, Scale e Enterprise — "Pro" é só um id legado de Growth nos bancos antigos, não um plano do produto.
  • Proteções: o caminho é coberto por testes automáticos (anti-injeção, proveniência).

Permissões#

  • Usar a IA exige papel admin/owner (ação RBAC recursos de IA) e roda atrás dos chaves de desligamento para consulta em linguagem natural / insights de IA.
  • É uma ação cara — bloqueada em inadimplência (402).
  • Ver dados sob RLS/PII: a IA respeita a segurança por linha e a permissão Ver dados PII (viewPII) do membro.

Configuração (passo a passo)#

  1. Abra o wizard de perguntas (Perguntar aos dados) no app.
  2. Escolha o escopo: uma tabela Gold ou o modelo semântico (recomendado — a IA fica "aterrada" no modelo certificado).
  3. Escreva a pergunta em português.
  4. A IA propõe o SQL (com parâmetros nomeados, anti-injeção), estima o custo da execução e explica o que a consulta faz, com citações das fontes usadas. Gerar não executa nada no datalake.
  5. Executar é uma ação separada, sua: ela segue a sua permissão e a revisão do SQL proposto. O resultado só aparece depois dessa execução, e aí sim com a guarda de custo (maximumBytesBilled) aplicada.

Validação#

  • A resposta traz proveniência: quais tabelas/colunas/medidas foram usadas.
  • O SQL gerado fica visível para auditoria.
  • Se a pergunta não tem base no modelo, a IA recusa em vez de inventar.

Exemplo#

Na Comércio Aurora, Ana pergunta: "Qual filial mais vendeu em julho?". A IA propõe o SQL sobre prd_aurora_gold.vendas_por_filial, mostra a previsão de custo e cita a tabela e o período que usou — sem rodar nada. Ana revisa o SQL e executa; é essa execução, com o teto de volume por consulta, que devolve "Campinas, R$ 128 mil".

Custo#

  • Cada pergunta consome uso de IA (egress LLM) e, quando você executa o SQL, processamento no datalake. Os dois saem dos créditos de uso do workspace (saldo em R$ que cobre consumo de nuvem).
  • Não existe "crédito de IA" separado. O controle específico da IA é um teto mensal em reais por workspace — padrão R$ 50/mês, configurável, e zerado = sem teto. Ele conta o gasto do mês corrente e volta a zerar na virada do mês.
  • O teto usa ledger atômico (reserva → liquidação) sobre a trilha de auditoria: você nunca "estoura" silenciosamente, e duas chamadas simultâneas não furam o limite. Atingido o teto, a IA é recusada com uma mensagem pedindo para falar com o administrador — recarregar crédito não levanta o teto, são controles diferentes.
  • Rate limit fail-closed. BRL faturado = projeção.

Segurança#

  • Anti-injeção de prompt e de SQL (parâmetros nomeados).
  • Egress controlado: o que sai para o provedor de IA é mapeado; egress fica desligado por padrão onde exige opt-in.
  • A IA respeita RLS/ABAC — não devolve linha que a pessoa não poderia ver.
  • Respostas trazem proveniência, não dado bruto sem contexto.

Limites#

  • A IA não garante exatidão absoluta; use a proveniência para conferir.
  • Sem promessa de "paridade total" com ferramentas de IA de mercado.

Troubleshooting#

SintomaCausa provávelO que fazer
IA bloqueada (402)assinatura em atraso, suspensa ou canceladaregularize em Planos (não é teto de IA: teto do mês devolve mensagem própria)
IA recusada (403)plano sem o entitlement de IA (Starter) ou papel sem a ação de IAsuba para Growth+ ou peça o papel admin/owner
"Limite de uso de IA deste mês foi atingido"teto mensal de IA do workspace (padrão R$ 50)fale com o administrador: o teto é configurável e zera na virada do mês — recarregar créditos não o levanta
"Recurso de IA indisponível"chave de desligamento consulta em linguagem natural/insights de IA ativorecurso pausado; tente mais tarde
Resposta recusadapergunta sem base no modeloreformule ou aterre no modelo semântico
Resultado inesperadoescopo/tabela erradosconfira a proveniência e ajuste o escopo

Próximos passos: Compartilhar o dashboard.

Links relacionados