O que é o TokenEconomizer
O TokenEconomizer é um plugin Python e um artigo científico da Microsoft Research, Microsoft Security e UC Berkeley, publicados sob a licença Apache 2.0. Parte da ideia de que um agente de programação desperdiça tokens das mesmas formas sempre que trabalha no mesmo repositório e de que as sessões já concluídas mostram onde isso acontece. Identifica três mecanismos: microcompetências, remoção de ferramentas e proteção contra ciclos de falhas. O Economizer do VibeiDE segue essa arquitetura nas suas tarefas do Claude Code e do Codex.
Factos sobre o repositório: deixe de falhar sempre no mesmo
Os agentes redescobrem muitas vezes o mesmo facto sobre um repositório através de falhas, tarefa após tarefa: pytest não está no path, mas python -m pytest funciona, um script tem outro nome ou é preciso definir primeiro uma variável. Quando três tarefas mostram a mesma falha e a mesma forma de a contornar, o Economizer guarda essa informação numa linha curta e transmite-a aos agentes seguintes assim que uma quarta tarefa confirma que continua a ser necessária. No início de uma conversa, os agentes recebem no máximo quatro factos, cerca de 150 tokens. Um facto que deixa de ser válido é retirado automaticamente, e também pode mandar esquecer um facto.
Proteção contra ciclos: um único aviso para um turno bloqueado
Um turno que continua a editar e a obter a mesma falha gasta tokens sem avançar. Primeiro, o Economizer aprende quanto dura um turno bem-sucedido no seu projeto. Se um turno do Claude Code ultrapassar largamente essa duração e continuar a editar e a obter a mesma falha, recebe uma única nota a pedir uma abordagem diferente. Se continuar bloqueado, aparece uma linha na tarefa a informá-lo. Nunca interrompe um turno. Um turno bloqueado do Codex não recebe nenhuma nota, apenas a linha destinada a si.
Ferramentas não utilizadas: pedidos mais pequenos
A descrição de cada ferramenta disponível para um agente é reenviada em todos os pedidos. O VibeiDE associa dois servidores de ferramentas próprios, um com ferramentas de navegação e outro com ferramentas de tarefas, que totalizam cerca de 3,400 tokens. Se nenhuma tarefa de um projeto tiver usado um deles ao longo de dez pedidos em duas tarefas, as novas conversas começam sem esse servidor. Um pedido que possa precisar dele volta a disponibilizá-lo, tal como a opção Voltar a disponibilizar no separador Economizer. As ferramentas que instalou e as ferramentas integradas de um agente nunca são removidas.
Um único interruptor, nada para configurar
O Economizer faz parte do Brain. Ative o Brain num projeto e começa a ler; desative-o e nada é lido ou transmitido. O separador Economizer no painel Brain mostra cada facto, o que a proteção contra ciclos aprendeu e quais as ferramentas excluídas. Os únicos botões são Esquecer e Restaurar para os factos e Voltar a disponibilizar para as ferramentas. Lê as chamadas a ferramentas dos próprios agentes, não faz chamadas a modelos e mantém os factos curtos e as contagens no seu computador.
O que não promete
A Microsoft apresenta poupanças de tokens para o seu plugin com base no seu próprio teste de referência. Esses números dizem respeito ao plugin completo, que também usa um modelo para propor competências e avaliar turnos bloqueados. O VibeiDE deixa de fora as partes que recorrem a modelos, pelo que não indicamos um valor de poupança. O que pode verificar está no separador: os factos transmitidos aos agentes, os turnos reorientados e as ferramentas excluídas de um pedido.
Fontes: TokenEconomizer no GitHub, artigo científico do TokenEconomizer.