Peça um Recorte, Não um Relatório — aula do módulo Artefatos e Fluxo Avançado, na trilha Começando com Antigravity: do Zero ao Primeiro Resultado da formação…
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 relatório do primeiro módulo diz quem vendeu e o quê: tabelas por Região, Produto e Vendedor. Aí alguém pergunta outra coisa: "a gente está crescendo?". E, olhando aquele relatório, não dá para responder.
O reflexo natural é pedir "melhora o relatório". Esse é o pedido mais vago que existe, e ele tem um problema conceitual antes de ter um problema prático: o relatório não está ruim. Ele responde outra pergunta muito bem.
Um pedido, uma pergunta, um arquivo.
Quando você junta três perguntas num pedido só, o agente entrega três coisas medianas, e nenhuma delas responde bem à sua dúvida principal. Quando você isola a pergunta, o recorte sai afiado.
Na prática: em vez de mexer no que já funciona, escreva a pergunta em uma linha — estou crescendo? — e peça um arquivo novo que responda só isso.
Nesta pasta existe o vendas.csv. Escreva um script PowerShell chamado
evolucao-mensal.ps1 que responda uma pergunta: o faturamento está subindo ou caindomês a mês? Gere um único arquivo HTML com um gráfico de barras por mês, a variação
percentual de cada mês contra o anterior, e cartões com melhor mês, pior mês, média
mensal e a comparação dos 3 últimos meses contra os 3 anteriores. Barra de mês que caiu
sai em vermelho. O script descobre sozinho a coluna de data e a de valor. Não mexa no
relatorio-csv.ps1: este é um arquivo novo. HTML autossuficiente, sem link externo.Windows, PowerShell que já vem no sistema, sem instalar nada.
"Não mexa no relatorio-csv.ps1." Essa frase é o freio de mão, e ela vale tanto quanto tudo que vem antes. Dizer o que o agente não deve tocar protege o trabalho que já está conferido. Sem ela, é comum ele "aproveitar" para reorganizar o script antigo, e aí você tem duas coisas para revisar em vez de uma.
powershell -NoProfile -ExecutionPolicy Bypass -File .\evolucao-mensal.ps1 -Csv .\vendas.csv
Saída medida:
7 meses | data: Data | valor: Valor | melhor: mar/26 | pior: fev/26
...\demo\evolucao-vendas.html (5.3 KB)
| Item | PowerShell 5.1 | PowerShell 7.6.5 | |---|---|---| | Tempo de execução | 2,08 s | 2,82 s | | Tamanho do HTML | 5.463 bytes | 5.460 bytes | | Meses detectados | 7 | 7 |
O HTML abre com os cartões no topo, o gráfico com as barras de queda em vermelho e a tabela do mês mais recente para o mais antigo.
Agora a parte que quase ninguém faz.
Some os sete meses da tabela do relatório novo: 868.141,17. Esse é exatamente o total do relatório do primeiro módulo, no centavo. Dois arquivos, dois caminhos independentes, dois recortes diferentes — e um número só.
Se não tivesse batido, um dos dois estaria mentindo, e você não teria como saber qual. É essa conferência que separa "gráfico bonito" de "número em que eu posso confiar".
Sempre que você gerar um recorte novo sobre dados que já tinham um relatório confiável, procure um número que os dois precisam ter em comum e compare. Total geral, contagem de registros, maior valor — qualquer um serve, desde que os dois cheguem lá por caminhos diferentes.
Não entre em pânico e não conserte o novo às pressas. Investigue nesta ordem:
1. A quantidade de linhas é a mesma? Se um leu 180 e o outro 179, o problema é de leitura do arquivo, não de cálculo. 2. A coluna de valor detectada é a mesma? As duas linhas de resumo na tela dizem isso. 3. Algum dos dois está filtrando alguma coisa? Exclusão de linha vazia, por exemplo. 4. Alguma linha do arquivo não é dado? Linha de total dentro da planilha é a causa mais comum, e é o assunto da terceira aula deste módulo.