Confira a Entrada Antes de Acreditar na Saída — aula do módulo Artefatos e Fluxo Avançado, na trilha Começando com Antigravity: do Zero ao Primeiro Resultado…
Leitura de aproximadamente 4 minutos.
Módulo: Artefatos e Fluxo Avançado · Curso: Começando com Antigravity: do Zero ao Primeiro Resultado · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código
O mesmo script do primeiro módulo, rodando sobre uma planilha diferente, produziu um relatório impecável em três segundos, com um cartão grande no topo: Total 26.560,00.
O número real era 11.480,00.
Diferença de 131,4% a mais — e o script não tem bug nenhum. Ele somou exatamente o que estava no arquivo. O problema é que o arquivo continha coisas que não são vendas.
Não é escrever prompt ruim. É acreditar no primeiro número que aparece na tela, porque ele veio formatado, colorido e rápido. A gente confia na aparência.
E o agente não tem como saber que aquela linha lá embaixo da sua planilha é um total, e não uma venda. Quem erra aqui não é a inteligência artificial: é a planilha. E a planilha é sua.
Todas comuns, todas invisíveis a olho nu, todas abrindo no Excel sem uma única mensagem de erro:
1. Linha de TOTAL dentro dos dados. A soma entra na soma outra vez. 2. Linha duplicada exata. A mesma venda lançada duas vezes, coisa de exportação repetida. 3. Valor entre parênteses. Em planilha, (350,00) significa menos 350. Em quase todo script ingênuo, vira mais 350 — erro de 700 numa linha só. 4. Data impossível. 2026-13-45 não é data, e o agrupamento por mês faz o que puder com ela. 5. Formato misturado na mesma coluna. Sete células com R$ 1.250,00 e quatro com 980.
O detalhe cruel: naquele arquivo, a linha de TOTAL dizia 13.280,00 — que é exatamente a soma errada, já com a duplicata dentro. Quem confere o relatório "batendo com o total da planilha" bate com o erro e vai dormir tranquilo.
Escreva um conferir-csv.ps1 que audite um CSV antes de eu confiar em qualquer
relatório feito em cima dele. Ele não gera relatório: procura linha de TOTAL ou SUBTOTAL
dentro dos dados, linhas duplicadas exatas, valores entre parênteses (que em planilha
significam negativo), datas que não convertem, células vazias na coluna de valor e mistura
de formatos de número na mesma coluna. No fim, mostre lado a lado o total ingênuo (somando
tudo) e o total honesto (sem a linha de total e sem a duplicata), com a diferença em reais
e em porcentagem. Código de saída 1 se achar qualquer coisa.
Duas escolhas de projeto merecem atenção. Primeiro: ele não gera relatório. Auditor que também produz o resultado final acaba escondendo o problema numa nota de rodapé. Segundo: os dois totais lado a lado. Ele não decide por você qual está certo — ele te obriga a decidir.
powershell -NoProfile -ExecutionPolicy Bypass -File .\conferir-csv.ps1 -Csv .\vendas-armadilha.csv
Saída medida, em 1,50 s:
ARMADILHAS (5)
- linha duplicada (1) linha 7 e igual a linha 6
- valor entre parenteses (1) linha 8 : "(350,00)" e negativo em planilha
- data invalida (1) linha 10 : "2026-13-45" nao vira data
- linha de TOTAL (1) linha 12 soma o que ja foi somado
- formato misturado (1) 7 celula(s) com "Rquot; e 4 sem, na mesma coluna
Total ingenuo (somando tudo): 26.560,00
Total honesto (sem TOTAL nem duplicata): 11.480,00
Diferenca: 15.080,00 (131,4% a mais)
Código de saída 1. Cinco problemas, cada um com o número da linha. Encontrar o primeiro à mão levou um minuto — e o arquivo tem onze linhas. Numa planilha de duas mil, boa sorte.
Rode o mesmo auditor sobre a planilha limpa do primeiro módulo:
powershell -NoProfile -ExecutionPolicy Bypass -File .\conferir-csv.ps1 -Csv .\vendas.csv
Saída medida: Nenhuma armadilha encontrada. Total: 868.141,17, código de saída 0.
Esse teste é obrigatório. Um verificador que aponta problema em tudo não serve para nada — você para de ler em uma semana. É o arquivo limpo passando que dá crédito ao alarme quando ele toca.
Antes de mandar qualquer relatório para alguém:
1. Esse número tem uma linha de total escondida dentro dele? 2. Tem lançamento repetido? 3. Tem estorno que virou entrada?
Se você não sabe responder, você não sabe o número — você sabe a cor do gráfico.
E o fecho que amarra a trilha inteira: isso não é sobre inteligência artificial. Vale para a fórmula do Excel que você copiou, para o painel do sistema e para o relatório que outra pessoa te mandou. A IA só deixou tudo isso rápido demais para dar tempo de desconfiar.