🍳 A cozinha: receita, cozinheiro, ingredientes
Novo aqui? WAT é a sigla que dá nome a este curso: Workflow + Agent + Tools. Três peças que, juntas, transformam um pedido em português numa tarefa executada de verdade. Para fixar o modelo mental, pense numa cozinha profissional.
Uma cozinha boa tem três coisas separadas: a receita (o passo a passo escrito), o cozinheiro (quem lê a receita, decide os ajustes e corrige o tempero) e os ingredientes e eletrodomésticos (o que existe fisicamente para virar prato). Tire qualquer uma das três e a cozinha para de funcionar — ou vira outra coisa.
💡 Conceito Principal
WAT = Workflow (receita) + Agent (cozinheiro) + Tools (ingredientes/eletrodomésticos). As três peças têm papéis diferentes e não se substituem.
- •A receita não cozinha sozinha — precisa de alguém que a leia e execute.
- •O cozinheiro sem ingredientes só sabe explicar o prato, não fazer.
- •Ingredientes sem receita nem cozinheiro é só uma despensa parada.
A analogia funciona pra qualquer tarefa repetitiva, não só cozinha. Pegue um exemplo bem diferente de newsletter: organizar os recibos do mês pra prestação de contas. A receita (workflow) diz "pegue os recibos da pasta 'financeiro', separe por categoria, some cada uma, gere uma planilha resumo". O cozinheiro (agent) decide em qual categoria um recibo ambíguo entra ("transporte" ou "alimentação"?) e percebe se um arquivo veio corrompido. Os ingredientes (tools) são o leitor de PDF/imagem que extrai o valor e a ferramenta de planilha que grava o resumo. Nenhuma das três peças, sozinha, organiza recibo nenhum.
🔍 Ver por dentro: o que acontece quando o cozinheiro lê a receita
- O que é lido: o texto do workflow (e, se existir, o CLAUDE.md do projeto) entra no que o agente "sabe" naquela execução — consome parte da cota de tokens.
- O que é decidido: a cada passo, qual ferramenta chamar e com quais dados — essa escolha não é gravada por padrão, é feita de novo a cada execução.
- Onde fica gravado: só o resultado final (arquivo, planilha, e-mail enviado). O "raciocínio" do meio normalmente não é salvo, a menos que você peça um log.
- Quanto custa: cada passo e cada ferramenta chamada consome tokens — workflow claro e curto custa menos do que agente "adivinhando" do zero.
📋 W de Workflow: a receita em markdown
Novo aqui? Workflow aqui é simplesmente a receita escrita: uma sequência de passos em texto simples (frequentemente em markdown — um jeito de formatar texto com títulos e listas, sem código complicado) dizendo o que fazer, em que ordem, e o que checar em cada etapa.
Um bom workflow não precisa prever cada exceção — só precisa ser claro o bastante pra que quem o leia (o agente) saiba o que fazer no caminho normal e reconheça quando algo saiu do previsto. É diferente de um programa de computador tradicional: não são instruções rígidas linha a linha, são orientações que alguém capaz de interpretar (o agente) vai seguir com juízo.
Exemplo de workflow curto, em markdown:
## Workflow: relatório semanal
1. Ler os números de vendas da planilha "vendas.csv"
2. Somar por categoria
3. Escrever um resumo de 3 parágrafos
4. Salvar como "relatorio-semana.md"
5. Se algum número parecer errado (negativo, vazio), avisar antes de salvar🔍 Por dentro
- Markdown: formatação simples de texto (títulos com
#, listas com números) — o mesmo tipo de arquivo do CLAUDE.md que você viu na Trilha 0. - Passo a passo, não código: o workflow é lido em português, não é uma linguagem de programação.
Outro exemplo curto, fora do universo de e-mail: um workflow para agendar posts em redes sociais poderia dizer "leia os textos da pasta 'posts-da-semana', gere uma imagem de capa pra cada um, publique um por dia às 9h, e avise se algum texto passar de 280 caracteres". A receita não explica como gerar a imagem ou como publicar — isso é trabalho das tools. Ela só diz a ordem, a exceção e quando parar.
💡 Erro comum: receita vaga
Um workflow do tipo "cuide do meu financeiro" não é receita, é um desejo. O agente vai preencher os buracos com suposições próprias — que podem não bater com o que você tinha em mente. Prefira "leia os recibos da pasta X, separe em Y categorias, ignore valores abaixo de R$5" a uma frase genérica: quanto mais concreta a receita, menos o cozinheiro precisa adivinhar.
👨🍳 A de Agent: quem lê, decide e corrige
O agent (agente) é o Claude Code — o cozinheiro da nossa analogia. Ele lê o workflow, interpreta cada passo, decide qual ferramenta usar para executá-lo, olha o resultado e ajusta o curso se algo não bateu com o esperado. É a peça que dá julgamento ao processo: sem ela, a receita fica parada no papel.
Isso é diferente de um script tradicional (um programa fixo que só repete os mesmos passos sem entender o que está fazendo). O agente entende a intenção do passo "somar por categoria" mesmo que a planilha venha com uma coluna a mais ou um nome diferente do esperado — ele se adapta dentro do razoável.
✓ O que o agente faz bem
- ✓Interpreta passos escritos em linguagem natural
- ✓Escolhe qual ferramenta usar para cada passo
- ✓Percebe quando um resultado parece errado e tenta de novo
✗ O que o agente NÃO faz sozinho
- ✗Adivinhar uma receita que nunca foi escrita
- ✗Usar uma ferramenta que não existe ou não tem permissão
- ✗Ler sua mente sobre o que "bom" significa sem você dizer
Erro comum: o agente "inventa" um caminho. Imagine um workflow de atendimento a clientes que diz "responda dúvidas sobre pedido usando os dados do sistema" mas nunca diz onde está o sistema nem o que fazer se o pedido não for encontrado. Sem essa informação, o agente pode improvisar — responder com um palpite — porque foi instruído a resolver o problema, e "não sei" raramente é a primeira saída que ele tenta. Não é o agente "mentindo": é preenchendo uma lacuna que a receita deixou aberta. A correção é sempre no workflow — diga "se não encontrar o pedido, pare e pergunte".
🥕 T de Tools: quem faz o trabalho de verdade
Tools (ferramentas) são os ingredientes e eletrodomésticos: as coisas que de fato fazem o trabalho quando o cozinheiro as aciona — abrir um arquivo, rodar um comando, mandar um e-mail, buscar algo na internet, chamar uma API (uma porta de comunicação que um site ou serviço deixa aberta para programas conversarem entre si, sem precisar de tela). Sem elas, o agente só teria opinião, não capacidade de agir.
Uma ferramenta sem workflow é praticamente inútil: ter um forno ligado não faz o bolo assar sozinho — alguém (o agente, seguindo a receita) precisa colocar a massa lá dentro na hora certa, na temperatura certa. É por isso que as Trilhas 2 (MCP) e 4 (Deploy) deste curso são inteiramente sobre dar e conectar ferramentas — mas elas só ganham sentido junto com um workflow que diga quando usá-las.
Erro comum: falta a chave da ferramenta. Muita tool exige uma chave de API (senha longa que identifica você perante o serviço — Gmail, Google Calendar, um banco de dados) configurada antes de funcionar. Sem ela a ferramenta fica travada: o agente tenta usá-la, recebe erro de acesso negado e para ali. Vale checar antes de qualquer automação nova: a chave existe, está no lugar certo, ainda é válida? "Ferramenta instalada" e "ferramenta autorizada a agir" são coisas diferentes — as Trilhas 2 e 4 mostram como guardar chaves com segurança.
Legenda: mesma tentativa do agente, dois destinos diferentes — a ferramenta com chave configurada completa o trabalho, a que não tem chave bloqueia a execução até alguém corrigir a configuração.
🔗 Por que separar as três peças
Separar workflow, agente e tools não é capricho técnico — é o que torna o sistema previsível o suficiente para confiar e flexível o suficiente para ser útil. O workflow guarda a intenção (o que fazer), o agente guarda o julgamento (como interpretar e ajustar), e as tools guardam a capacidade (o que é fisicamente possível fazer no computador ou na internet).
Legenda: a receita entra pela esquerda, o agente interpreta e aciona as ferramentas à direita, e o resultado volta em ciclo para o agente decidir o próximo passo — é esse laço que o módulo 1.2 detalha.
Pra ver as três peças em ação do início ao fim, siga um pedido real de triagem de e-mails de clientes — um cenário bem diferente da newsletter que aparece mais à frente na trilha:
-
1. A receita existe
O workflow diz: "leia os e-mails novos, classifique em dúvida/reclamação/elogio, responda dúvidas simples, encaminhe reclamações para um humano".
-
2. O agente lê e classifica
Abre a caixa de entrada (via tool), lê cada e-mail e decide a categoria — esse julgamento é dele, o workflow só deu as categorias possíveis.
-
3. As tools agem
Pra dúvida simples, a tool de e-mail envia a resposta padrão. Pra reclamação, outra tool encaminha pro humano e marca "prioridade".
-
4. O resultado é observado
O agente confere se o envio foi confirmado antes de seguir pro próximo — se falhar, tenta de novo ou registra o erro.
-
5. Fim do ciclo
Sem mais e-mail novo, o agente para e reporta um resumo: quantos respondidos, quantos encaminhados.
⚖️ Agente sem workflow, tool sem workflow
Duas combinações quebradas explicam por que as três peças precisam estar juntas. Um agente sem workflow ainda funciona, mas fica caro e errático: a cada pedido ele reinventa o processo do zero, sem aprender com a última vez, e pode tomar caminhos diferentes em execuções parecidas. Uma tool sem workflow é praticamente inútil sozinha: uma ferramenta de envio de e-mail não decide, por conta própria, quando e para quem mandar algo.
✗ Agente sem receita
- ✗Reinventa o processo a cada pedido — caro em tokens (a "moeda" de custo do agente, vista na Trilha 0)
- ✗Resultado varia de execução para execução
✗ Tool sem receita nem cozinheiro
- ✗Fica parada — API de e-mail não decide sozinha quando disparar
- ✗Sem contexto de "por que" usá-la agora
Exemplo de agente sem workflow: pedir "organiza minha agenda" sem detalhe. Numa execução ele prioriza reuniões de trabalho, na outra prioriza compromissos pessoais — não há receita fixando o critério. Já uma tool sem workflow seria uma ferramenta de agendamento de posts perfeitamente configurada, com chave válida, mas sem instrução de quando publicar o quê — disponível, porém ociosa. As duas situações reforçam a mesma lição: workflow é o que transforma capacidade solta em resultado confiável.
💡 Dica Prática
Antes de pedir qualquer automação, escreva pelo menos 3-4 linhas de workflow — mesmo informal. É o investimento que mais economiza tempo e tokens no resto da trilha.
Checagem rápida (opcional): o que acontece quando falta o workflow?