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

> Quando um agente de IA escreve um vídeo como código, o erro quase nunca é no código: é texto em cima do rosto, zoom fora do tempo da fala. O artigo do Kodecz mostra como o editor deixa o agente ver e conferir o próprio vídeo, e mede isso em 5.007 casos. Resumo simples, com os números.

Pedro Henrique Lahr, Konecz, 2026-11-01. https://konecz.com/blog/kodecz-agentes

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](https://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](https://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