Event Schema

Every agent action generates structured event data that you can analyze programmatically.

Event Structure

{
  "event_id": "evt_1a2b3c4d5e6f",
  "agent_id": "agent_7g8h9i0j",
  "timestamp": "2024-12-06T15:30:45.123Z",
  "session_id": "session_abc123",
  "event_type": "click",
  "target": {
    "selector": "#submit-button",
    "text": "Submit",
    "tag": "button",
    "position": { "x": 450, "y": 320 }
  },
  "context": {
    "url": "https://your-product.com/checkout",
    "viewport": { "width": 1920, "height": 1080 },
    "scroll_position": 240
  },
  "metadata": {
    "intent": "complete_purchase",
    "confidence": 0.94,
    "alternatives_considered": 2
  }
}

Event Types

• click - Element clicked
• input - Text entered into field
• scroll - Page scrolled
• navigate - Page navigation
• error - Error encountered
• abandon - Task abandoned
• success - Goal achieved

Exporting Events

# Export as JSON
crowdi export --run run_abc123 --format json > events.json

# Export as CSV
crowdi export --run run_abc123 --format csv > events.csv

Streaming Events

For real-time processing, stream events via webhook:

crowdi run --url https://your-product.com --webhook https://api.your-product.com/events