Visão geral
A seção Uso exibe o consumo real do workspace em relação aos limites do plano ativo. Use esse painel para acompanhar tendências, identificar agentes ou canais com alto volume e antecipar a necessidade de upgrade antes de atingir os limites.
O acesso é restrito a membros com role manager ou owner. Acesse em Configurações > Uso.
Os dados são atualizados em tempo quase real — o atraso típico entre uma mensagem processada e a contabilização no painel é de alguns minutos. Filtros de período (7 dias, 30 dias, mês atual, mês anterior e intervalo customizado) permitem isolar janelas específicas de análise.
Uso renovável (reseta mensalmente)
Métricas renováveis são reiniciadas no início de cada ciclo de faturamento. O consumo do período corrente é comparado ao limite incluído no plano:
| Métrica | Descrição |
|---|
| Créditos de IA consumidos | Total de créditos usados por mensagens processadas pelos agentes no período. O custo por mensagem varia conforme o modelo LLM: Claude Haiku 4.5 = 3 créditos, Claude Sonnet 4.6 = 4 créditos, GPT-5.1 = 4 créditos, Gemini 2.5 Flash = 2 créditos, Kimi K2.5 = 1 crédito |
| Execuções de agente | Número de vezes que um agente foi acionado por uma mensagem de entrada no período |
| Mensagens processadas | Total de mensagens que passaram pelo pipeline de IA (entrada + saída) em todos os canais |
| Membros ativos | Usuários com acesso ao workspace no período (comparado ao limite do plano) |
Uso permanente (limites baseados no plano)
Limites permanentes não se renovam mensalmente — são determinados pelo plano contratado e se mantêm enquanto o plano estiver ativo:
| Limite | Descrição |
|---|
| Agentes de IA | Número máximo de agentes ativos que podem ser criados no workspace |
| Squads | Número máximo de squads que podem ser criados e vinculados a canais |
| Canais conectados | Total de canais de atendimento ativos (WhatsApp, Instagram, widget, etc.) |
| Integrações Composio | Acesso às integrações externas via Composio (disponível em todos os planos) |
Inspecionando o consumo de créditos por agente
A visão agregada do painel mostra o consumo total do workspace. Para identificar quais agentes são responsáveis pelo maior volume de créditos:
- Na seção Créditos por agente, cada agente aparece com seu total consumido no período filtrado.
- Clique no nome do agente para ver o detalhamento por dia e por conversa.
- O modelo LLM associado a cada agente aparece ao lado do nome — use essa informação para avaliar se um modelo mais econômico atenderia ao caso de uso.
Agentes em squads consomem créditos individualmente. Um handoff entre dois agentes dentro de um squad conta como duas execuções separadas — uma para o agente que recebeu e uma para o agente que respondeu.
Provedores próprios
Ao conectar uma chave própria de provedor (OpenAI, Anthropic, Google ou OpenRouter), o consumo de tokens é cobrado diretamente na sua conta do provedor — não nos créditos incluídos no plano da Timely.ai:
- Agentes configurados com um provedor próprio aparecem na seção Provedores externos do painel de Uso.
- O volume de tokens (entrada e saída) processado por esses agentes é exibido para fins de monitoramento, mas não deduz do saldo de créditos do plano.
- O custo real fica visível no painel de faturamento do provedor (ex.: platform.openai.com ou console.anthropic.com).
Workspaces com alto volume de mensagens em modelos premium (como Claude Opus 4.6 com 20 créditos/msg) podem reduzir significativamente o custo por mensagem migrando para um provedor próprio com contrato de volume. Compare o custo por token do provedor com o custo equivalente em créditos do plano antes de decidir.
Boas práticas
- Acesse o painel de Uso pelo menos uma vez por semana em períodos de crescimento. Consumo que parece controlado pode dobrar rapidamente com um aumento de volume em canais.
- Monitore separadamente os agentes que usam modelos com alto custo em créditos. Se um agente usa Claude Opus 4.6 (20 créditos/msg) para tarefas simples, migre para Claude Haiku 4.5 (3 créditos/msg) ou Kimi K2.5 (1 crédito/msg).
- Use o filtro de intervalo customizado para isolar o impacto de campanhas de marketing ou broadcasts — picos de volume nesses períodos podem distorcer as projeções mensais.
- Se a projeção indicar ultrapassagem do limite de créditos antes do fim do ciclo, faça o upgrade com antecedência para evitar bloqueio de mensagens.
- Configure alertas de uso em Configurações > Perfil > Notificações para receber e-mails automáticos quando o consumo atingir 70%, 90% e 100% do limite.
Perguntas frequentes
O que acontece quando os créditos do plano acabam no meio do mês?
Depende da configuração do plano. Planos com excedente pago continuam processando mensagens e o custo adicional é cobrado na próxima fatura. Planos com limite rígido enfileiram ou bloqueiam novas mensagens até o reinício do ciclo ou upgrade.
Workers consume créditos do plano?
Sim. Mensagens enviadas em sessões de Workers são processadas pelo mesmo pipeline dos agentes e consomem créditos normalmente.
Agentes em squads consomem créditos separados?
Sim. Cada agente dentro de um squad consome créditos de forma independente conforme o modelo LLM configurado para ele.
Posso ver o consumo de um workspace específico se tiver múltiplos?
Sim. O seletor de workspace no topo do painel de Uso permite alternar entre workspaces e ver o consumo de cada um individualmente.
Créditos não usados acumulam para o próximo mês?
Não. Créditos renováveis não acumulam — o saldo restante ao fim do ciclo é zerado na renovação. Apenas planos anuais recebem o crédito completo do ano de uma vez, sem renovação mensal.
