Usage

A seção Usage oferece uma visão completa de como o seu workspace está consumindo recursos de acordo com o seu plano ativo.

Aqui você pode acompanhar o volume de execuções nos três pilares de uso, ver os limites de Internal Test Usage e Vibe Agent Usage, e monitorar os limites estruturais do seu workspace.

🔹 Visão geral

Cada workspace na Zaia tem seu próprio painel de uso, exibindo dois tipos principais de informação:

Limites renováveis (mensais) → vinculados ao consumo de execuções. Reiniciam automaticamente no início de cada ciclo de faturamento.
Limites permanentes (baseados no plano) → vinculados à estrutura do seu workspace. Fixos até você fazer upgrade do plano.

A página Usage também mostra o consumo atual e o limite disponível para Internal Test Usage e Vibe Agent Usage no mesmo painel.

🔄 Uso renovável (reinicia mensalmente)

Essas métricas se renovam automaticamente no início de cada novo ciclo de faturamento.

O uso renovável acompanha os três principais pilares do seu plano:

External Executions — interações que seus agentes têm com usuários reais em canais ativos (WhatsApp, Instagram, Widget, etc.)
Internal Test Usage — interações feitas pelo Internal Chat, seu ambiente privado de testes dentro da plataforma
Vibe Agent Usage — interações com o Vibe Agent para criar, configurar ou diagnosticar agentes por linguagem natural

Você pode ver tanto o uso quanto o limite de Internal Test Usage e Vibe Agent Usage diretamente na página Usage.

Quando o ciclo mensal reinicia, os três contadores voltam a zero — permitindo operação contínua.

⚠️ Importante: Se você atingir seu limite de execuções antes do ciclo reiniciar, seus agentes deixarão de responder aos usuários até que o limite seja renovado ou o plano seja atualizado.

👥 Gerenciando o uso do Vibe Agent por member

Donos e admins do Console podem abrir Manage usage no card de resumo do Vibe Agent para distribuir a cota mensal de Vibe Agent do Console entre os members aceitos.

Quando uma distribuição é salva:

As porcentagens devem somar exatamente 100%.
O limite individual de cada member é sua porcentagem da cota mensal atual do Console.
O uso do ciclo atual é comparado a esse limite individual.
Um member é bloqueado de novas execuções de Vibe Agent ao atingir seu limite individual.
Um member com 0% fica bloqueado enquanto a distribuição estiver ativa.
O limite total de Vibe Agent do Console continua se aplicando, além dos limites individuais.
As alterações têm efeito imediato no ciclo atual.

Apenas members aceitos do Console aparecem na distribuição. Convites pendentes não são listados. Members recém-aceitos aparecem com 0% até que a distribuição seja atualizada.

Se nenhuma distribuição tiver sido salva, o Vibe Agent mantém o comportamento anterior de uso compartilhado. Limpar a distribuição após a confirmação também retorna o Console a esse comportamento.

A página impede salvar uma distribuição não vazia cujo total seja diferente de 100%. Se os dados atuais não puderem ser carregados, o rascunho existente é preservado e a página oferece uma ação para tentar novamente.

🏗️ Uso permanente (limites baseados no plano)

Alguns recursos são estruturais — vinculados ao seu plano atual e não reiniciam mensalmente.

Eles definem o quanto seu workspace pode escalar em dados e organização:

Members — membros da equipe com acesso ao workspace
Connections — integrações com serviços externos
Tables e linhas de Tables — armazenamento de dados estruturados
Knowledge Bases e caracteres de Knowledge Base — conteúdo disponível para os agentes
Execuções simultâneas de Workflow — execuções paralelas de workflow
Versões de rollback — versões anteriores de agentes disponíveis para restauração

Esses limites permanecem fixos até você fazer upgrade do plano.

🔍 Inspecionando detalhes de execução por Agente

Você pode ver como as execuções são consumidas durante as conversas inspecionando a resposta de um Agente.

Para fazer isso, abra qualquer ticket ou conversa e clique no contador de créditos no painel superior direito.

Isso exibirá:

Total de créditos usados naquela resposta
Tempo de execução por etapa
Chamadas de tools e iterações de raciocínio com logs detalhados

💡 Dica: Esse recurso é especialmente útil para entender quais Agentes consomem mais recursos e otimizar a eficiência dos prompts.

🔌 Custom Providers

Custom Providers permitem conectar um Agente à sua própria chave de API de LLM — como OpenAI, Anthropic, Google Gemini ou outras — em vez de usar o modelo padrão da Zaia.

Isso afeta qual modelo o Agente usa, mas não impacta os limites de execução nem o rastreamento de uso de forma alguma. Todos os limites do plano continuam se aplicando normalmente.

✅ Boas práticas

Verifique o painel Usage regularmente para antecipar o esgotamento de limites antes que afete usuários reais
Inspecione os logs de resposta dos Agentes para entender quais Agentes consomem mais recursos
Use Custom Providers para implantações de alto volume ou especializadas
Revise seu plano ativo em Settings → Subscriptions para opções de upgrade

⚠️ Aviso: Esta página explica como funciona o rastreamento de uso na Zaia. Para limites e detalhes do plano atual, sempre consulte a página de Planos dentro da plataforma.

❓ Perguntas comuns

P: Os limites renováveis reiniciam todo mês? R: Sim. External executions, internal test usage e Vibe Agent usage reiniciam no início de cada ciclo de faturamento.

P: Os limites permanentes reiniciam mensalmente? R: Não. Os limites estruturais (Tables, Knowledge Bases, Members, etc.) estão vinculados ao seu plano e permanecem fixos até você fazer upgrade.

P: Posso continuar usando Agentes após atingir meu limite de execuções? R: Não. Assim que o limite de execuções é atingido, os agentes param de responder até que o limite seja renovado no próximo ciclo de faturamento ou o plano seja atualizado.

P: Os limites são compartilhados entre workspaces? R: Não. Cada workspace tem seu próprio rastreamento de uso e limites independentes.

P: Posso ver qual Agente usa mais recursos? R: Sim — abra o painel Inspect Response em qualquer conversa para ver um detalhamento por ação do Agente.

P: Onde vejo meus limites de Internal Test Usage e Vibe Agent? R: Acesse Settings → Usage. A página mostra tanto o consumo atual quanto o limite disponível para cada métrica.

P: O uso do Vibe Agent conta para minhas execuções externas? R: Não. O uso do Vibe Agent é rastreado separadamente, como sua própria métrica renovável.