Controlar gastos do agente e aprovar solicitações
Como os agentes iniciam trabalhos pagos: cotações, limites de gastos por trabalho, dia e mês, Aprovar automaticamente abaixo, e como aprovar ou negar solicitações do agente. Quem decide, expiração e cada mensagem de recusa.
Os agentes podem iniciar trabalhos que custam créditos, como um vídeo de demonstração de produto ou um clipe para redes sociais, mas apenas dentro dos limites que você definir no token deles, e uma pessoa aprova qualquer coisa acima da linha automática do token. Este artigo explica os limites de gastos, a aprovação automática e como aprovar ou negar a solicitação de um agente.
O que custa créditos
| Gratuito para agentes | Custa créditos (o mesmo que no aplicativo) |
|---|---|
| Ler, pesquisar e listar | Vídeos a partir de uma gravação (tutorial, demonstração de produto, limpeza, estilizado) |
| Cotações e testes | Clipes para redes sociais |
| Verificar e aguardar trabalhos | Artigos a partir de uma gravação |
| Exportações de vídeo (MP4 até 4K) | Traduções de vídeo |
| Enviar materiais e imagens | Traduções de artigos da central de ajuda, changelog e páginas do site, e páginas do site geradas por IA |
Para iniciar um trabalho pago, um token precisa de credits:spend e da permissão para esse trabalho (por exemplo, videos:create). As predefinições de Produtor e Agente do espaço de trabalho incluem ambos.
Como um início pago é verificado
Todo início pago é cotado primeiro. A cotação fornece uma faixa de créditos (por exemplo, 45–60 créditos), é válida por 15 minutos e pode ser usada uma vez. Quando o agente a inicia, o Clevera verifica, nesta ordem:
- O plano. O trabalho pago do agente está disponível nos planos Pro, Business e Custom. Caso contrário: "Seu plano não inclui trabalho pago do agente. Faça um upgrade para permitir que os agentes o iniciem."
- Créditos. O espaço de trabalho precisa de créditos suficientes para a cotação, assim como quando você inicia o trabalho no aplicativo.
- Os limites do token. O valor máximo da cotação deve se ajustar ao Por trabalho, e ao que resta de Por dia e Por mês (créditos gastos neste dia ou mês, mais as cotações dos trabalhos do token que ainda estão em execução). Acima de um limite: "Isso ultrapassaria o limite de gastos do token. Um administrador do espaço de trabalho pode aumentá-lo."
- Aprovação. Se o valor máximo da cotação estiver abaixo do valor de Aprovar automaticamente abaixo do token, o trabalho começa. Caso contrário, ele aguarda uma pessoa em Solicitações do agente.
O trabalho é cobrado pelo que realmente utiliza, como no aplicativo. Dias e meses são dias e meses corridos.
Definir os limites
Você define os limites na etapa Limites quando cria o token. Gastos aparece apenas quando o token tem credits:spend.
| Campo | O que faz | Vazio ou 0 |
|---|---|---|
| Por trabalho | O valor máximo que um início pode ser cotado. | Vazio: sem limite. |
| Por dia | O máximo que o token pode gastar em um dia corrido. | Vazio: sem limite. |
| Por mês | O máximo que o token pode gastar em um mês corrido. | Vazio: sem limite. |
| Aprovar automaticamente abaixo | Inícios cotados abaixo desta quantidade de créditos são executados sem uma pessoa. | 0: "uma pessoa aprova cada início pago". |
| Plano | Aprovar automaticamente abaixo no máximo |
|---|---|
| Pro, Business | 500 créditos |
| Custom | 1.000 créditos |
Os limites são em créditos inteiros. Os limites de um token não podem ser alterados posteriormente: para aumentá-los ou diminuí-los, crie um novo token e revogue o antigo. Um segredo regenerado mantém os mesmos limites.
Aprovar ou negar uma solicitação
Abrir Solicitações do agente
Quando um agente aguarda, o proprietário do espaço de trabalho, os administradores e o proprietário do token recebem uma notificação, "agente precisa da sua aprovação", com "Ele deseja gastar até n créditos." Clique em Revisar ou abra AI agents & API → Solicitações do agente. A aba mostra quantos estão aguardando.
Verificar a solicitação
Cada solicitação em Aguardando você mostra o agente, o tipo (Gastar créditos), a faixa de créditos, o que ele deseja fazer, quando foi Solicitado, quando Expira e o token que ele usou.
Cada solicitação mostra o que o agente deseja fazer e a faixa de créditos. Decidir
Clique em Aprovar e confirme em "Aprovar esta solicitação?": o trabalho começa. Clique em Negar: o trabalho é cancelado e nada é cobrado. Se o espaço de trabalho não estiver mais no plano Pro ou superior, Aprovar dirá "O acesso à API e ao agente não está no seu plano."; Negar ainda funciona.
- Apenas o proprietário do espaço de trabalho e os administradores decidem os gastos. Outros veem "Um proprietário ou administrador decide". Um agente nunca pode aprovar sua própria solicitação, e os tokens de agente não podem chamar os endpoints de aprovação.
- As solicitações expiram após 24 horas. O trabalho de uma solicitação expirada é cancelado, e o agente precisa solicitar novamente.
- As solicitações decididas e expiradas movem-se para o Histórico ("Solicitações que foram decididas ou expiraram.") com o resultado (Aprovado, Negado, Expirado, Cancelado) e quem decidiu.
- O agente vê seu trabalho como
needs_inputenquanto aguarda, e o resultado quando você decide. Com webhooks, seus sistemas recebemapproval.requestedeapproval.decided.
Membros que não são proprietários ou administradores veem apenas as solicitações de seus próprios agentes: "Antes que seus agentes gastem créditos ou publiquem, eles solicitam aqui e aguardam um proprietário ou administrador."
Outros limites de gastos
| Limite | O que acontece |
|---|---|
| 20 inícios pagos por hora por token, 100 por dia por espaço de trabalho | Inícios adicionais são recusados com rate_limited até que a janela passe. |
| Créditos gastos incomumente rápido por um token | O token não pode iniciar trabalho pago por 24 horas, e o proprietário recebe "Atividade incomum em token": "Ele gastou um número incomumente alto de créditos em poucos minutos, então não pode iniciar trabalho pago por enquanto." |
| Dois inícios verificados no mesmo momento | "Outro início está sendo verificado. Tente novamente em um momento." |
Solução de problemas
| Mensagem | Causa | Solução |
|---|---|---|
| "Isso ultrapassaria o limite de gastos do token. Um administrador do espaço de trabalho pode aumentá-lo." | A cotação não se ajusta ao Por trabalho, ou ao que resta de Por dia ou Por mês. | Aguarde o próximo dia ou mês, ou crie um token com limites maiores. |
| "Seu plano não inclui trabalho pago do agente. Faça um upgrade para permitir que os agentes o iniciem." | O espaço de trabalho não está no plano Pro, Business ou Custom. | Faça um upgrade. |
| Uma mensagem de "créditos insuficientes" | O espaço de trabalho não tem créditos suficientes para a cotação. | Comprar créditos ou aguarde sua franquia. |
| "Esta cotação expirou. Solicite uma nova cotação." | Mais de 15 minutos desde a cotação. | O agente solicita uma nova cotação. |
| "Esta cotação já foi usada. Solicite uma nova cotação." | A cotação já iniciou um trabalho. | O agente solicita uma nova cotação. |
| "Seu plano aprova o trabalho do agente automaticamente abaixo de 500 créditos no máximo." | Aprovar automaticamente abaixo está acima do máximo do plano. | Diminua-o. |
| "O acesso à API e ao agente não está no seu plano." (em Aprovar) | O espaço de trabalho saiu do plano Pro. | Faça um upgrade para o Pro, ou negue a solicitação. |
| "Esta solicitação já foi decidida ou expirou." | Alguém decidiu ou 24 horas se passaram. | Nada a fazer; verifique o Histórico. |
| "Você não pode decidir esta solicitação." | Sua função não pode aprovar gastos. | Peça ao proprietário do espaço de trabalho ou a um administrador. |
| O agente aguarda e nada acontece | A solicitação está aguardando em Solicitações do agente. | Aprove ou negue dentro de 24 horas. |