🧱 WAT na pratica
Este modulo organiza a arquitetura minima de um sistema agentic separando workflow, agent e tools. O objetivo e evitar solucao monolitica dificil de explicar, medir e operar.
🗺️ Workflow como espinha dorsal
Workflow e a camada que define ordem, checkpoints e transicoes. Ele tira a logica estrutural de dentro do improviso do agente.
Conceito principal
Workflow bom deixa claro o que entra em cada fase, o que sai e em que condicao a execucao avanca.
Dica pratica
Se voce nao consegue desenhar as fases numa folha, provavelmente ainda nao tem um workflow claro.
🧠 Agent como camada de decisao
O agente entra para interpretar contexto e escolher a proxima melhor acao dentro dos limites do sistema.
Quando usar
Classificacao contextual, escolha de fonte, planejamento local e priorizacao com ambiguidade controlada.
Quando evitar
Persistencia, chamada fixa, envio automatico sem aprovacao e validacao de esquema.
🛠️ Tools como alavancas concretas
Tools sao os pontos de acao do sistema. Quanto mais claras, menores e auditaveis, melhor a previsibilidade do agente.
Criterio tecnico
Uma tool boa faz uma coisa so, tem schema claro e retorna um resultado padronizado.
Erro comum
Criar uma tool gigante que mistura busca, transformacao, gravacao e notificacao no mesmo ponto.
🔀 Handoffs e composicao
Sistemas maduros crescem por composicao. Handoffs evitam acoplamento excessivo e ajudam a dividir responsabilidade.
Conceito principal
Cada handoff precisa deixar claro o que esta sendo passado, com que formato e qual etapa assume a partir dali.
Alerta
Handoff vago vira buraco preto: a responsabilidade muda, mas ninguem sabe o que foi transferido.
👀 Observabilidade inicial
Sem visibilidade, o sistema parece magico quando funciona e misterioso quando falha. Observabilidade troca magia por engenharia.
Registrar
Fase atual, decisao tomada, tool usada, input relevante e output gerado.
Evitar
Logs vagos como “deu erro” ou “workflow finalizado” sem contexto operacional.
🏗️ Laboratorio de mapa WAT
O aluno fecha o modulo desenhando a arquitetura minima de um caso real, separando workflow, agent e tools com responsabilidade clara.
Exercicio
Escolher um processo e desenhar as fases, os pontos de decisao agentica e as tools necessarias.
Entregavel
Mapa WAT de uma pagina com fluxo, handoffs e pontos de observabilidade.
✅ Resumo final
✓ Separou estrutura, decisao e acao.
✓ Entendeu por que workflow nao deve ficar escondido dentro do agente.
✓ Viu como handoffs e tools pequenas ajudam a escalar a arquitetura.
✓ Entendeu o valor da observabilidade desde cedo.
✓ Fechou o modulo com um mapa WAT aplicavel.