# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-09-22T05:54:43.247Z ## Página - Título: Créditos e quotas de IA - URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/creditos-e-quotas-de-ia - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Como funciona o pool mensal de IA, o consumo compartilhado e a distribuição de limites máximos por usuário. ## Seções - Acesse a tela - Entenda o pool mensal - Como as quotas dividem o uso - Atenção ao primeiro limite individual - Configure limites por usuário - O que usa cada parte - Acompanhe e ajuste - Troubleshooting rápido ## Conteúdo da página # 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 :ScreenEntry{href="https://my.agilize.app/config/ai-credits" label="Gerenciar créditos e quotas de IA" path="Configurações > IA > Créditos e quotas"}. ![Resumo do pool mensal com total, consumo e créditos disponíveis](/docs/screenshots/config-ia-creditos-resumo.png) 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. --- title: "Distribuição do pool de IA" caption: "Reservas pessoais limitam o uso de usuários; o restante protege rotinas e execuções do projeto." definition: | flowchart TD A[Pool mensal do projeto] --> B[Percentuais reservados a usuários] A --> C[Percentual restante do projeto] B --> D[Assistentes e Copiloto com consumo pessoal] C --> E[Rotinas, implantação e agentes operacionais] D --> F[Mesmo saldo total] E --> F --- 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 1. Revise **Pool mensal**, **Consumido** e **Disponível**. 2. Clique em **Definir limite de usuário**. 3. Busque a pessoa por nome ou e-mail. 4. Informe o percentual máximo mensal. 5. Repita para os demais usuários que terão consumo pessoal. 6. Confira o percentual restante para o projeto. 7. 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. | ## Guias relacionados - [Rotinas de IA](/docs/configuracao/inteligencia-artificial/rotinas-de-ia) - [Configurar assistentes de IA](/docs/configuracao/inteligencia-artificial/configurar-assistentes-de-ia) - [Melhorar e gerar respostas com o Copiloto de escrita](/docs/usuarios/inteligencia-artificial/melhorar-gerar-respostas)