Agentes de IA fazendo vídeo: onde erram e como o Kodecz confere

O Kodecz é um editor de vídeo feito para agentes de IA. Este artigo responde duas perguntas: onde os agentes erram quando fazem vídeo, e o que um editor precisa dar a eles para que vejam e corrijam o próprio erro. A resposta curta: o agente quase nunca erra o código. Ele erra o que só aparece quando duas coisas se encontram na tela, como um texto que cai em cima do rosto de quem fala.

O que é um agente de IA?

Um agente de IA é um programa com inteligência artificial que faz tarefas sozinho: lê arquivos, escreve código, roda comandos e confere o resultado. Hoje os agentes já fazem vídeos escrevendo uma página de site, que depois vira um arquivo MP4, quadro por quadro.

O problema é que o agente não assiste ao vídeo. Ele escreve um texto, manda gerar o vídeo e recebe um arquivo que não consegue ver. É como pintar um quadro de olhos vendados e só ouvir no fim se ficou bom.

Onde os agentes erram?

Olhamos 27 defeitos que apareceram nos nossos próprios vídeos antes da entrega:

• 21 eram relações entre duas coisas: texto em cima de um rosto, movimento fora do ritmo da fala, um corte no meio de uma palavra. Nada disso aparece lendo só o código.
• 6 repetiam uma lição que já estava escrita nas instruções do agente. A regra estava lá. O agente só não tinha como ver que o vídeo dele quebrava a regra.

Ou seja, um manual mais longo não resolvia. Faltava dar olhos ao agente.

Depois juntamos relatos públicos: 4.826 relatos e 107 páginas de regras e guias publicados. Os 27 defeitos viraram 106 tipos de erro. Quinze deles são do tipo «parece feito por IA», como o mesmo degradê roxo e azul de sempre ou tudo centralizado.

Como o Kodecz ajuda o agente a ver?

A regra do projeto é simples: tudo o que uma pessoa veria numa linha do tempo de edição, o agente pode pedir como dado ou como imagem. Na prática:

1. Cada quadro tem endereço fixo. O quadro 120 é sempre o mesmo, não importa por onde o vídeo comece. O agente olha, muda e olha de novo o mesmo quadro.
2. Prévia rápida. O agente pede um quadro e recebe a imagem em menos de 2 segundos (de 1,7 a 1,9 s), com os mesmos pixels do vídeo final.
3. Leitura por dentro. Como o motor de render é nosso, ele sabe onde está cada linha de texto, onde está o rosto e que palavra está sendo dita em cada quadro.
4. Conferência automática. Um comando confere o vídeo e responde com o quadro, o elemento e o motivo do problema, mais uma imagem dele. Calibrada em 17 vídeos nossos, aprovados e rejeitados: depois do ajuste, nenhum vídeo aprovado falha e todo erro dos rejeitados continua sendo pego.

Como saber se funciona?

Criamos o Kodecz Bench, um conjunto de 5.007 testes. Cada teste é uma cena correta com um erro plantado de propósito, como quem esconde um objeto num desenho para alguém achar. Quem dá a nota é uma regra fixa que lê o vídeo por dentro, e não outra IA dando opinião.

Cada regra foi testada também contra os erros das outras: ela acusou o erro errado em 99 de 11.025 cruzamentos, 0,9%.

Na primeira rodada, um agente (Claude Opus) recebeu só a documentação e errou 22 de 139 casos, 15,8%. Custou US$ 0,53 por caso. A área com mais erro foi a edição: 36%. Uma rodada mais nova, com 300 casos, deu um número parecido: 35 erros em 219, 16,0%.

O artigo também propõe um jeito de conversar com o agente sobre vídeo em cinco camadas. Ele ainda não foi medido, e o artigo não afirma nada sobre o efeito dele.

Perguntas frequentes

O Kodecz serve só para o Claude? Não. Qualquer agente que escreve arquivos e roda comandos pode usar. O teste do artigo usou o Claude Opus, com um piloto pequeno do Claude Sonnet.

Uma IA dá nota para outra no Kodecz Bench? Não. A nota vem de regras fixas que leem o vídeo por dentro. O mesmo teste dá sempre a mesma resposta.

A conferência vê tudo? Não. Ela lê o texto da página. Texto desenhado dentro de uma imagem ou de um vídeo gravado ela não vê.

Artigo completo

Este texto é um resumo. O artigo completo, com as tabelas, os limites e a lista de erros, está em doi.org/10.6084/m9.figshare.34880928. O código, o guia do agente e o Kodecz Bench estão em github.com/konecz/kodecz.

Como citar: Lahr, Pedro Henrique. Kodecz: a video editor built for AI agents, how agents fail when they write video as code, and how to check it from inside the render. Figshare, 1 nov. 2026. https://doi.org/10.6084/m9.figshare.34880928

Texto em Markdown