Agent Architecture
Each AI agent is purpose-built for a specific domain, allowing for deeper expertise and better performance than a single generalist AI.Command Center
Scheduling
Intelligence
Agent Status Indicators
Every agent displays a real-time status visible throughout the platform:Online (Green Pulse)
Visual: ● with animated pulsing ring Meaning: Agent is actively processing tasks and responding to events in real-time. What the agent is doing:- Monitoring for new tasks (conversations, bookings, alerts)
- Processing queued work
- Learning from outcomes to improve performance
- Communicating with other agents when needed
Idle (Yellow)
Visual: ◐ solid yellow dot Meaning: Agent is waiting for new tasks. No current work in queue. What this means:- Not an error — agent is healthy and ready
- Common for batch-processing agents (Demand Forecaster, Report Generator)
- Will transition to Online when triggered
Error (Red Pulse)
Visual: ⚠ with animated pulsing ring Meaning: Agent encountered an issue and is attempting to recover. Common causes:- Temporary API rate limit (Zenoti, Anthropic)
- Network connectivity hiccup
- Unexpected data format
- High computational load
- Error persists >30 minutes
- Multiple agents in error state simultaneously
- Critical agent (Conversation Analyst, Response Monitor) stuck in error
Command Center Agents
Three agents work together to manage all customer communications:Conversation Analyst
Type: AnalysisModule: Command Center
Status: ● Online (typical)
Tasks Handled: 1,247 (monthly average) Responsibilities:
Voice Call Transcription
Voice Call Transcription
- Real-time speech-to-text conversion
- Speaker diarization (AI vs. Client vs. Staff)
- Conversation summarization
- Sentiment detection (positive/neutral/negative)
Intent Recognition
Intent Recognition
- Booking request detection
- Question vs. complaint classification
- Urgency assessment
- VIP client identification
Opportunity Identification
Opportunity Identification
- Upsell potential in conversation
- Package deal suitability
- Client education needs
- Referral opportunities
Escalation Detection
Escalation Detection
- Medical concern keywords
- Negative sentiment patterns
- Billing dispute language
- Policy exception requests
- Speech recognition: Deepgram real-time ASR
- Natural language: Claude 4.5 Sonnet
- Sentiment: Custom model trained on med spa conversations
- 98.7% transcription accuracy
- 94% intent classification accuracy
- 89% escalation prediction accuracy
- Less than 2 second analysis latency
Response Monitor
Type: MonitoringModule: Command Center
Status: ● Online (typical)
Tasks Handled: 2,381 (monthly average) Responsibilities:
Response Time Tracking
Response Time Tracking
- Monitors all incoming inquiries across channels
- Timestamps first response
- Calculates and reports response time SLAs
- Alerts on delayed responses (>5 minutes)
Conversation Management
Conversation Management
- Routes SMS and web chat conversations
- Manages conversation state (active/waiting/resolved)
- Ensures no inquiry goes unanswered
- Handles conversation handoffs (AI to staff)
Multi-Channel Coordination
Multi-Channel Coordination
- Recognizes same client across channels
- Prevents duplicate responses
- Maintains conversation history context
- Syncs updates across platforms
After-Hours Coverage
After-Hours Coverage
- 24/7 monitoring (no downtime)
- Instant response to after-hours inquiries
- Flags urgent issues for on-call staff
- Tracks after-hours conversion rates
- Message processing: Custom event queue system
- Response generation: Claude 4.5 Sonnet with RAG
- Context memory: Vector database for conversation history
- 99.2% uptime (including after-hours)
- 8-12 second average response time
- Zero missed inquiries (100% response rate)
- 78% AI resolution rate (no human needed)
Escalation Tracker
Type: TrackingModule: Command Center
Status: ● Online (typical)
Tasks Handled: 312 (monthly average) Responsibilities:
Escalation Routing
Escalation Routing
- Identifies appropriate team member for each escalation
- Considers expertise, availability, and workload
- Provides full context and transcript
- Tracks handoff completion
Priority Management
Priority Management
- Assigns urgency levels (urgent/pending/normal)
- Re-prioritizes based on client responses
- Escalates further if no staff pickup within SLA
- Manages VIP client priority queue
Resolution Monitoring
Resolution Monitoring
- Tracks time-to-resolution for escalations
- Follows up if conversation stalls
- Requests client satisfaction after resolution
- Feeds resolution patterns back to training
Feedback Loop
Feedback Loop
- Analyzes why escalations occurred
- Identifies AI knowledge gaps
- Recommends training data additions
- Reduces future escalation rate
- Routing logic: Multi-factor optimization algorithm
- Priority scoring: ML model trained on outcomes
- Tracking system: Real-time event stream processing
- Less than 15 minute average staff pickup time
- 92% first-contact resolution
- 18% month-over-month reduction in escalation rate (AI learning)
- 4.6/5 average client satisfaction on escalated issues
Scheduling Agents
Three agents collaborate to optimize your appointment book:Schedule Analyst
Type: SchedulingModule: Scheduling
Status: ● Online (typical)
Tasks Handled: 1,893 (monthly average) Responsibilities:
Utilization Analysis
Utilization Analysis
- Calculates real-time utilization by provider, room, location
- Identifies underutilized time slots
- Predicts utilization 7-14 days out
- Recommends slot consolidation opportunities
Waitlist Management
Waitlist Management
- Matches waitlist clients to cancellations in under 30 seconds
- Prioritizes by VIP status, wait time, service value
- Sends instant notifications to matched clients
- Tracks waitlist conversion rates
Booking Optimization
Booking Optimization
- Routes new bookings to optimize utilization
- Reserves prime slots for high-value services
- Balances workload across providers
- Suggests alternative times for better efficiency
Multi-Appointment Coordination
Multi-Appointment Coordination
- Books multiple services in logical sequence
- Identifies room/provider conflicts
- Optimizes same-day multi-service bookings
- Manages couple/group bookings
- Optimization engine: Constraint satisfaction solver
- Matching algorithm: Weighted scoring with real-time updates
- Prediction model: Time series forecasting (Prophet)
- 68% waitlist conversion rate
- 18.5% average utilization improvement
- Under 30 second waitlist fill time
- 94% booking accuracy (no double-books)
No-Show Predictor
Type: PredictionModule: Scheduling
Status: ● Online (typical)
Tasks Handled: 647 (monthly average) Responsibilities:
Risk Scoring
Risk Scoring
- Calculates no-show probability for every appointment
- Updates scores as new signals arrive (confirmations, etc.)
- Categorizes as low/medium/high risk
- Triggers prevention workflows for high-risk
Prevention Automation
Prevention Automation
- Sends 24-hour reminders to medium+ risk
- Sends 2-hour reminders to high risk
- Personalized messaging based on client preferences
- One-click confirm/cancel links
Pattern Learning
Pattern Learning
- Identifies client-specific no-show patterns
- Day-of-week and time-of-day correlations
- Service type risk factors
- Lead time impact on no-show likelihood
Intervention Tracking
Intervention Tracking
- Measures prevention success rate by strategy
- A/B tests reminder timing and messaging
- Calculates ROI of no-show prevention
- Feeds results back to prediction model
- Prediction model: Gradient boosting (XGBoost) with 15+ features
- Reminder system: Multi-channel message orchestration
- A/B testing: Bayesian optimization for message variants
- 73% prevention success rate for high-risk appointments
- 57% overall no-show rate reduction
- 85% prediction accuracy (correctly identifies high-risk)
- 35,000 monthly revenue saved per location
Demand Forecaster
Type: AnalyticsModule: Scheduling
Status: ◐ Idle (typical)
Tasks Handled: 89 (monthly average) Responsibilities:
Demand Prediction
Demand Prediction
- Forecasts appointment demand by day/time/service
- Identifies seasonal patterns
- Predicts impact of marketing campaigns
- Projects capacity needs 30-90 days out
Staffing Recommendations
Staffing Recommendations
- Suggests optimal provider schedules
- Identifies overstaffed vs. understaffed periods
- Recommends cross-training opportunities
- Calculates staffing ROI scenarios
Pricing Strategy
Pricing Strategy
- Identifies price-sensitive vs. price-insensitive time slots
- Recommends dynamic pricing opportunities
- Suggests promotional timing for maximum impact
- Models revenue impact of pricing changes
Capacity Planning
Capacity Planning
- Projects when current capacity will be insufficient
- Models scenarios (new provider, new room, new location)
- Estimates revenue impact of expansion
- Identifies optimal timing for growth investments
- Forecasting: Facebook Prophet with custom seasonality
- Scenario modeling: Monte Carlo simulation
- Recommendation engine: Multi-objective optimization
- 89% forecast accuracy (within 10% of actual demand)
- 12% revenue increase from optimized staffing
- 3-6 month advance warning on capacity constraints
- Runs weekly (hence typically shows “Idle” status)
Intelligence Agents
Three agents power your revenue analytics:Revenue Analyst
Type: AnalyticsModule: Intelligence
Status: ● Online (typical)
Tasks Handled: 412 (monthly average) Responsibilities:
Revenue Attribution
Revenue Attribution
- Tracks revenue by source (AI, staff, online, walk-in)
- Calculates AI contribution vs. baseline
- Attributes revenue to marketing channels
- Measures ROI of AI system
Trend Analysis
Trend Analysis
- Identifies revenue trends (daily, weekly, monthly)
- Detects anomalies and investigates causes
- Compares locations and providers
- Projects future revenue based on trends
Gap Identification
Gap Identification
- Calculates response gap (slow/missed inquiries)
- Measures no-show prevention impact
- Identifies upsell opportunities missed
- Quantifies after-hours revenue capture
AI Analyst Chatbot
AI Analyst Chatbot
- Powers conversational business intelligence
- Answers natural language questions
- Generates custom analyses on demand
- Provides actionable recommendations
- Analytics engine: Custom Python + Pandas + NumPy
- Attribution model: Multi-touch attribution with decay
- Chatbot: Claude 4.5 Sonnet with RAG over your data
- 97% revenue attribution accuracy (validated against Zenoti)
- Under 5 second response time for chatbot queries
- 92% user satisfaction with chatbot answers
- 50K monthly revenue gaps identified per location
Opportunity Scout
Type: AnalyticsModule: Intelligence
Status: ● Online (typical)
Tasks Handled: 238 (monthly average) Responsibilities:
Opportunity Discovery
Opportunity Discovery
- Scans for churn risk (clients not returning)
- Identifies rebooking opportunities
- Finds upsell gaps (clients who usually bundle)
- Detects underutilized capacity
Value Quantification
Value Quantification
- Estimates revenue potential for each opportunity
- Calculates probability of conversion
- Prioritizes by expected value
- Tracks opportunity decay over time
Recommendation Engine
Recommendation Engine
- Suggests specific actions for each opportunity
- Provides messaging templates
- Recommends optimal timing for outreach
- Assigns to appropriate team member
Outcome Tracking
Outcome Tracking
- Monitors opportunity resolution
- Measures conversion rate by opportunity type
- Calculates actual revenue captured
- Improves recommendations based on results
- Discovery: Pattern matching + anomaly detection
- Valuation: Regression models trained on historical conversions
- Recommendation: Reinforcement learning (improving over time)
- 40-60 opportunities identified per location per month
- 58% conversion rate when acted upon
- 15,000 monthly revenue from opportunity actions
- Hourly scan frequency (always finding fresh opportunities)
Report Generator
Type: ReportingModule: Intelligence
Status: ◐ Idle / ⚠ Error (typical)
Tasks Handled: 156 (monthly average) Responsibilities:
Scheduled Reports
Scheduled Reports
- Weekly performance summary (sent Mondays)
- Monthly executive report (sent 1st of month)
- Custom recurring reports (user-configured)
- Automated distribution via email
Custom Analysis
Custom Analysis
- Ad-hoc report generation on demand
- Custom date ranges and filters
- Comparative analysis (locations, providers, periods)
- Export to PDF, Excel, CSV
Data Visualization
Data Visualization
- Charts and graphs for all metrics
- Location comparison dashboards
- Trend visualizations
- Executive summary slides
Compliance Documentation
Compliance Documentation
- HIPAA-compliant data handling
- Audit trail generation
- Data retention policy enforcement
- Regulatory reporting support
- Report engine: Custom templating system
- Data export: Pandas + Openpyxl + ReportLab
- Scheduling: Cron-based job system
- 98% on-time report delivery
- Under 5 minute generation time for standard reports
- Supports 50+ custom report templates
- Note: Often shows Idle (waiting for schedule) or Error (resource-intensive jobs)
Inter-Agent Communication
Agents don’t work in isolation—they communicate to provide seamless experiences:Example: Booking Flow
Response Monitor receives inquiry
Conversation Analyst extracts details
- Service: Botox
- Preferred day: Saturday
- Location: (inferred from IP or asks client)
- No specific time mentioned
Schedule Analyst finds optimal slot
- Checks Saturday availability
- Considers utilization (slots other services to balance)
- Offers 10 AM, 2 PM, 4 PM (avoiding over-booking Dr. Chen)
No-Show Predictor assesses risk
- New client = higher baseline risk
- Web chat booking = medium risk (vs. phone = lower)
- Saturday = higher risk
- Calculates 45% no-show probability
- Tags as “medium risk” for automated reminders
Response Monitor confirms booking
Opportunity Scout checks for upsell
- Botox clients at this location also book Hydrafacial 40% of the time
- Suggests add-on
Agents involved: 5
Human intervention: Zero
Agent Learning & Improvement
All agents use machine learning to improve over time:What Agents Learn From
Conversation outcomes:- Which responses led to bookings vs. abandonment
- Optimal phrasing for common questions
- When to escalate vs. continue handling
- Sentiment patterns that predict client satisfaction
- Which no-show predictions were accurate
- Effectiveness of different reminder timing/messaging
- Utilization optimization success rates
- Waitlist conversion factors
- Which opportunities had highest conversion
- Accuracy of demand forecasts
- Attribution model refinements
- Chatbot answer quality ratings
Continuous Improvement
Weekly model updates:- Conversation Analyst: Retrained on last week’s conversations
- No-Show Predictor: Updated coefficients based on actual outcomes
- Opportunity Scout: Adjusted value estimates based on conversions
- Response Monitor: Optimize routing logic
- Schedule Analyst: Refine optimization algorithms
- Revenue Analyst: Validate attribution accuracy
- New features based on user feedback
- Integration of latest AI model improvements (e.g., Claude upgrades)
- Performance benchmarking and tuning
Agent Monitoring & Health
Dashboard Visibility
Every module (Dashboard, Command Center, Scheduling, Intelligence) shows the agents relevant to that module. What you see:- Agent name and type
- Real-time status (Online/Idle/Error)
- Tasks handled (monthly count)
- Last activity timestamp
Health Checks
Every agent performs self-checks every 60 seconds:- Connectivity: Can reach all required APIs (Zenoti, Anthropic, etc.)
- Performance: Processing tasks within SLA (under 5 second response time)
- Accuracy: Recent predictions/actions within quality thresholds
- Queue depth: Not backed up with too many pending tasks
Support Escalation
You should contact support if: Critical agents in error >10 minutes:- Conversation Analyst
- Response Monitor
- Schedule Analyst
- Agent name and status
- Time error started
- Screenshot of agent status panel
- Any error messages visible in UI
Best Practices
Check agent status daily
Check agent status daily
- Open Dashboard
- Scroll to AI Agents module
- Verify all critical agents show Online (green)
- If any errors, wait 5 minutes and check again
- If error persists, contact support
Trust the agents, but verify
Trust the agents, but verify
- Spot-check AI conversations weekly (review 10-15)
- Compare AI bookings to what you would have done
- Verify no-show predictions after appointments occur
- Validate opportunity recommendations before acting
Provide feedback on agent actions
Provide feedback on agent actions
- Use “Report Issue” button in conversation transcripts
- Describe what should have happened
- Your feedback directly improves the agents
Monitor task counts over time
Monitor task counts over time
- Growing counts = agents handling more (good, means business growing)
- Declining counts = potential issue (less activity, or agent not working)
- Sudden spikes = investigate (could be error causing false triggers)