How allail-qadrillah/ace-intelliegent-mobile-agent-system works
ACE is an offline Streamlit hotel-service simulation. Guests or staff use the interface to launch a scenario; the simulation coordinates agents through a case, policy checks, and (for room changes) candidate search, physical-readiness inspection, guest consent, a fresh readiness check, and an atomic reservation update. Other documented paths cover billing and manager escalation, concierge FAQs, housekeeping tickets, batch scenarios, and evaluation. The two SQLite stores and logical mobile-agent state migration are local to one Python process—not external services or physical server transfers. Some subsystem links rely on README capabilities because their implementations were not sampled.
Main entry points: orchestrator.py Case orchestrator · simulation.py Simulation engine · repository.py Hotel repositories · ui.py Hotel interface
Components 18
Hotel experience
- Streamlit entry
app.py - Hotel interface
hotel_demo/ui.py - Scenario data
data/scenarios.json
Case coordination
- Simulation engine
hotel_demo/simulation.py - Case orchestrator
hotel_demo/agents/orchestrator.py - Scenario evaluation
hotel_demo/evaluation.py - Human-review model
hotel_demo/ml.py
Domain agents
- Reservation agent
hotel_demo/agents/reservation.py - Mobile investigator
hotel_demo/agents/mobile_investigator.py - Operations agent
hotel_demo/agents/operations.py - Billing agent
hotel_demo/agents/billing.py - Concierge agent
hotel_demo/agents/concierge.py
State and policy
- State migration
hotel_demo/migration.py - Policy guardrails
hotel_demo/policy.py - Hotel repositories
hotel_demo/repository.py - Hotel seed data
data/hotel_seed.json
Other components
- Hotel guest
- Hotel staff
Connections 23
- Hotel guest → Hotel interface: uses guest portal
- Hotel staff → Hotel interface: uses staff tools
- Streamlit entry → Hotel interface: renders views
- Hotel interface → Simulation engine: starts and controls
- Hotel interface → Scenario evaluation: runs scenarios
- Simulation engine → Scenario data: loads scenarios
- Simulation engine → Hotel seed data: loads seed
- Simulation engine → Hotel repositories: initializes stores
- Simulation engine → Case orchestrator: dispatches messages
- Case orchestrator → Human-review model: predicts review need
- Case orchestrator → Reservation agent: requests room actions
- Case orchestrator → Operations agent: requests tickets
- Case orchestrator → Billing agent: requests folio lookup
- Case orchestrator → Concierge agent: requests FAQ
- Case orchestrator → Mobile investigator: starts inspection
- Mobile investigator → State migration: starts state transfer
- Mobile investigator → Operations agent: inspects readiness
- Reservation agent → Hotel repositories: finds and commits rooms
- Operations agent → Hotel repositories: reads readiness and writes tickets
- Billing agent → Hotel repositories: reads folio
- Concierge agent → Hotel repositories: reads FAQ
- Hotel repositories → Policy guardrails: validates room commit
- Scenario evaluation → Simulation engine: runs scenarios