Documentation Index
Fetch the complete documentation index at: https://docs.vorel.ai/llms.txt
Use this file to discover all available pages before exploring further.
The real-estate pack tunes Vorel’s voice + chat agent for property brokerages and developers. It seeds an agent persona, the slots the agent collects on every qualification, the catalog attributes for offerings, the handoff triggers, and a few prompt-level overrides — all without code.
Persona defaults
| Field | Value |
|---|
| Agent name (English) | Maya |
| Agent name (Arabic) | مايا |
| Business framing | ”real estate brokerage” / “وساطة عقارية” |
| Target customer | ”buyers and renters” |
| Appointment noun | ”viewing” / “معاينة” |
| Tone | warm and professional, with a light dry wit when it fits naturally |
Signature phrases (used at most once per call)
happy to help · let me check that for you · بكل سرور · خلّيني أتأكد لك
Forbidden phrases (the agent will never say)
guaranteed · definitely a great investment · you can't go wrong · best deal in Dubai · trust me · مضمون · صفقة العمر · أفضل سعر بالسوق
This forbidden list defends against the most common over-promise traps in MENA real estate marketing copy. Add tenant-specific phrases (e.g. your brand’s restricted vocabulary) via the dashboard’s pack-overrides UI without a code deploy.
What the agent qualifies
Sourced verbatim from config/verticals/real_estate.json prompt_overrides.qualification_extra_rules:
Probe for intent (buy vs rent), property type, bedrooms, budget range with currency, preferred areas, and timeline. Capture financing_needed if the caller mentions mortgage or cash. UAE callers commonly use Arabic-numeral price phrasing (e.g. “two and a half million” → 2,500,000); accept either.
Lead attributes captured
These slots populate leads.attributes as the agent learns them across the conversation:
| Slot | Type | Notes |
|---|
bedrooms | number | Studio counts as 0 |
budget_min | number | Minimum budget |
budget_max | number | Maximum budget |
budget_currency | string | Defaults to AED |
preferred_areas | string[] | Areas / communities (e.g. Dubai Marina, JVC) |
property_type | string | apartment · villa · townhouse · office · retail · land |
financing_needed | boolean | True when the caller mentions mortgage/financing |
Offering catalog attributes
Property listings stored as Vorel offerings carry these vertical-specific attributes:
| Attribute | Type | Examples |
|---|
listing_type | string | sale · rent |
property_type | string | apartment · villa · townhouse · office · retail · land |
bedrooms | number | — |
bathrooms | number | — |
size_sqft | number | — |
area | string | District / area |
community | string | Sub-district / community |
rent_period | string | yearly · monthly |
amenities | string[] | Free-form (e.g. pool, gym, sea view, maids room) |
Handoff triggers (defaults)
The pack ships with these triggers ON by default:
- On complaint — anything sounding like a service grievance routes to a human.
- On compliance — regulatory / legal questions (RERA, Ejari, escrow, ownership rules) escalate.
- On negotiation — pricing / commission negotiations escalate.
- On explicit request — caller says “transfer me” / “let me speak to someone”.
on_stuck is OFF by default for real estate — the agent typically has enough information to recover from a single confused turn without escalating.
Worth knowing
- Bilingual price phrasing. UAE callers fluently mix Arabic-numeral and English-numeral phrasing (“two and a half million” → 2,500,000). The qualification prompt explicitly tells the agent to accept either.
- Viewing booking flow. Books against your offerings + your hours via Vorel’s
book_appointment tool. The post-confirm hint advises that “after the viewing, the assigned agent meets the customer at the property location” — so the booking confirmation copy your tenant gets reflects the in-person meet at the property.
- No price guarantees. The pack’s forbidden phrases list is deliberately tight on superlatives (“best deal in Dubai”, “guaranteed”). This is a trust-and-compliance posture for a market where misleading price claims are a regulatory risk.
Per-tenant tuning
Your operator can override any of the above per-tenant via the dashboard’s pack-overrides UI:
- Append signature / forbidden phrases — your brand voice phrases get added on top of the pack defaults (de-duplicated).
- Replace prompt overrides per-key — e.g. tenant-specific qualification rules (focus on luxury vs. mass-market segments) replace the pack’s value for that key only.
- Full prompt edits — for deeper rewrites, the
tenant_prompt_overrides table replaces individual sub-agent prompts (qualification / FAQ / booking / handoff).
