安装

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

适合谁

适合想在统一系统内编排多个 agent 的团队或个人:通过任务生命周期工具(send-task、cancel-task、task-action、poll-task、store-progress)、steering 消息、session/session logs,以及预算管理(getBudget/getBudgets/upsertBudget/deleteBudget)指挥和监控一组 agent,最新版本为 v2.7.7。
它的 e2e 契约覆盖“每个 route、MCP 工具和工作流节点类型”,各领域记录了 32+ 个 MCP 工具,适合把多 agent 协作当长期基础设施的用户。
不适合想要零部署、单文件即用的用户:主安装路径是带 tunnel 的 preset full 部署,Compose 栈包含 lead、workers、agent-fs、MinIO 和 Caddy;使用 tls profile 时还会部署到真实 agent-swarm.dev 子域名。
凭证要求、认证方式以及预算 gate 的默认阈值在已收集证据中未说明,使用前需到官方 README/文档确认。

官方主路径是 README 与文档中的完整安装:ui-install.sh --preset full --tunnel。
前提:一台允许拉起多服务容器的主机,并安装了 Bun 运行时(agent-swarm 基于 Bun,数据层为 bun:sqlite);质量门使用 bun run lint 和 tsc:check,说明源码可用 Bun 工作流验证。
副作用提醒:这是一次真实部署,不是只读尝试。会写入本地状态(SQLite)、拉起 MinIO/Caddy 等服务,带 tls profile 时占用真实子域名。执行前确认这些副作用可接受;证据中未提供官方回滚/撤销命令,不要默认可一键还原。
成功信号:安装脚本完成后,Compose 栈中的 lead、workers、agent-fs、MinIO、Caddy 处于运行状态,可通过 dashboard UI 走查(官方演示使用 agent-browser)观察系统状态。
如果只想先了解工具面而不部署,证据中没有提供更轻的官方路径,不要猜测替代安装方式。

案例 1:下发并跟踪一个任务。部署完成后,通过 MCP 调用 send-task 向 swarm 发送任务,随后用 poll-task 轮询进度,用 store-progress 记录进度(支持 terminal 'skipped' 状态);必要时用 cancel-task 中止。可期待的结果:任务从创建到终态的生命周期在 session logs 中可查。
案例 2:设置每日预算防止失控。调用 getBudget/getBudgets 查看当前预算,用 upsertBudget 设置每日花费上限;官方证据说明当花费触达每日 gate 时,系统会拒绝接受后续任务——这是观察预算机制生效的直接方式。删除则使用 deleteBudget。

读写性质:既有只读查询(getBudgets、poll-task、session logs),也有写操作和取消操作(send-task、upsertBudget、cancel-task);首次尝试后的任何写操作前,先在 dashboard 中确认目标状态。
本地数据:数据层为 bun:sqlite,会在主机上写入本地数据库状态;这属于本地写入,不因查询工具存在而变成只读。
部署副作用:一次性拉起多服务栈并可能占用真实域名,证据未给出回滚路径。
尚未确认:每日预算 gate 的默认值、凭证与认证要求、每个 MCP 工具的完整参数签名(仅确认了工具名与 32+ 数量),使用前以官方 README/文档为准。