Pular para o conteúdo

Consumo e quotas

Nesta página (11)

Consumo é uso de recursos (processamento e IA), pago em créditos. Quotas são os limites que cada plano aplica. Este é o painel financeiro-operacional do workspace.

Conceitos#

  • Créditos de uso: saldo em R$ que cobre o consumo de nuvem (queries no processamento, egress de IA).
  • Franquia mensal: os créditos inclusos do plano, creditados exatamente uma vez por ciclo (YYYY-MM).
  • Recarga: créditos adicionais comprados (Pix), somados ao saldo.
  • Entitlements: limites de recursos por plano (relatórios agendados, destinatários, modos de atualização etc.).
  • Guarda de custo: teto de bytes por consulta que evita fatura-surpresa.

Disponibilidade#

  • Planos: todos têm franquia, exceto Enterprise/custom (0 créditos inclusos — contrato manda).
  • Funcionamento: franquia, ledger e entitlements são determinísticos e cobertos por testes automáticos.

Entitlements por plano#

EntitlementStarterGrowthBusinessScaleEnterprise
Relatórios com agenda ativa110ilimitado*ilimitado*ilimitado*
Destinatários por relatório31050200200
Narrativa executiva por IA—✓✓✓✓
PDF anexo no relatório——✓✓✓
Alertas inteligentes——✓✓✓
Modos de atualizaçãobatchbatchbatch, near_rtbatch, near_rtbatch, near_rt
Cadência da ingestãolote diáriolote diáriolote, micro-lote (5/15 min)lote, micro-lote (5/15 min)lote, micro-lote (5/15 min)

* "ilimitado" = teto muito alto (999) na prática. Modo ao vivo (rt) só com nuvem própria (BYOC), fora do plano.

Permissões#

  • Gerir créditos/recargas/plano exige owner (billing.manage).
  • Rodar ações que consomem (query, refresh, IA, export, relatório) exige papel e permissões finas adequados — ver Usuários e permissões.

Configuração#

  1. Acompanhe saldo e extrato em Custos / Consumo.
  2. A franquia é creditada automaticamente por ciclo (webhook de pagamento + rede de segurança por cron diário).
  3. Recarregue créditos via Pix quando quiser folga acima da franquia.
  4. Ajuste os entitlements trocando de plano.

Validação#

  • O extrato distingue franquia (franquia:<ws>:<ciclo>) de recarga (id do pagamento) e de storage — cada um em seu bucket.
  • A franquia é idempotente: reprocessar o mesmo ciclo não credita duas vezes.
  • O ledger de IA é atômico (reserva → liquidação): consumo nunca "vaza" o teto.

Exemplo#

A Comércio Aurora (Growth) recebe R$ 150 de franquia no início do ciclo. Ao rodar pipelines e perguntas de IA, o consumo é debitado do saldo. Num mês de pico, Maria recarrega mais R$ 300 (Pix) — o extrato mostra "Franquia mensal do plano Growth — ciclo 2026-09" e a recarga separadamente.

Custo#

  • Acompanhar consumo/quotas: R$ 0.
  • O consumo real (processamento/IA) debita créditos. Os valores em R$ mostrados antes da execução são estimativas; o valor cobrado é o da fatura.
  • O teto de volume por consulta limita o custo por consulta.

Segurança#

  • Ledger de IA atômico + rate limit fail-closed: sem crédito, o recurso recusa (não segue "no escuro").
  • Budgets por workload são advisory e fail-closed — a plataforma nunca troca o modo de execução sozinha.
  • Consumo é auditado por workspace.

Limites#

  • Advisor e budgets orientam o uso em volumes grandes; o tempo de resposta depende do volume e da consulta.
  • Sem expiração/rollover de franquia hoje: a franquia soma ao saldo único.
  • Sem pro-rata de upgrade no meio do ciclo (ciclo já concedido não recalcula).
  • /api/v1 (REST/OData) tem rate limit fail-closed por chave e por workspace. A API de consulta REST está em acesso antecipado e ainda não está aberta para uso externo.

Troubleshooting#

SintomaCausa provávelO que fazer
Ação cara bloqueadasaldo de créditos de uso esgotadorecarregue créditos (Pix)
"Limite de uso de IA deste mês foi atingido"teto mensal de IA do workspace (padrão R$ 50/mês; zerado = sem teto)fale com o administrador — é outro controle: recarregar créditos não levanta o teto, que zera na virada do mês
Franquia não apareceuciclo não processado / plano sem créditosaguarde o cron; Enterprise não tem franquia self-service
Consulta cortada por custoatingiu o teto de volume por consultareduza o escopo da consulta
Limite de destinatáriosteto do plano por relatóriofaça upgrade ou reduza destinatários

Próximos passos: Suspensão e inadimplência.

Links relacionados