Monitorar uso e custos do agente

Acompanhe quanto os seus agentes consumiram no mês, veja o gasto por agente e defina um teto para não ter surpresas na fatura da IA.
🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).
Objetivo
Consultar o uso e os custos de IA do mês e, se quiser, definir um teto mensal de gasto.
Pré-requisitos
Perfil Administrador
Módulo Agentes Inteligentes ativo
Pelo menos um agente em uso (veja Criar um agente de IA no builder)
Acesse pelo computador — esta tela não está disponível no celular
Tempo estimado
5 minutos.
Caminho de acesso
Bots → Agentes Inteligentes → botão Uso e Custos
Passo a passo
Na tela Agentes Inteligentes, clique em Uso e Custos, no topo direito. Abre a janela Uso e Custos de IA.
🖼️ PRINT — Janela Uso e Custos de IA com os cartões Custo estimado, Tokens e Turnos e a tabela Por agente.
Confira os cartões do mês atual: Custo estimado, Tokens e Turnos. Os custos são estimativas em dólar, conforme o modelo usado.
Na tabela Por agente, veja o consumo detalhado de cada agente — Turnos, Tokens, Custo e Latência méd.
Para limitar o gasto, ative Limitar gasto mensal, informe o valor em Teto mensal (US$) e clique em Salvar teto. A barra Uso do teto mostra o quanto já foi consumido.
Resultado esperado
Aparece a mensagem "Teto atualizado" e a barra Uso do teto passa a acompanhar o percentual consumido. Ao atingir o teto, novos turnos de IA são transferidos automaticamente para um atendente humano — os agentes param de responder sozinhos até o próximo mês ou até você aumentar o limite.
Ajuste o consumo por agente
O gasto de cada agente depende de dois limites definidos no passo Configurações do agente (veja Criar um agente de IA no builder):
Máx. turnos — quantas trocas de mensagem o agente sustenta em uma conversa antes de encerrar o ciclo.
Máx. tokens — o tamanho máximo de cada resposta. Deixe em branco para usar o automático.
Reduzir esses valores diminui o custo por conversa; aumentá-los deixa o agente mais "conversador" e mais caro.
Erros comuns
Sintoma: aparece "Sem uso registrado neste mês". Solução: normal quando nenhum agente atendeu ainda no período; os números aparecem após as primeiras conversas.
Sintoma: o teto não salva. Solução: ative primeiro Limitar gasto mensal — o campo Teto mensal (US$) só fica disponível com a chave ligada.
Sintoma: os agentes pararam de responder. Solução: verifique se o Uso do teto chegou a 100%. Aumente o Teto mensal (US$) ou aguarde o próximo mês.
Artigos relacionados
Criar um agente de IA no builder
Configurar seu provedor de IA (chave própria)
Definir supervisão humana e hand-off para agente humano
Como funciona a cobrança dos módulos?