Agente Swarm: Estrutura de Orquestração Multiagente para Assistentes de Codificação com IA

Coordenação Multiagente para Tarefas de Desenvolvimento

O Agent Swarm fornece uma estrutura para executar equipes de agentes de IA de programação que trabalham juntos de forma autônoma. O sistema utiliza um agente líder que recebe tarefas de várias fontes, as divide em subtarefas e as delega para agentes trabalhadores executando em contêineres Docker isolados.

Arquitetura e Recursos Principais

• Coordenação Líder/Trabalhador – Um agente líder delega e acompanha o trabalho entre múltiplos trabalhadores
• Isolamento Docker – Cada trabalhador executa em seu próprio contêiner com um ambiente de desenvolvimento completo
• Pontos de integração – Integração com Slack, GitHub e e-mail para criação de tarefas
• Gerenciamento do ciclo de vida de tarefas – Filas de prioridade, dependências, pausar/retomar entre implantações
• Memória composta – Os agentes aprendem com cada sessão e melhoram ao longo do tempo
• Identidade persistente – Cada agente mantém sua própria personalidade, expertise e estilo de trabalho
• Interface de usuário do painel – Monitoramento em tempo real de agentes, tarefas e chat entre agentes
• Descoberta de serviços – Trabalhadores podem expor serviços HTTP e descobrir uns aos outros
• Tarefas agendadas – Automação de tarefas recorrentes baseada em Cron

Opções de Início Rápido

A estrutura suporta múltiplas abordagens de implantação:

Opção A: Docker Compose (recomendado)

git clone https://github.com/desplega-ai/agent-swarm.git
cd agent-swarm
# Configurar ambiente
cp .env.docker.example .env
# Editar .env — definir API_KEY e CLAUDE_CODE_OAUTH_TOKEN no mínimo
# Iniciar tudo
docker compose -f docker-compose.example.yml --env-file .env up -d

A API é executada na porta 3013.

Opção B: API Local + Trabalhadores Docker

git clone https://github.com/desplega-ai/agent-swarm.git
cd agent-swarm
bun install
# 1. Configurar e iniciar o servidor da API
cp .env.example .env
# Editar .env — definir API_KEY
bun run start:http

Em um novo terminal, iniciar um trabalhador:

# 2. Configurar e executar um trabalhador Docker
cp .env.docker.example .env.docker
# Editar .env.docker — definir API_KEY (mesmo que acima) e CLAUDE_CODE_OAUTH_TOKEN
bun run docker:build:worker
mkdir -p ./logs ./work/shared ./work/worker-1
bun run docker:run:worker

Opção C: Claude Code como Agente Líder

# Após iniciar o servidor da API (Opção B, etapa 1):
bunx @desplega.ai/agent-swarm setup

Isso configura o Claude Code para conectar-se ao enxame. Inicie o Claude Code e diga: "Registre-se como o agente líder no agent-swarm."

Como Funciona

O sistema segue este fluxo: Você envia uma tarefa via DM do Slack, @mention do GitHub, e-mail ou diretamente pela API. O agente líder planeja dividindo a tarefa e atribuindo subtarefas aos trabalhadores. Os trabalhadores executam em contêineres Docker isolados com git, Node.js, Python e outras ferramentas de desenvolvimento. O progresso é acompanhado em tempo real através do painel.

Este tipo de sistema multiagente é útil para desenvolvedores que desejam automatizar fluxos de trabalho de desenvolvimento complexos onde as tarefas precisam ser divididas e executadas em paralelo, com cada agente especializando-se em diferentes aspectos do trabalho.