Selo de estado:
Preview— catálogo de diagnóstico para recursos de IA e custo/performance. Atualizado em 2026-09-08.
A IA (text-to-SQL, insights, Q&A) tem orçamento com reserva→liquidação, egress controlado e proveniência nas respostas. O custo de dados vem do processamento no datalake, com guarda de custo e cache. Ver Privacidade, egress e orçamento e Consumo e quotas.
IA (text-to-SQL, insights, Q&A)#
| Sintoma | Causa provável | Diagnóstico | Solução | Prevenção |
|---|---|---|---|---|
| IA recusa a ação | crédito de IA esgotado (ledger fail-closed) | veja o saldo em Consumo | recarregue créditos | acompanhe a franquia mensal |
| IA "não responde" / indisponível | LLM não configurado ou chave de desligamento | ver Status | aguarde; confirme configuração | monitore o estado da capacidade |
| Resposta da IA sem números/recusa explicada | Q&A pede evidência/citação | leia a proveniência da resposta | reformule com a métrica/período claros | pergunte sobre dados publicados (Gold) |
| SQL gerado bloqueado | defesas do text-to-SQL (só SELECT, marts publicados) | veja a mensagem 403 | ajuste a pergunta ao escopo permitido | consulte apenas marts publicados |
| Consumo de IA maior que o esperado | perguntas amplas/repetidas | veja a Auditoria (custo por ação) | reduza escopo; reuse respostas | oriente perguntas objetivas |
Custo e performance#
| Sintoma | Causa provável | Diagnóstico | Solução | Prevenção |
|---|---|---|---|---|
| Consulta cortada por custo | atingiu o teto de volume por consulta | veja o erro/custo do run | filtre/agregue; reduza o período | modele Gold enxuto; particione |
| Fatura/custo projetado alto | varredura de tabela grande | veja bytes na Auditoria | filtre/agregue; use partições | evite paginar tabela inteira |
| Paginar API não reduz custo | LIMIT/OFFSET não cortam bytes | cobrança é por bytes reais | use $select/$filter (OData) | prefira pushdown a paginação bruta |
| Dashboard lento no refresh | consulta pesada / sem cache | compare 1ª execução vs. repetição | consultas idênticas servem do cache (R$ 0) | agende refresh fora do pico |
Refresh manual bloqueado (402) | inadimplência (não é performance) | ver Suspensão | owner regulariza | acompanhe faturamento |
| "Escala de 1B linhas não performa" | escala real não medida hoje | ver Consumo e quotas | dimensione com margem | trate performance sem promessa de SLA |
Valores em BRL são projeção hoje
O x-ingestia-cost-brl e o custo por evento são projeção, não preço faturado
garantido. O teto de volume por consulta limita o custo por consulta.
Diagnóstico rápido de custo#
- Abra a Auditoria e ordene por custo.
- Expanda o SQL do evento caro; veja os bytes processados.
- Reescreva com filtro/agregação; confirme que a repetição serve do cache.
Segurança e privacidade#
- Egress controlado: a IA não vaza dado além do necessário; respostas trazem proveniência — ver Privacidade, egress e orçamento.
- Anti-injeção e chaves de desligamento protegem o caminho de IA.
Relacionados#
- Text-to-SQL · Insights · Q&A
- Privacidade, egress e orçamento
- Consumo e quotas
- Capacidades e desligamento
Última revisão: 2026-09-08. Estado: IA em Preview; custo faturado em BRL
= projeção; escala em nuvem não medida. Fonte: matriz de estados do produto.