//02 Agentes e orquestração · Série: The Token Economy
Construir sistemas multiagente que não colapsam
Padrões e anti-padrões aprendidos ao lançar loops agente coordenador–trabalhador em produção.
Porque falham tantos sistemas multiagente
Pelo mesmo motivo que falham muitos sistemas distribuídos: fan-out sem limites, contratos pouco claros entre atores e um coordenador que discretamente se torna um ponto único de falha.
Um contrato de trabalho
Cada agente no sistema precisa de três coisas escritas:
- Um objetivo que lhe pertence, expresso numa única frase.
- Uma interface, as ferramentas que pode chamar e o schema do que devolve.
- Um orçamento, tokens, tempo e profundidade de recursão.
Sem estas três coisas, não tens agentes. Tens ciclos while muito caros.
O padrão coordenador
Um coordenador leve, que apenas encaminha e nunca faz o trabalho principal, tende a sobreviver a todos os orquestradores “inteligentes” que já testámos.
async function coordinate(task: Task) {
const plan = await planner.run(task);
for (const step of plan.steps) {
await dispatch(step); // os trabalhadores fazem o trabalho
}
}
Coisas que reaprendemos vezes sem conta
- Determinismo nas margens, ambiguidade no meio.
- Os logs são o produto. Se não consegues reproduzir uma sessão, não consegues depurá-la.
- Humanos devem ser uma ferramenta que o agente pode chamar, não um fallback escondido atrás de um alerta.
Fecho
Sistemas multiagente não justificam a sua existência por serem espertos. Justificam-na por serem legíveis.