Créditos e quotas de IA
Os recursos de IA consomem um pool mensal compartilhado pelo projeto. A tela de créditos permite acompanhar o total, o consumo e o saldo disponível, além de definir limites máximos para usuários sem criar carteiras separadas.
Acesse a tela
Acesse Gerenciar créditos e quotas de IA.
Somente administradores acessam essa configuração. Usuários comuns visualizam apenas o saldo aplicável ao próprio uso nos pontos em que a IA está disponível.
Entenda o pool mensal
O pool reúne os créditos mensais vindos das assinaturas e os créditos avulsos válidos para a competência. Todo consumo reduz esse mesmo total.
| Indicador | Significado |
|---|---|
| Pool mensal | Capacidade total disponível no projeto durante a competência. |
| Consumido | Uso já realizado por pessoas, rotinas e demais execuções de IA. |
| Disponível | Saldo final ainda utilizável no mês. |
A plataforma mede o processamento realizado pelos modelos e apresenta o resultado em créditos de IA. Na interface, o consumo é convertido em unidades de 1.000 tokens e exibido de forma arredondada.
Como as quotas dividem o uso
As quotas por usuário são percentuais máximos do pool. Elas não separam créditos em uma carteira independente e não aumentam o saldo total.
Exemplo: em um pool de 10.000 créditos, reservar 20% para Ana e 15% para Bruno deixa 65% protegido para o projeto. Ana pode consumir no máximo 2.000 créditos pessoais, Bruno 1.500, e rotinas ou execuções financiadas pelo projeto usam a parte restante, sempre respeitando o saldo total ainda disponível.
Atenção ao primeiro limite individual
Sem nenhuma reserva configurada, usuários e automações compartilham livremente o pool disponível.
Depois que ao menos uma reserva individual é criada:
- somente os usuários listados possuem limite para execuções de consumo pessoal;
- um usuário não listado fica sem quota pessoal;
- o percentual não distribuído permanece para rotinas e execuções financiadas pelo projeto;
- a soma das reservas não pode ultrapassar 100%.
Por isso, planeje a distribuição completa antes de salvar o primeiro limite.
Configure limites por usuário
- Revise Pool mensal, Consumido e Disponível.
- Clique em Definir limite de usuário.
- Busque a pessoa por nome ou e-mail.
- Informe o percentual máximo mensal.
- Repita para os demais usuários que terão consumo pessoal.
- Confira o percentual restante para o projeto.
- Salve a distribuição.
Use percentuais como teto de governança, não como previsão exata. O consumo real depende do tamanho do contexto, da resposta e das consultas realizadas.
O que usa cada parte
| Parte do pool | Exemplos |
|---|---|
| Limite pessoal | Copiloto de escrita e assistentes configurados com consumo pessoal. |
| Limite do projeto | Rotinas de IA, implantação assistida e execuções operacionais configuradas para o projeto. |
Mesmo dentro de um limite pessoal, a execução depende de haver saldo no pool geral. Um usuário pode ainda ter percentual disponível e não conseguir executar se o projeto já consumiu o total mensal.
Acompanhe e ajuste
- Revise o consumo antes de criar rotinas recorrentes.
- Preserve uma parcela do projeto para rotinas e automações importantes.
- Evite reservar 100% para pessoas quando houver execuções agendadas.
- Ajuste percentuais quando um usuário muda de função ou deixa de usar IA.
- Reavalie a distribuição no início de cada competência.
Troubleshooting rápido
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Usuário vê saldo zero após criar reservas | Ele não foi incluído na distribuição ou recebeu percentual insuficiente. | Inclua o usuário ou ajuste seu limite. |
| Rotina pausa por falta de saldo | O percentual restante do projeto ou o pool total foi consumido. | Reduza reservas pessoais, regularize o pool e reative a rotina. |
| Percentuais não podem ser salvos | A soma ultrapassa 100%. | Reduza a distribuição até o total permitido. |
| Saldo pessoal existe, mas a execução falha | O pool geral do projeto está esgotado. | Revise o indicador Disponível e a capacidade contratada. |
| Consumo parece variar entre respostas | Contexto, saída e quantidade de consultas foram diferentes. | Compare o consumo realizado e torne os pedidos mais objetivos. |