Guia de Escrita de Comandos do Excelmatic

Propósito

Ensiná-lo a criar comandos eficazes para que o Excelmatic produza exatamente o resultado desejado – rapidamente, consistentemente e com retrabalho mínimo.

Por que isso Importa

O Excelmatic depende das suas instruções em linguagem natural. Comandos vagos ou mal especificados forçam a IA a adivinhar, aumentando as chances de saídas incompletas, incorretas ou excessivamente genéricas. Intenção clara = planilhas melhores, mais rápido.

1. Noções Básicas 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 / planilhas / arquivos? Use nomes exatos de colunas entre aspas simples.
3. CONDIÇÃO(ÕES): Filtros, limites, intervalos de data, regras de negócio.
4. FORMA DE SAÍDA: Nova planilha, sobrescrever, apenas resumo, gráfico, arquivo limpo, adicionar coluna, etc.

Bons vs Maus Exemplos (Exemplos Principais)

Padrão Simples

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

Calcule a média 'Valor do Pedido' por 'Canal' para os últimos 90 dias (onde 'Data do Pedido' >= 2025-05-28); saída tabela resumo + gráfico de barras.
Copy

2. Expandindo a Precisão

Use estas técnicas de redação para comandos mais claros:

3. Técnicas Avançadas de Comando

A. Lógica Condicional

Exemplos:

Filtre linhas onde 'Receita' > 1000 E 'Região' EM ("Oeste","Norte").
Copy

Substitua nulos em 'Preço' pela mediana onde 'Categoria' = 'Acessórios'.
Copy

Sinalize outliers: Adicione coluna 'É Outlier' = 1 se 'ZScore' > 3 senão 0.
Copy

B. Combinando Tarefas em uma Única Passagem

Encadeie operações relacionadas quando a ordem for clara. Exemplo:

Limpe 'Pedidos' removendo duplicatas em 'ID do Pedido', preencha 'Custo' ausente com mediana, adicione 'Margem'=(Receita-Custo)/Receita*100, então crie gráfico de barras da média 'Margem' por 'Região'.
Copy

C. Estratégia para Grandes Conjuntos de Dados

• Comece com:

Forneça resumo da estrutura (colunas, tipos, contagem de linhas).
Copy

• Depois:

Gere amostra de 10 linhas (aleatória ou início) para confirmar suposições.
Copy

• Após validação: Execute transformação completa.
• Use comandos incrementais para tarefas pesadas: (1) limpar, (2) adicionar métricas, (3) visualizar.

D. Gerenciamento de Saída

Especifique:

Crie nova planilha 'Limpo'.
Copy

Substitua 'Planilha1' existente.
Copy

Adicione gráfico a nova planilha 'Gráficos'.
Copy

Retorne apenas resumo (sem exportação em nível de linha).
Copy

E. Pedindo Explicações

Adicione: Explique cada passo ou Forneça justificativa da fórmula para auditar transformações.

F. Fórmulas Complexas

Exemplo:

Adicione coluna 'LTV' = (ValorMédioPedido * FrequênciaCompra * MargemBruta %) nos últimos 12 meses por 'ID do Cliente'; saída tabela nível cliente ordenada decrescente.
Copy

G. Refinamento Iterativo

1. Primeiro: Resumo de alto nível.
2. Próximo: Reduza o escopo (ex., apenas Região='Oeste').
3. Então: Adicione métricas/visuais.

H. Combinando Arquivos

Mescle os arquivos mensais enviados; adicione 'Mês' a partir do nome do arquivo (AAAA-MM); concatene todos em uma tabela; garanta ordem de coluna consistente; adicione linha total.
Copy

I. Verificações de Qualidade de Dados

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

4. Modelos de Comandos Comuns

Copie, adapte e execute. Substitua itens entre colchetes.

Limpeza & Preparação

