教程：5分钟内搭建您的首个 AI Agent Team

Source: Dev.to

前置条件

• Python 3.10+
• tmux（在 Ubuntu 上使用 sudo apt install tmux）
• 至少安装一个 AI CLI：
  • Claude Code：npm install -g @anthropic-ai/claude-code
  • Codex CLI：npm install -g @openai/codex
  • 或者：Gemini CLI、Qwen CLI

步骤 1：安装 Bridge ACE

git clone https://github.com/Luanace-lab/bridge-ide.git
cd bridge-ide
./install.sh

安装脚本会检查你的 Python 版本，若缺少 tmux 则自动安装，设置 Python 依赖，并创建运行时目录。

步骤 2：启动平台

./Backend/start_platform.sh

此命令会启动：

• 端口 9111 的 HTTP 服务器
• 端口 9112 的 WebSocket 服务器
• 用于健康监控的后台守护进程

步骤 3：打开 UI

在浏览器中访问 http://localhost:9111。你会看到 Bridge ACE 的登录页面以及 Buddy（入门助手）。

步骤 4：配置你的团队

访问 http://localhost:9111/project_config.html 来定义你的代理。

{
  "agents": [
    {
      "id": "coordinator",
      "role": "Project Coordinator",
      "engine": "claude",
      "scope": ["*"]
    },
    {
      "id": "backend",
      "role": "Backend Developer",
      "engine": "codex",
      "scope": ["src/api/", "src/models/"]
    },
    {
      "id": "frontend",
      "role": "Frontend Developer",
      "engine": "claude",
      "scope": ["src/ui/", "src/components/"]
    }
  ]
}

步骤 5：观察它们协同工作

打开 http://localhost:9111/chat.html，即可实时查看代理之间的通信。Coordinator 分配任务，Backend 与 Frontend 代理并行处理各自的范围。当 Backend 完成 API 接口后，Frontend 会通过 WebSocket 立即收到通知并开始构建 UI。

步骤 6：在控制中心监控

访问 http://localhost:9111/control_center.html 可查看：

• 实时代理状态（在线/忙碌/离线）
• 每个代理的费用统计
• 任务看板（Kanban）
• 带层级的组织结构图
• 范围锁可视化

背后发生了什么

• 每个代理在独立的 tmux 会话中运行，拥有完整的文件系统访问权限。
• 代理连接到 Bridge MCP 服务器，服务器为它们提供 204 种工具。
• 通信通过 WebSocket 总线实时传输。
• Soul Engine 在重启后保持代理的持久身份。
• 范围锁防止代理相互编辑对方的文件。
• 十六个后台守护进程监控健康状态、处理崩溃并管理速率限制。

后续步骤

• 添加使用不同引擎（Qwen、Gemini、Grok）的更多代理。
• 在 guardrails 配置中启用真实工具（邮件、Slack、浏览器）。
• 为不同项目创建专门的团队。
• 在手机上访问 http://:9111/mobile_buddy.html 试用移动 UI。

资源

• GitHub:
• Release:
• License: Apache 2.0
• FAQ: