O Padrão Diamante para Agentes 💎
O padrão diamante é uma forma prática de desenhar sistemas de agentes: o trabalho se divide, vários workers trabalham em paralelo, verificadores atacam o que foi produzido e tudo converge numa resposta única. Mais importante que o desenho é saber quando não usar um grafo.
O que é um grafo, em uma frase
Um grafo responde duas perguntas: quais jobs precisam acontecer e qual job precisa esperar qual. Um job é algo que você entregaria a um assistente, como pesquisar um concorrente, escrever um rascunho ou checar uma alegação. Só existe uma seta de verdade quando trabalho flui por ela.
“Resuma este arquivo e depois confira minha agenda” parece uma sequência, mas o passo da agenda não precisa do resumo. São dois jobs desconectados que um script linear encadeia à toa. Procurar essas setas falsas costuma revelar espera desperdiçada no sistema atual.
O diamante
O trabalho se divide, vários workers cavam em paralelo, algo confere o que acharam e tudo converge numa resposta única: fan out → reduce → synthesize. É a mesma forma por trás de scan de mercado, auditoria de dependência, code review e relatório de pesquisa; só mudam a fonte e o prompt.
A conferência é a etapa que não pode ser pulada. Modelos deixam passar muitos dos próprios erros. Em vez de deixar o mesmo agente corrigir a própria prova, dê a conferência a um job separado cujo único trabalho é tentar matar o achado antes que ele chegue até você. Cada checker deve fazer uma pergunta diferente: está correto? Está atual? A fonte é real?
A stop rule
Mais agentes não é automaticamente melhor. Um time vence um agente solo quando o trabalho se divide em pedaços independentes, mas perde quando cada passo precisa do anterior. Um grafo compra amplitude; não compra melhor julgamento.
A pergunta que decide a conta: onde meu trabalho se divide?
Se cada etapa precisa do quadro completo, fique com um agente só. Quando surgem jobs que nunca leem o resultado uns dos outros, o grafo começa a pagar.
O human gate
O humano é o node mais importante do próprio grafo. Todo sistema sério roteia para uma pessoa antes de qualquer coisa irreversível: enviar, publicar, reembolsar e faturar são setas que deveriam terminar em aprovação humana.
A regra é colocar a aprovação onde um erro seria caro de desfazer, não em cada passo. Gate em tudo transforma o humano em gargalo; gate em nada significa que ninguém está vigiando.
Quatro regras que evitam acidentes
- Todo loop tem um número máximo de rodadas.
- Só um job escreve em qualquer arquivo.
- O roteamento vive em passos escritos em código; a IA preenche os jobs.
- Sempre existe um teto para quantos agentes podem nascer.
Três builds prontos
Mesa de pesquisa profunda
Uma pergunta com dinheiro de verdade atrás se divide em cinco ângulos. Cinco pesquisadores trabalham ao mesmo tempo, um cético ataca cada achado e só sobreviventes com fonte e data chegam ao relatório final, ranqueados por confiança. O passe do cético é o produto de verdade: a diferença entre pesquisa e coleção de boato.
Máquina de conteúdo SEO
Três pesquisadores investigam em paralelo o que as melhores páginas cobrem, quais perguntas as pessoas fazem e o que todo mundo deixa passar. Depois vêm outline, rascunho e fact-checker, que sinaliza no topo cada alegação sem fonte. O conteúdo espera aprovação numa pasta de drafts; nunca publica sozinho.
Kit de go-to-market
Três pesquisadores perfilam comprador, canais e concorrência. O sistema produz um documento de posicionamento e pausa para leitura humana. Só depois da aprovação três redatores produzem copy de landing page, posts de lançamento e mensagens de outreach. Um checker compara cada peça ao posicionamento aprovado, e nada publica sem aprovação peça por peça.
O playbook resumido
- Remova primeiro as setas falsas; nada roda até o fluxo representar trabalho de verdade.
- Divida apenas o que nunca relê o próprio resultado. Se relê, mantenha um agente passo a passo.
- Nenhum achado viaja sem checagem, e dois checkers não fazem a mesma pergunta.
- Todo loop tem teto de rodadas.
- Há um escritor por arquivo; o plano vive em passos escritos.
- A última aprovação fica exatamente onde um erro seria caro de desfazer.
- Uma ferramenta basta até você conseguir nomear por que ela deixou de bastar.
Pular a aprovação final é a garantia de que o grafo vai entregar o primeiro erro confiante direto ao cliente.
Adaptado de 0xRafy, “Graph Engineering with Claude: The 11-Step Roadmap”, thread no X, 2026-07-21, e de exm7777, “How to Master Graph Engineering for AI Agents”, thread no X, 2026-07-23. Thread de 0xRafy · Thread de exm7777.