Remova duplicatas em '[Chave Primária]' mantenha primeira.
Padronize formato de data em '[Coluna Data]' para AAAA-MM-DD.
Preencha '[Coluna]' ausente com mediana.
Divida '[Nome Completo]' em 'Nome' e 'Sobrenome'.
Remova espaços em branco em todas as colunas de texto.
Detecte outliers em '[Métrica]' usando z-score > 3 e liste linhas afetadas.
Copy

Transformação

Adicione coluna '[Nova Métrica]' = ([Numerador] - [Denominador]) / [Numerador] * 100 formatada percentual.
Pivot: Soma '[Valor]' por '[Dim Linha]' e '[Dim Coluna]'.
Despivote colunas '[Jan]'..'[Dez]' em 'Mês','Valor'.
Copy

Análise

Estatísticas descritivas: média, mediana, mín, máx, desv padr para ['Col1','Col2'].
Correlação entre '[Var A]' e '[Var B]' com interpretação.
Tendência: Plote '[Métrica]' sobre '[Data]' e compute crescimento período sobre período.
Preveja '[Métrica]' próximos 6 períodos usando regressão linear; inclua faixas de confiança.
Copy

Visualização

Gráfico de barras: x='[Categoria]', y='[Valor]' ordenado decrescente.
Gráfico de linhas: x='[Data]', y='[Métrica]' com média móvel janela 7.
Gráfico de pizza: participação de '[Categoria]' por '[Valor]'.
Gráfico de dispersão: '[X]' vs '[Y]' adicione linha de regressão + correlação.
Copy

Business Intelligence

Resumo KPI: compute Receita, Custo, Lucro = Receita - Custo, Margem %.
Análise de coorte por 'Mês de Cadastro' mostrando retenção ao longo dos meses 0-6.
What-if: aumente '[Preço]' em 10% e recalcule 'Lucro'; resuma delta.
Copy

Operações com Múltiplos Arquivos

Mescle todos os arquivos enviados; adicione coluna 'Arquivo Fonte'; alinhe colunas por nome do cabeçalho.
Acrescente arquivos depois remova duplicatas em '[ID]'.
Copy

Formatação & Saída

Formate '[Coluna Moeda]' como moeda USD 2 decimais.
Ordene por '[Data]' crescente depois por '[Receita]' decrescente.
Crie nova planilha 'Resumo' apenas com tabela agregada.
Mantenha planilha original; coloque dados transformados em 'Limpo'.
Copy

Auditoria & QA

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

5. Galeria de Comandos Bons vs Maus (Por Cenário)

6. Solução de Problemas & Refinamento

Modelo de Loop de Refinamento

1. Inicial amplo:

Forneça lista de colunas e contagem de linhas; sem alterações ainda.
Copy

2. Foco:

Remova duplicatas em 'ID do Cliente'; mostre contagem removida.
Copy

3. Estender:

Adicione coluna 'Margem de Lucro'.
Copy

4. Visualizar:

Crie gráfico de barras da média 'Margem de Lucro' por 'Região'.
Copy

5. Polir:

Formate 'Margem de Lucro' percentual 1 decimal; ordene decrescente.
Copy

Pedindo Explicações

Adicione: Explique passos ou Mostre fórmulas usadas para validar lógica.

7. Folha de Referência Rápida

8. Dicas Finais

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

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

Tem feedback ou um comando teimoso? Entre em contato em [email protected]. Seus refinamentos ajudam a melhorar a IA.

9. Seu Primeiro Comando de Prática

Para ver o poder das cadeias de múltiplas etapas, primeiro faça upload de uma exportação de vendas recente para ativar o Assistente, depois execute:

Remova duplicatas em 'ID do Pedido'; preencha 'Custo Unitário' ausente com mediana; adicione 'Margem Bruta %'=(Receita-Custo)/Receita*100 formatada percentual 1 decimal; crie gráfico de barras média 'Margem Bruta %' por 'Região' ordenado decrescente; coloque gráfico em nova planilha 'Gráficos'.
Copy

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