👤 Para todos os usuários
🔐 Disponível para todos os planos
🎯 Para quem está usando ou planejando usar AI Agents
Muitos times configuram um AI Agent, testam uma vez e param de usar. Não porque não funciona. Porque não sabem quanto está gastando e ficam com medo de esgotar o saldo sem perceber.
O modelo de AI Credits do Pipefy é mais simples do que parece. Cada tipo de operação tem um custo fixo, o consumo é visível em tempo real com filtros detalhados e o saldo só é consumido quando a IA efetivamente executa. Crédito de IA não é custo a evitar: é orçamento de automação a alocar com intenção.
📖 O que você vai aprender aqui:
Quantos créditos de IA eu tenho?
Cada plano do Pipefy inclui 1.000 créditos de IA de uso único. Esses créditos ficam disponíveis desde a ativação do plano e não expiram por período, apenas por uso.
Quando os 1.000 créditos iniciais forem consumidos, pacotes adicionais podem ser adquiridos: 500, 1.000, 10.000 ou 50.000 créditos. Os pacotes seguem o mesmo modelo de uso único.
Os 1.000 créditos iniciais são de uso único e não se renovam mensalmente. Planejar o consumo antes de ativar AI Agents em processos de alto volume evita surpresas no saldo
O que consome crédito, operação por operação
O custo por execução depende de dois fatores: o modelo de IA utilizado e se a execução envolve leitura de documento com Processamento Inteligente de Documentos.
Tabela de consumo por tipo de operação:
- Execução padrão com Pipefy AI (qualquer ação sem documento): 2 créditos.
- Execução com BYO-LLM (modelo próprio configurado): 1,5 crédito.
- Execução com Processamento Inteligente de Documentos ativado (PDF ou imagem): +1 crédito adicional sobre o custo base.
- Exemplo: Pipefy AI + leitura de documento = 2 + 1 = 3 créditos por execução.
- Exemplo: BYO-LLM + leitura de documento = 1,5 + 1 = 2,5 créditos por execução.
- Gatilho disparado mas condição não atendida (agente não executa): 0 créditos.
- Arquivo fora do limite suportado (mais de 30 páginas ou formato inválido): 0 créditos.
- Erro parcial (parte da execução concluída): custo base cobrado normalmente.
Um detalhe relevante sobre o Processamento Inteligente de Documentos: ele precisa ser ativado manualmente na seção "Ferramentas avançadas" dentro do comportamento do agente. Não é ativado automaticamente quando o agente referencia um campo de anexo na instrução. A ausência dessa ativação reduz a precisão de extração em documentos complexos ou com formatação variada.
Sobre condições: se a automação do agente tem uma condição configurada e ela não é atendida, o agente não executa e nenhum crédito é consumido. Condições bem configuradas são uma forma direta de controlar o consumo em processos com alto volume de cards mas poucos casos que realmente precisam da IA.
Use condições nas automações dos AI Agents sempre que possível. Um agente de triagem acionado apenas quando o campo @Tipo for igual a "Incidente crítico" consome créditos só quando faz sentido, não para cada card criado no pipe.
Como acompanhar o consumo em tempo real
O painel de créditos fica em Painel administrativo > Estatísticas de uso > aba Créditos de IA. Lá você encontra o total consumido no período, detalhado por tipo de recurso (Agentes e Assistants).
Na seção Detalhes dos agentes, filtros por Tags, Pipes, Status e Eventos permitem identificar exatamente qual agente e qual pipe estão consumindo mais. Para análise exportável, o botão Baixar relatório entrega os dados em formato tabular.
Para investigar execuções específicas e diagnosticar comportamentos inesperados, os Logs de automação mostram cada acionamento: quando disparou, qual condição foi avaliada, quais ações foram executadas e o resultado. O caminho: cabeçalho do pipe > Automações > Logs.
O painel de Créditos de IA é atualizado a cada 12 horas a partir do primeiro acesso. O saldo exibido pode não refletir execuções das últimas horas. Em processos de alto volume, considere isso ao avaliar o saldo disponível.
Como usar créditos com eficiência
O consumo de créditos não é problema quando está alinhado com o valor gerado. Um agente que elimina 2 horas de triagem manual por dia justifica muito mais créditos do que um agente acionado para cada card sem critério. Três práticas que reduzem consumo sem reduzir valor:
Configure condições para filtrar acionamentos desnecessários. O gatilho dispara para todos os cards, mas o agente só executa quando a condição é atendida. Zero crédito para execuções sem propósito.
Consolide ações em um único comportamento. Cada comportamento executa até 3 ações por acionamento com o mesmo custo base. Preencher três campos num único comportamento custa 2 créditos. Criar um comportamento por campo custa 6.
Use BYO-LLM para processos de alto volume sem necessidade de documento. Execuções com modelo próprio custam 1,5 crédito contra 2 do Pipefy AI. Em processos com centenas de execuções por mês, a diferença é relevante.
O que acontece quando os créditos acabam
Quando o saldo chega a zero, os AI Agents param de executar. As automações continuam ativas e os gatilhos continuam sendo avaliados, mas as ações da IA não são realizadas. Os cards seguem o fluxo normal do pipe sem o enriquecimento que o agente faria.
Não há interrupção abrupta do processo. O que acontece é que o trabalho que o agente fazia volta a depender de intervenção manual até que créditos adicionais sejam adquiridos.
Sinais de que o saldo está acabando:
- Campos que normalmente são preenchidos automaticamente chegam em branco.
- Cards que deveriam ser movidos pelo agente ficam parados na fase de entrada.
- Logs de automação mostram acionamentos sem ação registrada.
- Painel de Créditos de IA mostra saldo próximo de zero.
Monitore o painel de Créditos de IA semanalmente nos primeiros meses após ativar AI Agents. Isso ajuda a calibrar o consumo real antes de ativar em processos críticos com alto volume.
