Pular para o conteúdo
Atualizado em 2026-09-08

Troubleshooting: IA, custo e performance

Catálogo sintoma → causa → como verificar → solução → prevenção para recursos de IA (text-to-SQL, insights, Q&A), orçamento/egress e custo/performance de consultas.

Nesta página (5)

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)#

SintomaCausa provávelComo verificarSoluçãoPrevençã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 tetoveja o gasto do mês em Consumofale com o administrador: o teto é configurável e zera na virada do mês; recarregar créditos não o levantaacompanhe o gasto do mês, não só a franquia
IA recusa a ação com 403plano sem o entitlement de IA (Starter) ou papel sem a ação de IAveja o motivo na tela de Consultassuba para Growth+; peça o papel admin/ownerconfira o plano antes de prometer IA ao time
Ação cara bloqueada com 402assinatura em atraso, suspensa ou canceladaveja o estado em Planosregularize a assinaturamantenha o pagamento em dia
IA "não responde" / indisponívelLLM não configurado ou chave de desligamentover Statusaguarde; confirme configuraçãomonitore o estado da capacidade
Resposta da IA sem números/recusa explicadaQ&A pede evidência/citaçãoleia a proveniência da respostareformule com a métrica/período clarospergunte sobre dados publicados (Gold)
SQL gerado bloqueadodefesas do text-to-SQL (só SELECT, marts publicados)veja a mensagem 403ajuste a pergunta ao escopo permitidoconsulte apenas marts publicados
Consumo de IA maior que o esperadoperguntas amplas/repetidasveja a Auditoria (custo por ação)reduza escopo; reuse respostasoriente perguntas objetivas

Custo e performance#

SintomaCausa provávelComo verificarSoluçãoPrevenção
Consulta cortada por custoatingiu o teto de volume por consultaveja o erro/custo do runfiltre/agregue; reduza o períodomodele Gold enxuto; particione
Fatura/custo projetado altovarredura de tabela grandeveja bytes na Auditoriafiltre/agregue; use partiçõesevite paginar tabela inteira
Paginar API não reduz custoLIMIT/OFFSET não cortam bytescobrança é por bytes reaisuse $select/$filter (OData)prefira pushdown a paginação bruta
Dashboard lento no refreshconsulta pesada / sem cachecompare 1ª execução vs. repetiçãoconsultas idênticas servem do cache (R$ 0)agende refresh fora do pico
Refresh manual bloqueado (402)inadimplência (não é performance)ver Suspensãoowner regularizaacompanhe faturamento
Consulta sobre bilhões de linhas fica lentavolume muito grande para consulta direta\1agregue em Gold e use o modelo Importdimensione 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#

  1. Abra a Auditoria e ordene por custo.
  2. Expanda o SQL do evento caro; veja os bytes processados.
  3. 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#


Última revisão: 2026-09-08. Os valores de custo na tela são estimativas; o valor cobrado é o da fatura.

Links relacionados