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 inclusosdo 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#
| Entitlement | Starter | Growth | Business | Scale | Enterprise |
|---|---|---|---|---|---|
| Relatórios com agenda ativa | 1 | 10 | ilimitado* | ilimitado* | ilimitado* |
| Destinatários por relatório | 3 | 10 | 50 | 200 | 200 |
| Narrativa executiva por IA | — | ✓ | ✓ | ✓ | ✓ |
| PDF anexo no relatório | — | — | ✓ | ✓ | ✓ |
| Alertas inteligentes | — | — | ✓ | ✓ | ✓ |
| Modos de atualização | batch | batch | batch, near_rt | batch, near_rt | batch, near_rt |
| Cadência da ingestão | lote diário | lote diário | lote, 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#
- Acompanhe saldo e extrato em Custos / Consumo.
- A franquia é creditada automaticamente por ciclo (webhook de pagamento + rede de segurança por cron diário).
- Recarregue créditos via Pix quando quiser folga acima da franquia.
- 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#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Ação cara bloqueada | saldo de créditos de uso esgotado | recarregue 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 apareceu | ciclo não processado / plano sem créditos | aguarde o cron; Enterprise não tem franquia self-service |
| Consulta cortada por custo | atingiu o teto de volume por consulta | reduza o escopo da consulta |
| Limite de destinatários | teto do plano por relatório | faça upgrade ou reduza destinatários |
Próximos passos: Suspensão e inadimplência.