Agen Hotel LLM — CS Hotel Kencana
Prototipe customer service hotel mandiri (self-service) berbasis sistem multiagen dengan balasan natural dari LLM (Google Gemini API).
Tugas Kelompok 5, mata kuliah Agen Cerdas Enterprise, Magister Kecerdasan Artifisial UGM.
Fitur
Sisi pelanggan
- Registrasi cukup dengan nama.
- Chat untuk pemesanan kamar, pembayaran (simulasi), keluhan, dan pertanyaan umum.
- Check-in dan check-out mandiri, serta buka dan kunci pintu kamar (kunci digital simulasi) langsung dari chat.
- Setiap balasan diberi label agen yang menjawab, beserta niat dan tingkat keyakinan dari Orkestrator.
Sisi admin (akun demo admin / kencana)
- Papan 5 kamar: status (Tersedia / Sudah dipesan / Terisi), nama tamu, tanggal masuk dan keluar, status bayar, status pintu (terkunci/terbuka).
Tombol check-in/check-out di papan kamar adalah cadangan untuk staf.
- Antrean pertanyaan yang dieskalasi ke manusia. Balasan admin langsung muncul di chat tamu.
- Log aktivitas agen.
Arsitektur agen
| Agen | Tugas |
|---|
| Orkestrator | Membaca maksud pesan lalu memilih agen |
| Agen Reservasi | Cek kamar kosong, buat dan batalkan pemesanan |
| Agen Billing | Tagihan, folio, pembayaran |
| Agen Akses Kamar | Check-in & check-out mandiri, buka dan kunci pintu |
| Agen Layanan Kamar | Keluhan dan housekeeping |
| Agen Concierge | Info hotel dan fasilitas |
| Agen Eskalasi | Meneruskan kasus ke Front Office Manager (manusia) |
Alurnya: pesan tamu → Orkestrator (LLM) mengembalikan JSON berisi agen, niat, teks balasan, dan aksi →
aksi (pesan kamar, bayar, batal, tiket, eskalasi, check-in, check-out, buka/kunci pintu) divalidasi dan dijalankan oleh kode, bukan oleh LLM.
Jadi LLM tidak bisa memesan kamar yang sudah terisi, mengaku sudah menerima bayaran, atau membuka pintu sebelum tamu check-in.
Syarat check-in mandiri: tagihan lunas, hari ini tanggal check-in, dan sudah pukul 14.00
(CHECKIN_HOUR di js/agents/akses-kamar.js; ubah ke 0 untuk demo kapan saja).
Kalau LLM tidak tersedia (API key belum diatur, kuota habis, atau dibuka sebagai file lokal),
sistem otomatis memakai aturan kata kunci.
Struktur
index.html Kerangka halaman (HTML saja) dan urutan pemuatan script
css/style.css Tampilan
js/utils.js Fungsi bantu (tanggal, rupiah, teks)
js/data.js "Database": kamar, tamu, eskalasi, log (di memori browser) + data contoh
js/chat.js Mengirim pesan tamu dan menampilkan balasan agen
js/agents/orkestrator.js Orkestrator: klasifikasi niat (kata kunci) dan memilih agen
js/agents/reservasi.js Agen Reservasi
js/agents/billing.js Agen Billing
js/agents/layanan-kamar.js Agen Layanan Kamar
js/agents/concierge.js Agen Concierge (termasuk FAQ / fakta hotel)
js/agents/eskalasi.js Agen Eskalasi
js/agents/akses-kamar.js Agen Akses Kamar (check-in/out mandiri, kunci pintu)
js/llm.js Mesin LLM: menyusun prompt, memvalidasi dan menjalankan aksi dari LLM
js/ui/pelanggan.js Tampilan registrasi dan chat
js/ui/admin.js Tampilan admin: papan kamar, eskalasi, log
js/main.js Pindah tab dan inisialisasi
api/chat.js Fungsi server Vercel yang memanggil Gemini API
.env.example Contoh environment variable
Script dimuat sebagai <script> biasa (bukan ES module) supaya index.html tetap bisa dibuka langsung tanpa server.
Urutannya di index.html penting: file di bawah memakai fungsi dari file di atasnya.
Deploy ke Vercel
- Buka vercel.com/new, impor repo ini dari GitHub.
- Framework preset: Other. Build command dan output directory dikosongkan.
- Di Environment Variables, tambahkan:
- Klik Deploy. Setiap push ke branch
main akan otomatis di-deploy ulang.
Menjalankan lokal
npm i -g vercel
cp .env.example .env.local # isi API key
vercel dev
Buka http://localhost:3000. Membuka index.html langsung tanpa server juga bisa, tapi balasan memakai aturan kata kunci.
Catatan
- Data (kamar, tamu, eskalasi) tersimpan di memori browser dan hilang saat halaman di-refresh.
Tampilan pelanggan dan admin harus di tab yang sama.
- Kamar 102 dan 201 beserta tamu Budi Santoso dan Sari Wulandari adalah data contoh.
- Pembayaran hanya simulasi.
- Kuota gratis Gemini terbatas per project. Kalau kuota habis, balasan sementara memakai aturan kata kunci.
Data di kuota gratis dapat dipakai Google untuk pengembangan produk, jadi jangan masukkan data pribadi sungguhan.
