브로드캐스트 그룹

원자적이고 집중된 책임을 가진 여러 에이전트를 배포합니다.

Group: "Development Team"
Agents:
  - CodeReviewer (reviews code snippets)
  - DocumentationBot (generates docs)
  - SecurityAuditor (checks for vulnerabilities)
  - TestGenerator (suggests test cases)

각 에이전트는 동일한 메시지를 처리하고 자신의 전문 관점을 제공합니다.

Group: "International Support"
Agents:
  - Agent_EN (responds in English)
  - Agent_DE (responds in German)
  - Agent_ES (responds in Spanish)

Group: "Customer Support"
Agents:
  - SupportAgent (provides answer)
  - QAAgent (reviews quality, only responds if issues found)

Group: "Project Management"
Agents:
  - TaskTracker (updates task database)
  - TimeLogger (logs time spent)
  - ReportGenerator (creates summaries)

각 에이전트를 하나의 명확한 책임으로 설계합니다.

{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}

✅ 좋음: 각 에이전트는 하나의 작업을 담당합니다. ❌ 나쁨: 하나의 범용 "dev-helper" 에이전트.

각 에이전트가 무엇을 하는지 명확하게 합니다.

{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}

에이전트에 필요한 도구만 부여합니다.

{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] }
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] }
    }
  }
}

reviewer는 읽기 전용입니다. fixer는 읽고 쓸 수 있습니다.

에이전트가 많은 경우 다음을 고려하세요.

• 속도를 위해 "strategy": "parallel"(기본값) 사용
• 브로드캐스트 그룹을 5~10개 에이전트로 제한
• 더 단순한 에이전트에는 더 빠른 모델 사용

에이전트는 독립적으로 실패합니다. 한 에이전트의 오류가 다른 에이전트를 차단하지 않습니다.

Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]
Result: Agent A and C respond, Agent B logs error

확인:

1. 에이전트 ID가 agents.list에 존재합니다.
2. 피어 ID 형식이 올바릅니다(예: [email protected]).
3. 에이전트가 거부 목록에 없습니다.

디버그:

tail -f ~/.openclaw/logs/gateway.log | grep broadcast

원인: 피어 ID가 bindings에는 있지만 broadcast에는 없을 수 있습니다.

해결: 브로드캐스트 구성에 추가하거나 바인딩에서 제거합니다.

많은 에이전트로 인해 느린 경우:

• 그룹당 에이전트 수를 줄입니다.
• 더 가벼운 모델을 사용합니다(opus 대신 sonnet).
• 샌드박스 시작 시간을 확인합니다.

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": [
      "code-formatter",
      "security-scanner",
      "test-coverage",
      "docs-checker"
    ]
  },
  "agents": {
    "list": [
      {
        "id": "code-formatter",
        "workspace": "~/agents/formatter",
        "tools": { "allow": ["read", "write"] }
      },
      {
        "id": "security-scanner",
        "workspace": "~/agents/security",
        "tools": { "allow": ["read", "exec"] }
      },
      {
        "id": "test-coverage",
        "workspace": "~/agents/testing",
        "tools": { "allow": ["read", "exec"] }
      },
      { "id": "docs-checker", "workspace": "~/agents/docs", "tools": { "allow": ["read"] } }
    ]
  }
}

사용자 전송: 코드 스니펫.

응답:

• code-formatter: "들여쓰기를 수정하고 타입 힌트를 추가했습니다"
• security-scanner: "⚠️ 12번째 줄에 SQL 삽입 취약점이 있습니다"
• test-coverage: "커버리지가 45%이며 오류 사례에 대한 테스트가 없습니다"
• docs-checker: "process_data 함수의 docstring이 없습니다"

{
  "broadcast": {
    "strategy": "sequential",
    "+15555550123": ["detect-language", "translator-en", "translator-de"]
  },
  "agents": {
    "list": [
      { "id": "detect-language", "workspace": "~/agents/lang-detect" },
      { "id": "translator-en", "workspace": "~/agents/translate-en" },
      { "id": "translator-de", "workspace": "~/agents/translate-de" }
    ]
  }
}