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 | Como verificar | Solução | Prevenção |
|---|---|---|---|---|
| IA recusa a ação com "limite de uso de IA deste mês" | teto mensal de IA do workspace atingido (ledger reserva→liquidação, fail-closed) — padrão R$ 50/mês, zerado = sem teto | veja o gasto do mês em Consumo | fale com o administrador: o teto é configurável e zera na virada do mês; recarregar créditos não o levanta | acompanhe o gasto do mês, não só a franquia |
IA recusa a ação com 403 | plano sem o entitlement de IA (Starter) ou papel sem a ação de IA | veja o motivo na tela de Consultas | suba para Growth+; peça o papel admin/owner | confira o plano antes de prometer IA ao time |
Ação cara bloqueada com 402 | assinatura em atraso, suspensa ou cancelada | veja o estado em Planos | regularize a assinatura | mantenha o pagamento em dia |
| 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 | Como verificar | 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 |
| Consulta sobre bilhões de linhas fica lenta | volume muito grande para consulta direta | \1 | agregue em Gold e use o modelo Import | dimensione com margem |
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.
Verificação rápida 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. Os valores de custo na tela são estimativas; o valor cobrado é o da fatura.