广播群组（Broadcast Groups）

实验性功能（2026.1.9 起）。允许多个 agent 同时处理同一条消息，适用于专业化 agent 团队协作。当前仅支持 WhatsApp。

配置

{
  broadcast: {
    strategy: "parallel",  // parallel（默认）| sequential
    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"],
    "+15555550123": ["support", "logger"],
  },
}

• 群聊：使用群组 JID（如 120363403215116621@g.us）
• 私信：使用 E.164 号码（如 +15551234567）

处理策略

• parallel（默认）：所有 agent 同时处理
• sequential：按数组顺序依次处理

会话隔离

每个 agent 维护完全独立的：

• 会话键（agent:alfred:whatsapp:group:... vs agent:baerbel:whatsapp:group:...）
• 对话历史
• 工作区
• 工具访问权限
• 内存/上下文

群组上下文缓冲区（近期群组消息）在所有广播 agent 间共享。

使用场景

专业化团队：

{
  broadcast: {
    "DEV_GROUP": ["code-reviewer", "security-auditor", "docs-generator"]
  }
}

多语言支持：

{
  broadcast: {
    strategy: "sequential",
    "+15555550123": ["detect-language", "translator-en", "translator-de"]
  }
}

与路由的关系

• broadcast 优先级高于 bindings
• 广播在频道白名单和群组激活规则之后评估（mention 门控仍生效）
• 一个 agent 失败不影响其他 agent

最佳实践

• 每个 agent 保持单一职责
• 建议每组不超过 5-10 个 agent
• 为不同 agent 配置不同工具权限
• 并行模式下响应顺序不确定

平台支持

• WhatsApp：已实现
• Telegram、Discord、Slack：计划中

相关链接

• channel-routing — 消息路由机制
• channel-groups — 群组行为与 mention 门控