Guia de Escrita de Comandos do Excelmatic

Propósito

Ensinar você a elaborar comandos eficazes para que o Excelmatic produza exatamente o resultado desejado — de forma rápida, consistente e com mínimo retrabalho.

Por que isso importa

O Excelmatic depende das suas instruções em linguagem natural. Comandos vagos ou subespecificados obrigam a IA a adivinhar, aumentando as chances de saídas incompletas, incorretas ou genéricas demais. Clareza de intenção = melhores planilhas, mais rápido.

1. Fundamentos de Escrita de Comandos

Concentre-se em 4 pilares:

1. AÇÃO: O que deve ser feito? (remover duplicatas, calcular, agrupar, prever, visualizar, extrair, formatar)
2. ESCOPO: Quais colunas / linhas / abas / arquivos? Use nomes de colunas exatos entre aspas simples.
3. CONDIÇÃO(ÕES): Filtros, limites, intervalos de datas, regras de negócio.
4. FORMA DE SAÍDA: Nova aba, sobrescrever, apenas resumo, gráfico, arquivo limpo, adicionar coluna etc.

Bom vs Ruim (Exemplos Centrais)

Padrão Simples

AÇÃO + COLUNAS ALVO + CONDIÇÕES + TRANSFORMAÇÃO + FORMATO DE SAÍDA

Exemplo: Calcule a média de 'Order Value' por 'Channel' nos últimos 90 dias (onde 'Order Date' >= 2025-05-28); exporte tabela resumo + gráfico de barras.

2. Ampliando a Precisão

Use estas técnicas de redação:

• Especificidade de coluna: 'Customer ID' e não customer id ou ID (combine o caso se possível).
• Agregações: soma, média, contagem única, mediana, mínimo, máximo, desvio padrão.
• Cálculos: "Adicione a coluna 'Net' = Revenue - Cost - Tax".
• Janelas de tempo: últimos 30 dias, entre 2024-01-01 e 2024-12-31, mês atual.
• Ordenação: ordene por 'Date' ascendente e depois 'Sales' descendente.
• Formatação: formate 'Date' como YYYY-MM, formate 'Profit Margin' como percentual 1 casa.
• Local de saída: sobrescrever aba atual / criar nova aba 'Summary' / manter ambas.
• Preservação: mantenha a aba original inalterada.
• Limites de linhas: mostre top 20 por 'Sales'.

3. Técnicas Avançadas de Comandos

A. Lógica Condicional

Exemplos:

• Filtre linhas onde 'Revenue' > 1000 E 'Region' IN ("West","North").
• Substitua nulos em 'Price' pela mediana quando 'Category' = 'Accessories'.
• Sinalize outliers: Adicione coluna 'Is Outlier' = 1 se 'ZScore' > 3, caso contrário 0.

B. Combinando Tarefas em Uma Única Passagem

Encadeie operações relacionadas quando a ordem for clara. Exemplo: Limpe 'Orders' removendo duplicatas em 'Order ID', preencha 'Cost' ausente com a mediana, adicione 'Margin'=(Revenue-Cost)/Revenue*100 e crie um gráfico de barras da média de 'Margin' por 'Region'.

C. Estratégia para Grandes Conjuntos de Dados

• Comece com: Forneça resumo da estrutura (colunas, tipos, contagem de linhas).
• Depois: Gere amostra de 10 linhas (aleatórias ou iniciais) para confirmar premissas.
• Após validação: Execute a transformação completa.
• Use comandos incrementais para tarefas pesadas: (1) limpeza, (2) adicionar métricas, (3) visualizar.

D. Gerenciamento de Saída

Especifique: "Crie nova aba 'Cleaned'", "Substitua 'Sheet1' existente", "Adicione gráfico em nova aba 'Charts'", "Retorne apenas o resumo (sem exportar nível de linha)".

E. Pedindo Explicações

Adicione: "Explique cada passo" ou "Forneça a lógica das fórmulas" para auditar transformações.

F. Fórmulas Complexas

Exemplo: Adicione a coluna 'LTV' = (AverageOrderValue * PurchaseFrequency * GrossMargin %) nos últimos 12 meses por 'Customer ID'; exporte tabela por cliente ordenada de forma decrescente.

G. Refinamento Iterativo

1. Primeiro: Resumo de alto nível.
2. Em seguida: Reduza o escopo (ex.: apenas Region='West').
3. Depois: Adicione métricas/visuais.

H. Combinando Arquivos

"Mescle arquivos mensais enviados; adicione 'Month' a partir do nome do arquivo (YYYY-MM); concatene tudo em uma tabela; garanta ordem consistente das colunas; adicione linha de total."

I. Checagens de Qualidade de Dados

"Liste colunas com >10% de valores ausentes; sugira método de preenchimento; não modifique ainda."

4. Modelos Comuns de Comandos

Copie, adapte e execute. Substitua os itens entre colchetes.

Limpeza & Preparação

• Remova duplicatas em '[Primary Key]' mantendo a primeira.
• Padronize o formato de data em '[Date Column]' para YYYY-MM-DD.
• Preencha valores ausentes em '[Column]' com a mediana.
• Separe '[Full Name]' em 'First Name' e 'Last Name'.
• Remova espaços excedentes em todas as colunas de texto.
• Detecte outliers em '[Metric]' usando z-score > 3 e liste as linhas afetadas.

