How to Build an Agentic Hotel PMS: Multi-Agent Architecture Explained

TL;DR

Building an agentic hotel PMS requires careful agent decomposition, tool design, handoff logic, and PMS integration. Here is the architecture blueprint, drawn from CallSphere's production 11-agent stack.

Why Multi-Agent?

A monolithic "super agent" trying to handle every hotel workflow fails in production. Problems:

• Tool call explosion (40+ tools in one context)
• Policy drift across domains
• Handoff confusion
• Hallucinations on rarely-used tools
• Debugging nightmare

Multi-agent decomposition solves these by giving each agent a narrow domain.

Agent Decomposition Principles

1. One agent per primary business domain (reservation, check-in, housekeeping, etc.)
2. Shared context via typed state (not just conversation history)
3. Explicit handoff contracts (each handoff includes required context)
4. Tool specialization (tools live with the agent that owns them)
5. Clear escalation paths (every agent can escalate to human)

Tool Design

Tools should be:

• Idempotent where possible (safe to retry)
• Strongly typed (JSON schema enforcement)
• Observable (all tool calls logged)
• Rate-limited per tenant

Example tool schema for create_reservation:

{
  name: "create_reservation",
  description: "Create a confirmed reservation in the PMS",
  parameters: {
    guest_id: "string",
    check_in: "ISO 8601 date",
    check_out: "ISO 8601 date",
    room_type: "enum: standard|deluxe|suite",
    rate_plan: "string",
    payment_token: "string (Stripe token)"
  },
  returns: {
    reservation_id: "string",
    confirmation_number: "string"
  }
}

Handoff Contracts

Each handoff includes:

• Current agent's summary of conversation
• Required context for receiving agent
• Open tool calls to complete
• Guest profile state

Example handoff from Concierge to Reservation:

{
  "from": "concierge",
  "to": "reservation",
  "context": {
    "guest_phone": "+15551234567",
    "guest_name": "John Smith",
    "loyalty_tier": "Gold",
    "intent": "book_room",
    "dates_mentioned": ["2026-05-15", "2026-05-17"],
    "language": "en"
  }
}

PMS Integration Layer

Build a PMS abstraction layer so agent code is PMS-agnostic:

[Agents] -> [PMS Abstraction] -> [Opera|Mews|Cloudbeds|ASI adapters]

Each adapter implements the same interface (create_reservation, update_folio, get_room_status, etc.) but translates to the specific PMS API.

Guardrails

Multi-layer guardrails:

1. Input guardrails: language validation, intent confidence threshold
2. Tool guardrails: schema enforcement, rate limiting, policy checks
3. Output guardrails: hallucination detection, policy compliance
4. Human escalation: when any guardrail fails

Observability

Log every:

• Agent activation
• Tool call (with parameters and result)
• Handoff (with context payload)
• User utterance + agent response
• Guardrail trigger

Feed into LangSmith, Langfuse, or a custom observability stack.

Deployment

Production deployment uses:

• Containerized agents (Docker/Kubernetes)
• Stateless message-queue orchestration (NATS or Kafka)
• Persistent conversation state (PostgreSQL)
• Redis for low-latency state cache
• ChromaDB / Pinecone for RAG

FAQ

Q: How many agents is too many? A: Depends on domain. Hotels benefit from ~10–12 agents. Fewer = monolithic, more = handoff chaos.

Q: Can I use LangGraph instead of OpenAI Agents SDK? A: Yes. LangGraph, CrewAI, AutoGen all work.

Q: What's the biggest production pitfall? A: Handoff context loss. Invest in typed context contracts.

---

Related: CallSphere hotel stack | Hotel industry

#Architecture #MultiAgent #Design #CallSphere