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 com403, 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)#
- Abra o wizard de perguntas (Perguntar aos dados) no app.
- Escolha o escopo: uma tabela Gold ou o modelo semântico (recomendado — a IA fica "aterrada" no modelo certificado).
- Escreva a pergunta em português.
- 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.
- 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#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| IA bloqueada (402) | assinatura em atraso, suspensa ou cancelada | regularize 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 IA | suba 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 ativo | recurso pausado; tente mais tarde |
| Resposta recusada | pergunta sem base no modelo | reformule ou aterre no modelo semântico |
| Resultado inesperado | escopo/tabela errados | confira a proveniência e ajuste o escopo |
Próximos passos: Compartilhar o dashboard.