MCP

agent-swarm: MCP de sistema operacional para swarms multiagente — entenda o custo completo de implantação antes de começar

O agent-swarm é mais adequado como sistema de orquestração unificado para equipes que executam swarms multiagente, mas seu caminho principal de instalação oficial usa por padrão preset full + tunnel, o que implanta de uma vez a stack Compose completa e grava estado local, não sendo adequado para cenários de experimentação sem efeitos colaterais.

Official source · desplega-ai/agent-swarm

Install

ui-install.sh --preset full --tunnel

Para quem é adequado

  • Adequado para equipes ou indivíduos que queiram orquestrar múltiplos agentes dentro de um sistema unificado: comandar e monitorar um conjunto de agentes por meio de ferramentas de ciclo de vida de tarefas (send-task, cancel-task, task-action, poll-task, store-progress), mensagens de steering, session/session logs e gestão de orçamento (getBudget/getBudgets/upsertBudget/deleteBudget). A versão mais recente é a v2.7.7.
  • Seus contratos e2e cobrem "cada rota, ferramenta MCP e tipo de nó de workflow", e os domínios documentam 32+ ferramentas MCP, sendo adequado para usuários que tratam a colaboração multiagente como infraestrutura de longo prazo.
  • Não é adequado para quem quer implantação zero e uso imediato com um único arquivo: o caminho principal de instalação é uma implantação preset full com tunnel, e a stack Compose inclui lead, workers, agent-fs, MinIO e Caddy; ao usar o perfil tls, a implantação ainda ocupa subdomínios reais do agent-swarm.dev.
  • Os requisitos de credenciais, os métodos de autenticação e os limites padrão do budget gate não estão especificados nas evidências coletadas; antes de usar, é preciso confirmar no README/documentação oficial.

Primeira tentativa em 3 minutos

  • O caminho principal oficial é a instalação completa descrita no README e na documentação: ui-install.sh --preset full --tunnel.
  • Pré-requisitos: uma máquina que permita subir múltiplos contêineres de serviços e com o runtime Bun instalado (o agent-swarm é baseado em Bun, com camada de dados em bun:sqlite); os quality gates usam bun run lint e tsc:check, o que indica que o código-fonte pode ser verificado com fluxos de trabalho do Bun.
  • Aviso sobre efeitos colaterais: esta é uma implantação real, não uma tentativa somente leitura. Ela grava estado local (SQLite), sobe serviços como MinIO/Caddy e, com o perfil tls, ocupa um subdomínio real. Antes de executar, confirme que esses efeitos colaterais são aceitáveis; as evidências não fornecem comandos oficiais de rollback/desfazer, portanto não presuma que é possível reverter com um clique.
  • Sinal de sucesso: após a conclusão do script de instalação, lead, workers, agent-fs, MinIO e Caddy da stack Compose estão em execução, e é possível inspecionar o estado do sistema pelo dashboard UI (a demonstração oficial usa o agent-browser).
  • Se você quiser apenas conhecer a superfície de ferramentas sem implantar, as evidências não oferecem um caminho oficial mais leve; não tente adivinhar métodos alternativos de instalação.

Casos de uso

  • Caso 1: enviar e acompanhar uma tarefa. Após a implantação, chame send-task via MCP para enviar uma tarefa ao swarm, depois use poll-task para consultar o progresso e store-progress para registrá-lo (suporta o estado terminal 'skipped'); se necessário, use cancel-task para abortar. Resultado esperado: o ciclo de vida da tarefa, da criação ao estado final, pode ser consultado nos session logs.
  • Caso 2: definir um orçamento diário para evitar perda de controle. Chame getBudget/getBudgets para ver o orçamento atual e use upsertBudget para definir um limite diário de gastos; a evidência oficial indica que, quando os gastos atingem o gate diário, o sistema passa a recusar novas tarefas — esta é a forma direta de observar o mecanismo de orçamento em ação. Para excluir, use deleteBudget.

Limites de uso

  • Natureza de leitura e escrita: há tanto consultas somente leitura (getBudgets, poll-task, session logs) quanto operações de escrita e cancelamento (send-task, upsertBudget, cancel-task); antes de qualquer operação de escrita após a primeira tentativa, confirme o estado alvo no dashboard.
  • Dados locais: a camada de dados é bun:sqlite e grava estado de banco de dados local na máquina; trata-se de escrita local, que não se torna somente leitura por existirem ferramentas de consulta.
  • Efeitos colaterais da implantação: sobe de uma vez uma stack de múltiplos serviços e pode ocupar um domínio real; as evidências não apresentam caminho de rollback.
  • Ainda não confirmado: o valor padrão do budget gate diário, os requisitos de credenciais e autenticação e as assinaturas completas de parâmetros de cada ferramenta MCP (apenas os nomes das ferramentas e a quantidade de 32+ foram confirmados); antes de usar, prevalecem o README e a documentação oficiais.