Agentes autônomos rodam sem ninguém olhando, e por isso merecem acompanhamento de consumo. A tela Uso de tokens dos agentes mostra, execução por execução, quantos tokens de entrada e saída cada agente consumiu e quanto tempo ficou ativo, com o provedor e o modelo usados e a soma dos tokens no rodapé. Este artigo explica cada coluna, o que significa “segundos ativos”, como comparar agentes, como identificar um agente caro ou com problema, e como usar os dados para decidir agendamentos e modelos.
Índice
Onde fica e quem vê
Abra Filipa IA, Agentes, Uso de tokens dos agentes. A tela exige a permissão Execuções de agente de IA (ou usuário master) e os agentes habilitados nas Configurações de IA. Ela lista as execuções de todos os agentes da empresa.
Colunas da lista
| Coluna | Conteúdo |
|---|---|
| Ícone de status | Primeira coluna. Passe o mouse sobre ele para ver o status; nas falhas, o tipo e a mensagem do erro. |
| Data de criação | Quando a execução foi criada. |
| Agentes de IA | Nome do agente. |
| Provedor | Provedor de IA usado pelo agente na execução. |
| Modelo | Modelo usado na execução. |
| Nome do proprietário | Usuário dono do agente. É calculado na hora da consulta, por isso não aceita filtro nem ordenação. |
| Status | Nesta versão aparece o código interno em inglês: SUCCEEDED (concluída), FAILED (falhou), RUNNING (executando) ou QUEUED (na fila). Execuções com falha também consomem tokens. |
| Gatilho | Também em código interno: SCHEDULED (agendado) ou MANUAL. |
| Tokens entrada / Tokens saída | Consumo da execução, com a soma no rodapé. No celular aparecem juntos em “Tokens (entrada/saída)”. |
| Segundos ativos | Tempo de processamento da execução, sem contar a fila. |
| Iniciado / Finalizado | Início e término da execução. |
| Resumo | Resumo do resultado, para identificar a execução. |
O que são segundos ativos
Segundos ativos é o tempo entre o início e o término do processamento, sem contar a espera na fila. O Vendelo calcula esse tempo para qualquer provedor e grava o valor quando a execução é concluída; execuções que falharam aparecem com 0. Um agente com muitos segundos ativos e poucos tokens costuma fazer muitas consultas pequenas ao Vendelo; um com muitos tokens e poucos segundos costuma lidar com grandes volumes de texto. Os dois números juntos descrevem o “peso” do agente.
Totais no rodapé
A tela não tem agrupamentos prontos. O rodapé soma Tokens entrada e Tokens saída de tudo o que está filtrado, então o total muda conforme o filtro. Para saber quanto um agente consumiu no mês, filtre pelo agente e pelo período; para investigar um pico, filtre um único dia e ordene por tokens.
Como interpretar e agir
- Agente caro e útil: considere reduzir a frequência (de horário para diário) ou o escopo (menos colunas, período menor).
- Agente caro e pouco lido: pause. Retome quando houver demanda.
- Consumo crescente da mesma instrução: o volume de dados cresceu. Limite o período relativo (“últimos 30 dias” em vez de “ano atual”).
- Muitas execuções com Falhou: cada falha consome tokens sem entregar. Corrija a instrução (valide com a Filipa) antes de retomar.
- Modelo mais capaz consumindo mais: avalie um modelo mais leve para agentes simples e reserve o mais capaz para relatórios complexos; o modelo é escolhido por agente.
- Execuções manuais frequentes: talvez valha um agendamento; execuções manuais em horário de pico disputam a capacidade com as conversas da Filipa.
Filtros e exportação
Filtre por período, agente, provedor, modelo, status e gatilho; ordene por tokens para ver os mais pesados; salve pesquisas favoritas (por exemplo, “mês atual, agendados”) e exporte para o Excel. Com a exportação, cruze com a tabela de preços do provedor para estimar o custo em moeda por agente.
A tela Uso de tokens do assistente já inclui as execuções dos agentes, com a finalidade Agente. Para o consumo total de IA da empresa, use aquela tela; não some as duas, ou os agentes entram em dobro.
Perguntas frequentes
A validação com a Filipa aparece aqui?
Não. Aqui entram só as execuções dos agentes. A validação com a Filipa também não é registrada em Uso de tokens do assistente.
Por que uma execução tem tokens zerados?
Execuções que falharam antes de chamar o provedor (por exemplo, por erro de configuração) não consomem e ficam com zero. Falhas em que o provedor não chegou a devolver a resposta também ficam com zero, mesmo que tenha havido processamento parcial.
A tela mostra custo em moeda?
Não, apenas tokens e segundos. O custo depende da tabela do provedor; calcule na exportação.
Provedores “via assinatura” cobram por token?
Eles têm custo fixo de assinatura com cotas de uso. Os tokens e segundos ativos servem para acompanhar a cota, não a fatura.
