Como o Clawdbot Coordena 6 Agentes de IA com uma Fila de Trabalho Estável para Produção

A equipe da Clawdbot compartilhou sua arquitetura de fila de trabalho que coordena 6 agentes de IA operando uma loja gerenciada por IA. Eles descobriram que o problema de coordenação era mais difícil do que a lógica individual dos agentes, com o sistema passando por várias iterações antes de alcançar estabilidade em produção.

Funcionalidades Principais do Sistema

A fila de trabalho implementa vários mecanismos essenciais:

• Reivindicação atômica de tarefas: Impede que dois agentes peguem a mesma tarefa
• Máquina de estados: As tarefas passam por estados: pendente → pronta → em_andamento → revisão → concluída
• Lógica de repetição: 3 falhas com backoff, depois falha permanente para evitar loops de repetição descontrolados
• Cadeias de tarefas: A conclusão da tarefa pai gera automaticamente tarefas filhas através de um campo next_tasks
• Rastreamento de heartbeat: Reivindicações obsoletas (de falhas de agentes) são redefinidas automaticamente após timeout
• Orquestrador daemon: Verifica a cada 60 segundos e inicia agentes para tarefas prontas

Lições de Produção

A equipe observa que o tratamento de modos de falha não era óbvio até que tivessem incidentes reais em produção para aprender com eles. Eles publicaram uma descrição completa da arquitetura com lições aprendidas ao executar isso em produção.

O sistema coordena múltiplos agentes trabalhando simultaneamente: agentes de design, código, marketing e operações. A equipe está aberta a discutir tradeoffs, particularmente em torno do tratamento de modos de falha que surgiu da experiência em produção.