Definindo o Problema e Especificação da Automação com IA

Definindo o Problema e Especificação da Automação com IA — aula do módulo Script de Automação em Python, na trilha Seus Primeiros Projetos Práticos com IA da…

Leitura de aproximadamente 5 minutos.

Módulo: Script de Automação em Python · Curso: Seus Primeiros Projetos Práticos com IA · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código

Definindo o Problema e Especificação da Automação com IA

O que você vai aprender

1. O Custo Oculto do Trabalho Repetitivo

Em qualquer profissão moderna — seja na advocacia, contabilidade, gestão financeira, vendas ou suporte técnico —, profissionais perdem centenas de horas anuais executando tarefas mecânicas em computadores:

Essas atividades são entediantes, propensas a erros por desatenção e consomem energia mental que deveria ser dedicada a decisões estratégicas.

A linguagem Python é a ferramenta mais popular do mundo para eliminar esse tipo de trabalho mecânico, e combinada com a Inteligência Artificial, qualquer pessoa consegue criar scripts de automação robustos em poucos minutos.


+-------------------------------------------------------------+
|               O FLUXO DE UMA AUTOMAÇÃO ROBUSTA (IPO)        |
+-------------------------------------------------------------+
|                                                             |
|  [ 1. ENTRADA (Input) ]                                     |
|    └─ Pasta Downloads com arquivos misturados (.pdf, .csv)  |
|                                                             |
|  [ 2. PROCESSAMENTO (Process) ]                             |
|    └─ Script Python identifica extensão, data e categoria   |
|                                                             |
|  [ 3. SAÍDA (Output) ]                                      |
|    └─ Arquivos organizados em pastas e relatório gerado     |
|                                                             |
+-------------------------------------------------------------+

2. A Estrutura de Especificação: Entrada, Processamento e Saída

Antes de pedir para a IA escrever qualquer linha de código em Python, você precisa definir o contrato de execução da sua automação. Isso significa responder com precisão a três perguntas:

1. **Qual é a Entrada (Input)? Onde estão os dados brutos? É uma pasta específica no computador? Uma lista de arquivos CSV? Arquivos baixados da internet? 2. Qual é o Processamento (Process)? Quais regras lógicas devem ser aplicadas? (Exemplo: "Se o arquivo terminar em .pdf e contiver a palavra 'Fatura', mova para a pasta Documentos/Faturas/"). 3. Qual é a Saída (Output)?** O que deve acontecer ao final da execução? Onde os arquivos devem ficar? Um relatório de confirmação deve ser exibido na tela ou salvo em um arquivo de texto?

Comparativo de Oportunidades de Automação

A tabela a seguir apresenta exemplos práticos de rotinas comuns e como são transformadas em scripts:

| Tarefa Manual | Abordagem em Python | Tempo Manual | Tempo com Script | |---|---|---|---| | Organizar pasta Downloads | Identificar extensão e mover para subpastas por tipo | 15 min / dia | 1 segundo | | Renomear notas fiscais | Ler o texto do PDF e renomear com DATA-NUMERO.pdf | 40 min / semana | 3 segundos | | Consolidar planilhas CSV | Ler múltiplos arquivos e juntar em uma tabela única | 1 hora / mês | 2 segundos | | Limpeza de arquivos velhos | Arquivar ou apagar itens temporários com mais de 30 dias | 30 min / mês | Automático diário |

3. Redigindo a Especificação com a IA

Para que o modelo de linguagem gere um código seguro e que não tome decisões perigosas por conta própria, estruture a especificação em um arquivo chamado especificacao.md.

O projeto que construiremos neste módulo será um Organizador e Validador Automático de Documentos Financeiros:

4. O Prompt de Especificação

Envie o seguinte prompt para a IA para validar a lógica da sua automação antes de escrever o código:


Atue como um engenheiro de software especialista em automação de rotinas com Python.
Quero planejar um script de automação para organizar arquivos e relatórios financeiros.

Aqui está o cenário:
1. Entrada: Uma pasta local chamada "dados_brutos/" contendo arquivos diversos (.csv, .pdf, .txt, .png).
2. Regras de Processamento:
   - Arquivos .csv devem ser movidos para a pasta "organizados/planilhas/".
   - Arquivos .pdf devem ser movidos para a pasta "organizados/documentos/".
   - Arquivos com outras extensões devem ser mantidos intactos ou movidos para "organizados/outros/".
   - Se já existir um arquivo com o mesmo nome na pasta de destino, não sobrescreva; adicione um sufixo numérico (ex: relatorio_1.csv).
3. Saída:
   - Pastas de destino criadas automaticamente caso não existam.
   - Um arquivo de log "execucao.log" registrando data, hora e cada ação executada.

Revise esta especificação, aponte potenciais riscos (como permissões de pasta ou arquivos em uso) e apresente o plano de implementação passo a passo. Não gere o código ainda; apenas o plano revisado.

5. Armadilhas Comuns e Como Evitar

[!WARNING]
Permitir que scripts sobrescrevam arquivos sem confirmação: O maior perigo ao rodar automações de manipulação de arquivos é sobrescrever por acidente um documento homônimo importante. Sempre instrua a IA a verificar se o arquivo de destino já existe antes de mover ou renomear, criando um novo nome ou emitindo um aviso em vez de substituir cegamente.

Exercício Prático

Vamos preparar o terreno para a nossa automação:

1. Crie a pasta do projeto: No seu terminal ou explorador, crie uma pasta chamada automacao-arquivos. 2. Crie a estrutura de teste: Dentro de automacao-arquivos, crie uma subpasta chamada dados_brutos. 3. Crie arquivos simulados: Crie dentro de dados_brutos três arquivos de texto vazios para testar: vendas_agosto.csv, recibo_01.pdf e anotacoes.txt. 4. Salve a especificação: Crie o arquivo especificacao.md na raiz do projeto com o roteiro validado pela IA. Estamos prontos para escrever o código na próxima aula!

Outras aulas do módulo