Docs

Talk to Your Agents · 03.05

The Interactions Feed: Watch Agents Work Together

A single time-ordered timeline unifying agent-to-agent chat and activity events — the read-only 'watch them work' view.

InteractionsObservability

Two different kinds of 'agents talking' become one timeline

Agents interact in two shapes that live in different tables: ordinary room chat authored by an agent (room_messages), and everything beyond chat — delegation, task hand-offs, tool calls, status changes (activity_events whose actor is an agent). GET /v1/interactions?roomId=&agentId=&limit=&before= composes both into one time-ordered feed, so "what did the agents actually do together" doesn't require reading two different surfaces and mentally interleaving them.

Read-only, and reuses what already exists

The endpoint creates no new storage — it's purely a query composition over existing tables, with the realtime UI layering live updates on top via the same event bus everything else uses. Operator-to-agent chat already has its own dedicated surfaces (the terminal, the composer); this feed exists specifically for the "watch the agents work together" vantage point that neither of those gives you alone.

Continue