Inside the CallSphere Hotel Stack: 11 Specialist Agents + Tools
A technical deep dive into CallSphere's 11-agent hotel architecture — the specialists, their tools, handoff logic, and PMS integration layer.
TL;DR
CallSphere's hotel platform is built on OpenAI Agents SDK + Realtime API with 11 specialist agents, each with dedicated tools and handoff logic. Here is the full technical architecture.
Framework Choice
- Voice: OpenAI Realtime API (GPT-4o-realtime-preview)
- PCM16 24kHz audio
- Server VAD turn detection
- Sub-1-second latency
- Orchestration: OpenAI Agents SDK (hierarchical handoffs)
- Analytics: GPT-4o-mini for post-call sentiment, intent, and summarization
- Telephony: Twilio (voice) + SIP trunking
- Backend: Python FastAPI + NATS message queue
- Storage: PostgreSQL (primary), Redis (cache), ChromaDB (RAG)
The 11 Agents
1. Concierge Agent (Triage)
- Model: GPT-4o-realtime
- Tools:
lookup_guest_by_phone,detect_intent,get_hotel_info,route_to_agent - Handoffs: all other agents
2. Reservation Agent
- Tools:
search_availability,quote_rate,check_parity,collect_guest_details,process_deposit,create_reservation - Integrations: PMS, channel manager, payment processor
3. Check-In Agent
- Tools:
verify_reservation,capture_incidentals,issue_mobile_key,assign_room - Integrations: PMS, Salto/Assa Abloy/Dormakaba, Stripe
4. Check-Out Agent
- Tools:
pull_folio,dispute_charge,capture_payment,email_receipt,post_loyalty_points
5. Housekeeping Agent
- Tools:
update_room_status,create_maintenance_ticket,assign_cleaner,report_inspection
6. Guest Services Agent
- Tools:
create_service_request,schedule_wake_up,book_restaurant,extend_check_out,book_activity
7. Group Sales Agent
- Tools:
check_block_inventory,draft_proposal,schedule_site_visit,notify_dosm
8. Revenue Signals Agent
- Mode: Passive observer, not guest-facing
- Tools:
analyze_demand,check_parity,alert_revenue_manager
9. OTA Channel Agent
- Tools:
push_rates,sync_inventory,handle_overbooking - Integrations: Siteminder, Cloudbeds, Derbysoft
10. Loyalty Agent
- Tools:
lookup_loyalty,apply_discount,trigger_upgrade,log_preference - Integrations: Marriott Bonvoy, Hilton Honors, etc.
11. Night Audit + Emergency Agent
- Tools:
late_check_in,verify_identity,classify_emergency,escalate_to_on_call - Runs: 12 AM–7 AM autonomously
Handoff Logic
Handoffs use OpenAI Agents SDK's hierarchical handoff mechanism. Each handoff carries:
- Full conversation history
- Guest profile context
- Current PMS state
- Previous agent notes
RAG for Policy Questions
Each property ingests policy documents (cancellation, pet, parking, amenity, etc.) into ChromaDB. Agents query ChromaDB for accurate policy citation instead of hallucinating.
Guardrails
Multiple guardrails prevent hallucination:
See AI Voice Agents Handle Real Calls
Book a free demo or calculate how much you can save with AI voice automation.
- Input validation (language detection, intent confidence)
- Tool call validation (schema enforcement)
- Output validation (policy accuracy checks)
- Hallucination detection (comparing claims to RAG ground truth)
FAQ
Q: Is this open source? A: No. CallSphere is a managed SaaS.
Q: Can I use my own LLM? A: On enterprise plans, Claude and Gemini available as alternatives.
Q: What's the latency? A: <1 second first response, <200ms for tool calls.
Related: 11-agent stack overview | Hotel industry
#Architecture #MultiAgent #Technical #CallSphere
Written by
CallSphere Team
Expert insights on AI voice agents and customer communication automation.
Try CallSphere AI Voice Agents
See how AI voice agents work for your industry. Live demo available -- no signup required.