Transformação

• Adicione a coluna '[New Metric]' = ([Numerator] - [Denominator]) / [Numerator] * 100, formatada como percentual.
• Pivot: Some '[Value]' por '[Row Dim]' e '[Column Dim]'.
• Unpivot: Desempilhe '[Jan]'..'[Dec]' em 'Month','Value'.

Análise

• Estatísticas descritivas: média, mediana, mínimo, máximo, desvio para ['Col1','Col2'].
• Correlação entre '[Var A]' e '[Var B]' com interpretação.
• Tendência: Plote '[Metric]' ao longo de '[Date]' e calcule crescimento período a período.
• Preveja '[Metric]' para os próximos 6 períodos usando regressão linear; inclua faixas de confiança.

Visualização

• Gráfico de barras: x='[Category]', y='[Value]' ordenado de forma decrescente.
• Gráfico de linhas: x='[Date]', y='[Metric]' com média móvel janela 7.
• Gráfico de pizza: participação de '[Category]' por '[Value]'.
• Dispersão: '[X]' vs '[Y]' com linha de regressão + correlação.

Business Intelligence

• KPIs: calcule Revenue, Cost, Profit = Revenue - Cost, Margin %.
• Análise de coorte por 'Signup Month' mostrando retenção ao longo dos meses 0–6.
• E se: aumente '[Price]' em 10% e recalcule 'Profit'; resuma a variação.

Operações Multi-Arquivo

• Mescle todos os arquivos enviados; adicione coluna '[Source File]'; alinhe colunas por nome do cabeçalho.
• Anexe arquivos e depois remova duplicatas em '[ID]'.

Formatação & Saída

• Formate '[Currency Column]' como moeda USD com 2 casas decimais.
• Ordene por '[Date]' ascendente e depois por '[Revenue]' descendente.
• Crie nova aba 'Summary' apenas com tabela agregada.
• Mantenha a aba original; coloque os dados transformados em 'Cleaned'.

Auditoria & QA

• Mostre 10 linhas aleatórias após a limpeza para revisão.
• Liste colunas com >5% de valores ausentes; proponha estratégias de preenchimento.

5. Galeria Bom vs Ruim (por Cenário)

6. Solução de Problemas & Refinamento

Sintoma -> Ação:

• Saída genérica demais: Adicione colunas, métricas e níveis de agrupamento específicos.
• Coluna errada escolhida: Use o nome exato entre aspas; opcionalmente, liste colunas: "Liste todos os nomes de coluna primeiro".
• Linhas ausentes após filtro: Reafirme a lógica explicitamente E mencione inclusivo/exclusivo (ex.: Revenue >= 1000).
• Data interpretada de forma errada: Especifique formato-alvo e fuso, se relevante.
• Agregação inesperada: Indique a função desejada (soma vs média vs contagem distinta).
• Lento em arquivo grande: Peça primeiro o resumo do esquema; depois rode as transformações em etapas.
• Fórmula incorreta: Forneça parênteses explícitos e a formatação desejada.
• Gráfico diferente do esperado: Defina tipo, eixos, ordenação, limites (top N), títulos e se deve incluir legenda.
• Precisa desfazer: Reexecute com "Use os dados originais (ignore modificações anteriores)".

Modelo de Loop de Refinamento

1. Inicial amplo: "Forneça lista de colunas e contagem de linhas; sem alterações".
2. Foco: "Remova duplicatas em 'Customer ID'; mostre contagem removida".
3. Expansão: "Adicione coluna 'Profit Margin'".
4. Visualize: "Crie gráfico de barras da média de 'Profit Margin' por 'Region'".
5. Polir: "Formate 'Profit Margin' como percentual com 1 casa; ordene de forma decrescente".

Pedindo Explicações

Adicione: "Explique os passos" ou "Mostre a justificativa das fórmulas" para validar a lógica.

7. Tabela de Referência Rápida

8. Dicas Finais

• Seja explícito primeiro; a brevidade vem depois, quando os padrões forem aprendidos.
• Coloque nomes de colunas entre aspas para evitar ambiguidade.
• Combine apenas passos logicamente sequenciais.
• Solicite explicações ao auditar dados financeiros ou de conformidade críticos.
• Itere: resumo amplo -> transformação direcionada -> enriquecimento -> visualização -> formatação.

Precisa de inspiração? Revise o guia Primeiros Passos para casos de uso de domínio. Pronto para praticar — tente uma cadeia de 3 passos no seu próximo conjunto de dados.

Tem feedback ou um comando teimoso? Escreva para [email protected]. Seus aprimoramentos ajudam a melhorar a IA.

9. Seu Primeiro Comando de Prática

Envie um export recente de vendas e execute:

Remova duplicatas em 'Order ID'; preencha 'Unit Cost' ausente com a mediana; adicione 'Gross Margin %'=(Revenue-Cost)/Revenue*100 como percentual com 1 casa; crie gráfico de barras da média de 'Gross Margin %' por 'Region' ordenado de forma decrescente; coloque o gráfico em nova aba 'Charts'.

Aprimore a partir daí — agora você está escrevendo como um usuário avançado.