agent-swarm: MCP de sistema operativo para swarms multiagente; mira primero el coste completo del despliegue antes de empezar

Para quién es adecuado

• Para equipos o personas que quieran orquestar varios agentes dentro de un sistema unificado: mediante herramientas de ciclo de vida de tareas (send-task, cancel-task, task-action, poll-task, store-progress), mensajes de steering, session/session logs y gestión de presupuestos (getBudget/getBudgets/upsertBudget/deleteBudget) se puede dirigir y supervisar un conjunto de agentes; la versión más reciente es la v2.7.7.
• Su cobertura de contratos e2e abarca «cada route, herramienta MCP y tipo de nodo de workflow», y en cada dominio se documentan más de 32 herramientas MCP, lo que lo hace adecuado para usuarios que tratan la colaboración multiagente como infraestructura a largo plazo.
• No es adecuado para quienes buscan cero despliegue y uso con un solo archivo: la ruta principal de instalación es el despliegue preset full con túnel, y la pila de Compose incluye lead, workers, agent-fs, MinIO y Caddy; al usar el perfil tls, además se despliega en un subdominio real de agent-swarm.dev.
• Los requisitos de credenciales, los métodos de autenticación y los umbrales por defecto del budget gate no se detallan en la evidencia recopilada; antes de usarlo, hay que confirmarlos en el README o la documentación oficial.

Primer intento en 3 minutos

• La ruta oficial principal es la instalación completa descrita en el README y la documentación: ui-install.sh --preset full --tunnel.
• Requisitos previos: un host que permita levantar varios contenedores de servicios y con el runtime Bun instalado (agent-swarm se basa en Bun y su capa de datos es bun:sqlite); las puertas de calidad usan bun run lint y tsc:check, lo que indica que el código fuente puede validarse con flujos de trabajo de Bun.
• Aviso sobre efectos secundarios: se trata de un despliegue real, no de una prueba de solo lectura. Escribe estado local (SQLite), levanta servicios como MinIO/Caddy y, con el perfil tls, ocupa un subdominio real. Antes de ejecutarlo, confirma que estos efectos son aceptables; la evidencia no incluye comandos oficiales de rollback/deshacer, así que no des por hecho que se pueda revertir con un solo clic.
• Señal de éxito: al terminar el script de instalación, lead, workers, agent-fs, MinIO y Caddy de la pila de Compose están en ejecución, y se puede recorrer el estado del sistema mediante el dashboard UI (la demostración oficial usa agent-browser).
• Si solo quieres conocer la superficie de herramientas sin desplegar, la evidencia no ofrece una ruta oficial más ligera; no inventes métodos de instalación alternativos.

Casos de uso

• Caso 1: enviar y seguir una tarea. Tras el despliegue, llama a send-task vía MCP para enviar una tarea al swarm, luego usa poll-task para consultar el progreso y store-progress para registrarlo (admite el estado terminal 'skipped'); si es necesario, usa cancel-task para abortar. Resultado esperable: el ciclo de vida de la tarea, desde su creación hasta su estado terminal, queda consultable en los session logs.
• Caso 2: fijar un presupuesto diario para evitar descontrol. Llama a getBudget/getBudgets para ver el presupuesto actual y usa upsertBudget para fijar un límite de gasto diario; la evidencia oficial indica que, cuando el gasto alcanza el gate diario, el sistema rechaza aceptar tareas posteriores: es la forma directa de observar el mecanismo de presupuesto en acción. Para eliminarlo se usa deleteBudget.

Límites de uso

• Naturaleza de lectura/escritura: hay consultas de solo lectura (getBudgets, poll-task, session logs) y también operaciones de escritura y de cancelación (send-task, upsertBudget, cancel-task); antes de cualquier operación de escritura tras el primer intento, confirma primero el estado objetivo en el dashboard.
• Datos locales: la capa de datos es bun:sqlite y escribe estado de base de datos local en el host; se trata de una escritura local, que no se convierte en solo lectura por el hecho de que existan herramientas de consulta.
• Efectos secundarios del despliegue: levanta de una vez una pila de varios servicios y puede ocupar un dominio real; la evidencia no ofrece una ruta de rollback.
• Aún sin confirmar: el valor por defecto del budget gate diario, los requisitos de credenciales y autenticación, y las firmas completas de parámetros de cada herramienta MCP (solo se confirmaron los nombres de las herramientas y la cifra de más de 32); antes de usarlo, atente al README o la documentación oficial.