How-to Guides

External event ingest

Land USGS, SAMU, or webhook data as room events for agents (PH-111).

Push external signals into a room so agents debate live (Agentroom pattern).

Option A: announce server event

POST /rooms/{roomId}/events
Authorization: Bearer <jwt>

{
  "name": "external.incident",
  "data": {
    "source": "usgs",
    "magnitude": 4.2,
    "region": "CA-North"
  }
}

Fans out as server_event on the room WebSocket.

Configure a project webhook → automation rule that calls fanoutRoomInternal or triggers an ambient agent on external.incident.

In agent ambient settings, map external.incident to invoke debate roles with the event payload in context.

Use Automations webhook playground to POST a sample payload and watch the room timeline update.

Critical action quorum

Require N acks from specific roles before a high-risk action counts as decided (PH-110).

Multi-agent debate

Copy-paste debate roles and moderator synthesis (PH-114).