Docs/Observability/Agent Replay

Agent Replay

Agent Replay

Agent Replay provides a chronological timeline of everything an agent did during a session, grouped into chapters by task boundaries.

How It Works

When you open a trace detail page, click the Session Replay tab. The replay view:

1. Fetches all events from the session 2. Groups them into chapters — each task.created event starts a new chapter 3. Displays events chronologically within each chapter 4. Shows event type, timestamp, description, and channel

Use Cases

  • Post-mortem analysis: Understand exactly what an agent did before an error
  • Onboarding: Show team members what agents do during typical workflows
  • Debugging: Step through agent decisions to find where things went wrong
  • Optimization: Identify redundant steps or slow operations

Viewing a Replay

1. Navigate to Traces in the sidebar 2. Click on any trace row 3. Switch to the Session Replay tab 4. Browse chapters and events chronologically