Agente Enjambre: Marco de Orquestación Multiagente para Asistentes de Codificación con IA

Coordinación Multiagente para Tareas de Desarrollo

Agent Swarm proporciona un framework para ejecutar equipos de agentes de IA de codificación que trabajan juntos de forma autónoma. El sistema utiliza un agente principal que recibe tareas de diversas fuentes, las desglosa en subtareas y las delega a agentes trabajadores que se ejecutan en contenedores Docker aislados.

Arquitectura y Características Clave

• Coordinación Líder/Trabajador – Un agente líder delega y supervisa el trabajo entre múltiples trabajadores
• Aislamiento Docker – Cada trabajador se ejecuta en su propio contenedor con un entorno de desarrollo completo
• Puntos de integración – Integración con Slack, GitHub y correo electrónico para crear tareas
• Gestión del ciclo de vida de tareas – Colas de prioridad, dependencias, pausa/reanudación entre despliegues
• Memoria compuesta – Los agentes aprenden de cada sesión y mejoran con el tiempo
• Identidad persistente – Cada agente mantiene su propia personalidad, experiencia y estilo de trabajo
• Interfaz de usuario del panel – Monitoreo en tiempo real de agentes, tareas y chat entre agentes
• Descubrimiento de servicios – Los trabajadores pueden exponer servicios HTTP y descubrirse entre sí
• Tareas programadas – Automatización de tareas recurrentes basada en Cron

Opciones de Inicio Rápido

El framework admite múltiples enfoques de despliegue:

Opción A: Docker Compose (recomendado)

git clone https://github.com/desplega-ai/agent-swarm.git
cd agent-swarm
# Configurar entorno
cp .env.docker.example .env
# Editar .env — establecer API_KEY y CLAUDE_CODE_OAUTH_TOKEN como mínimo
# Iniciar todo
docker compose -f docker-compose.example.yml --env-file .env up -d

La API se ejecuta en el puerto 3013.

Opción B: API Local + Trabajadores Docker

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

En una nueva terminal, iniciar un trabajador:

# 2. Configurar y ejecutar un trabajador Docker
cp .env.docker.example .env.docker
# Editar .env.docker — establecer API_KEY (la misma que arriba) y CLAUDE_CODE_OAUTH_TOKEN
bun run docker:build:worker
mkdir -p ./logs ./work/shared ./work/worker-1
bun run docker:run:worker

Opción C: Claude Code como Agente Principal

# Después de iniciar el servidor API (Opción B, paso 1):
bunx @desplega.ai/agent-swarm setup

Esto configura Claude Code para conectarse al enjambre. Inicia Claude Code y dile: "Regístrate como el agente principal en el agent-swarm."

Cómo Funciona

El sistema sigue este flujo: Envías una tarea a través de un mensaje directo de Slack, una mención @ en GitHub, correo electrónico o directamente a través de la API. El agente principal planifica desglosando la tarea y asignando subtareas a los trabajadores. Los trabajadores ejecutan en contenedores Docker aislados con git, Node.js, Python y otras herramientas de desarrollo. El progreso se rastrea en tiempo real a través del panel.

Este tipo de sistema multiagente es útil para desarrolladores que desean automatizar flujos de trabajo de desarrollo complejos donde las tareas necesitan desglosarse y ejecutarse en paralelo, con cada agente especializándose en diferentes aspectos del trabajo.