Sobre os créditos no Agent UI
Créditos são as unidades que o Agent UI usa quando você interage com IA para criar ou modificar aplicativos e automações. Cada mensagem que você envia ao assistente de IA consome créditos com base na quantidade de trabalho realizado nos bastidores, incluindo o modelo de IA usado e o número de tokens processados.
1 crédito = $0,25 USD
Os créditos são calculados dependendo do modelo de IA usado, da complexidade da solicitação e do número de tokens processados.
Tipos de créditos
O Agent UI usa 2 tipos de créditos:
Créditos de assinatura
Esses créditos vêm com seu plano pago e são redefinidos automaticamente na data de renovação da cobrança a cada mês. Eles são seu saldo de crédito principal para uso diário.
Créditos comprados
Essas são compras únicas de créditos que complementam seus créditos de assinatura. Os créditos comprados expiram 1 ano após a data de compra se não forem usados.
Quando sua conta consome créditos, os créditos de assinatura são usados primeiro. Os créditos comprados são utilizados somente após o saldo da assinatura ser esgotado.
Como os créditos são usados
Não há uma quantidade fixa de créditos por ação. Diferentes operações usam créditos de maneiras diferentes, dependendo do modelo de IA invocado e de quanto processamento é necessário.
Entendendo o uso de créditos
Os créditos são calculados com base nos tokens reais processados — tanto de entrada quanto de saída — pelo modelo de IA subjacente. Um prompt curto que gera uma resposta breve usa menos créditos do que um prompt complexo que processa documentos grandes ou gera saída extensa.
Ações manuais como editar configurações de fluxo de trabalho, gerenciar configurações de equipe ou organizar arquivos não consomem créditos.
Exemplo de Uso de Créditos
Tipo de solicitação | O que geralmente faz | Créditos típicos usados |
|---|---|---|
Mudança visual ou de texto simples | Uma atualização leve que toca um único elemento ou pequeno trecho de texto. | ~ 0,5 créditos |
Melhorando um pequeno recurso | Inspeciona alguns arquivos e ajusta a lógica, então o uso é maior do que um simples ajuste de estilo. | ~ 1 crédito |
Adicionando um recurso complexo | Atualização maior que inclui entidades, fluxos e lógica, exigindo planejamento mais profundo e mais etapas. | ~ 5 créditos |
Esses exemplos são apenas ilustrativos. O uso real depende do modelo de IA e dos tokens processados
Recarga automática
O Agent UI suporta recarga automática de créditos.
Quando a recarga automática está habilitada, sua conta é automaticamente recarregada quando o valor em USD dos seus créditos restantes cai abaixo de um limite configurável.
- Limite padrão: 50 dólares — quando seu saldo cai abaixo desse valor, uma recarga é acionada.
- Valor de recarga padrão: 200 dólares — o número de créditos comprados em cada recarga automática.
Tanto o limite quanto o valor de recarga podem ser personalizados nas configurações de cobrança do seu espaço de trabalho.
Notas importantes sobre a recarga automática:
- A recarga automática usa seu cartão cadastrado através do Stripe.
- Se um pagamento falhar (cartão recusado, autenticação 3D Secure necessária, etc.), a recarga automática é automaticamente desabilitada para evitar tentativas repetidas de falha. Você precisará atualizar seu método de pagamento e reativá-la.
- O sistema inclui proteções para evitar cobranças duplicadas durante uso simultâneo.
Alertas de crédito baixo
Quando seu saldo de créditos cai abaixo de $0.50 (2 créditos), Agent UI envia automaticamente uma notificação por e-mail para sua conta.
Verificando seu saldo de créditos
Seu saldo de créditos é atualizado em tempo real. Você pode visualizar seu saldo atual e detalhamento de uso a qualquer momento nas configurações do seu espaço de trabalho.
Para verificar seu saldo:
1. Clique no ícone do seu perfil na barra lateral.
2. Vá para Settings.
3. Navegue até Billing para ver seus créditos usados e restantes, detalhados por plataforma.
Renovação de créditos
Seus créditos são renovados com base no tipo de crédito:
- Créditos de assinatura: Renovam na data de renovação da sua cobrança — o mesmo dia do mês em que você assinou. Por exemplo, se você assinou em 10 de março, seus créditos renovam no dia 10 de cada mês.
- Créditos comprados: Não renovam. Eles permanecem disponíveis até serem usados ou até expirarem 1 ano após a compra.
Créditos não são acumulados. Créditos de assinatura não utilizados expiram no final do seu ciclo de cobrança. Se você atingir seu limite de créditos, ações que requerem créditos serão pausadas até sua próxima renovação ou até que você compre créditos adicionais.
Usando créditos com equipes
Agent UI usa um modelo de espaço de trabalho baseado em empresa. Cada espaço de trabalho (empresa) tem seu próprio pool de créditos que é compartilhado entre todos os membros desse espaço de trabalho.
Ao trabalhar em conjunto em um espaço de trabalho:
- Uso de IA: Todos os membros da equipe utilizam o mesmo saldo de créditos do espaço de trabalho quando seus aplicativos chamam modelos de IA.
- Funções por usuário: Administradores podem gerenciar cobrança e configurações de crédito. Criadores consomem créditos mas não podem modificar a configuração de cobrança.
Maximizando seus créditos
Aproveite melhor seus créditos Agent UI com estas dicas práticas:
Escolha o modelo de IA certo
Diferentes provedores de IA têm diferentes perfis de custo. Se uma tarefa não requer o modelo mais avançado, usar um modelo mais leve pode reduzir significativamente o consumo de créditos.
Mantenha prompts focados
Prompts curtos e direcionados que descrevem claramente o que você precisa usarão menos tokens e, portanto, menos créditos do que instruções vagas ou excessivamente amplas.
Use bases de conhecimento efetivamente
Estruture bem sua base de conhecimento para que a busca vetorial retorne resultados relevantes rapidamente, reduzindo a necessidade de consultas de acompanhamento que consomem créditos adicionais.
Perguntas frequentes
Por que meu uso de créditos varia entre solicitações semelhantes?
O uso de créditos depende do total de tokens processados, que inclui tanto a entrada (seu prompt mais qualquer contexto que a IA precisa ler) quanto a saída (a resposta da IA). Mesmo solicitações aparentemente semelhantes podem diferir na contagem de tokens com base no histórico da conversa, contexto da base de conhecimento ou comprimento da resposta.
Posso comprar créditos sem alterar meu plano?
Sim. Você pode fazer compras únicas de créditos a qualquer momento. Esses créditos comprados complementam seu saldo de assinatura e expiram 1 ano após a compra.
Como funciona a cobrança automática com 3D Secure?
A cobrança automática usa pagamentos off-session do Stripe. Se seu cartão requer autenticação 3D Secure, a cobrança automática falhará e será desativada. Você precisará completar um pagamento manual com autenticação e então reativar a cobrança automática.
Os créditos são compartilhados entre espaços de trabalho?
Não. Cada espaço de trabalho tem seu próprio saldo de créditos independente. Se você pertence a múltiplos espaços de trabalho, cada um rastreia e consome créditos separadamente.
Ainda posso usar meus aplicativos se ficar sem créditos?
Sim. Você pode continuar usando recursos do aplicativo que não invocam IA. Apenas ações alimentadas por IA pausam até que seus créditos sejam redefinidos ou você compre créditos adicionais.
Como posso ver o que usou meus créditos?
Você pode visualizar seu histórico de uso de créditos em Settings → Billing, onde o uso é detalhado por data, provedor de IA e operação.

