Skip to main content

Pizza Tracker

The Pizza Tracker is a real-time progress monitoring system that keeps users informed during AI Agent operations.

🍕 What is the Pizza Tracker?​

Inspired by Domino's order tracking, the Pizza Tracker shows live progress when:

  • Running Magic Search
  • Executing AI Agent tools
  • Processing sentiment analysis
  • Scraping multiple data sources

🎨 Visual Design​

The tracker appears as a terminal-style panel with:

  • Status icons (⏳ pending, 🔄 running, ✅ complete)
  • Progress bars for long-running operations
  • Real-time stats (reviews collected, pages processed)
  • Estimated time to completion

📊 What It Shows​

🔍 Finding Kununu profile...     ✅
🚀 Starting scraping jobs...     ✅
📊 Kununu: 156/200 reviews       🔄 78%
📊 Google: 45/50 reviews         🔄 90%
📊 Reddit: 12 discussions        ✅
📊 Vacancies: 8 job posts        ✅
🤖 Running sentiment analysis... ⏳
✅ Analysis complete!

During AI Agent Tools​

🤖 AI Agent is working...
├── search_company("BMW")        ✅ Found
├── get_trust_score("BMW")       🔄 Calculating...
└── get_company_reviews("BMW")   ⏳ Pending

🔧 Technical Implementation​

Frontend Component​

// ChatWidget.jsx
<AgentStatusTracker 
  toolCalls={toolCalls}
  isActive={isProcessing}
/>

Backend Response​

{
  "response": "BMW has a Trust Score of 74...",
  "tool_calls": [
    {"name": "search_company", "args": {"company_name": "BMW"}, "status": "complete"},
    {"name": "get_trust_score", "args": {"company_name": "BMW"}, "status": "complete"}
  ]
}

WebSocket Updates​

For long-running operations, progress updates via WebSocket:

// Real-time updates
socket.on('scraping_progress', (data) => {
  setProgress(data.reviews_collected);
  setTotal(data.total_expected);
});

🎯 Benefits​

User Experience​

  • Reduces anxiety - Users know something is happening
  • Sets expectations - Estimated time shown
  • Builds trust - Transparency in process

Engagement​

  • Retention - Users stay on page
  • Interest - Dynamic updates are engaging
  • Premium feel - Professional experience

📊 Progress States​

StateIconMeaning
Pending⏳Waiting to start
Running🔄Currently processing
Complete✅Finished successfully
Error❌Failed (with message)

🛠️ Configuration​

Show/Hide​

The tracker automatically appears when tools are in use:

  • Shows: When tool_calls has pending items
  • Hides: When all tools complete

Polling Interval​

For scraping jobs, progress polls every 2 seconds:

const POLL_INTERVAL = 2000; // ms

The Pizza Tracker creates a premium, transparent experience during AI operations.