Siapkan Prompt Asisten Suara

Penyiapan Cepat

Atur sapaan, balasan cadangan, dan instruksi dalam waktu sekitar 5 menit.

Panduan ini membantu Anda mengatur apa yang didengar tamu saat menggunakan asisten suara.

Panduan ini juga menjelaskan bahwa saran topik menggunakan Vertex RAG terlebih dahulu saat ID file tersedia. Saat ID file tidak tersedia, fitur pembantu tetap beralih ke pengambilan data lama. Anda juga dapat menyesuaikan waktu respons suara. Gateway kini menunggu transkrip yang sudah final sebelum menggunakan giliran audio eksplisit. Selama giliran tamu, AVA menampilkan progres pencarian suara paling banyak satu kali.

Runtime Bawaan

Jika OPENAI_REALTIME_MODEL tidak diatur, AVA menggunakan gpt-realtime-2.1-mini. Tetapkan variabel tersebut secara eksplisit jika tim Anda menginginkan model Realtime yang berbeda.

Platform Vertex AI

Balasan suara menggunakan platform Vertex AI yang sama dengan balasan chatbot. Jika jawaban suara tampak tidak sesuai, periksa setelan platform terlebih dahulu.

Buka: Chatbot → Voice Setup

---

Referensi Cepat

Pengaturan	Yang Dikendalikan	Hasil untuk Tamu
Voice Welcome Message	Pesan pertama yang diucapkan dalam sesi suara	Tamu mendengar sapaan hotel yang jelas
Voice Default Answer	Balasan saat tidak ada jawaban yang andal	Tamu tetap mendapatkan respons yang sopan
Instruction	Panduan nada dan perilaku untuk AI suara	Balasan sesuai dengan gaya komunikasi hotel Anda
Topic Suggestions	Prompt sidebar untuk pertanyaan umum tamu	Tamu melihat saran Vertex RAG atau topik cadangan lama
RAG Request Timeout	Waktu tunggu maksimum untuk jawaban suara	Balasan lambat tetap berjalan hingga batas maksimum
First Chunk Timeout	Waktu tunggu untuk potongan jawaban streaming pertama	Jeda panjang menghentikan balasan AI yang macet lebih awal
Stream Idle Timeout	Waktu tunggu di antara potongan streaming	Stream yang rusak gagal sebelum menggantung selamanya

Akses Paket

• Penyiapan suara memerlukan paket berbayar.
• Akun paket gratis akan melihat prompt upgrade dan tidak dapat menyimpan setelan suara.

Untuk upgrade, buka Settings → Billing & Subscription.

Sebelum Mulai

Pastikan persyaratan berikut terpenuhi:

• Anda memiliki izin untuk mengelola penyiapan chatbot
• Paket Anda mencakup fitur AI chatbot
• Anda mengetahui sapaan dan teks balasan cadangan yang ingin digunakan
• Tim teknis Anda mengetahui setelan timeout gateway suara saat ini

Atur Pesan Suara

1. Buka Chatbot → Voice Setup

2. Di Voice Messages, perbarui Voice Welcome Message

3. Perbarui Voice Default Answer

4. Klik Save pada setiap kartu

   ✓ Pesan sukses muncul. ✓ Stempel waktu penyimpanan muncul di samping tombol.

Atur Instruksi Suara

1. Di halaman yang sama, temukan Voice Instruction

2. Jelaskan nada, aturan frasa, dan perilaku cadangan

3. Klik Save

   ✓ Instruksi disimpan untuk balasan suara di masa mendatang.

Jika instruksi kosong

Menyimpan instruksi kosong akan menerapkan instruksi suara ramah bawaan.

Menggunakan Permintaan Masa Menginap Tamu dan Housekeeping

Asisten suara dapat menggunakan detail masa menginap aktif yang telah diverifikasi untuk menjawab pertanyaan tamu. Untuk sesi QR kamar statis, AVA memperbarui tautan sebelum penggunaan suara jika tepat satu masa menginap aktif di hotel cocok dengan kamar yang dipindai. AVA juga memungkinkan satu masa menginap native DUE_OUT untuk dicocokkan jika kontrak kemampuan PMS Anda mendukung status tersebut. Jika tidak, pencarian QR kamar statis hanya mencocokkan masa menginap CHECKED_IN. Pencarian menggunakan nilai kamar persis yang dikodekan dalam kode QR. Untuk sesi QR lokasi statis, AVA hanya mempertahankan konteks lokasi. AVA tidak melakukan verifikasi reservasi, penautan masa menginap, atau pengayaan video berbasis reservasi. Asisten juga dapat membantu tamu meminta layanan tamu yang telah dikonfigurasi.

Permintaan tamu	Perilaku asisten suara
Menanyakan masa menginap saat ini	Menggunakan konteks reservasi terverifikasi yang tersedia untuk tamu tersebut
Meminta layanan tamu	Mengulangi permintaan persis secara lisan dan meminta tamu mengonfirmasi sebelum mengirimkannya
Permintaan tidak memiliki detail yang diperlukan	Menjelaskan informasi yang kurang atau menawarkan layanan yang tersedia
Menanyakan kamar sebelum check-in	Tidak menampilkan nomor kamar sebelum check-in melalui alur suara
Menggunakan sesi QR lokasi	Menggunakan konteks lokasi tanpa detail reservasi

Konfirmasi diperlukan

Hanya konfirmasi tamu yang eksplisit yang mengirimkan atau membatalkan permintaan layanan tamu. Jika percakapan berubah, tamu harus mengonfirmasi permintaan tersebut lagi. Setelah konfirmasi, AVA mengirimkan permintaan yang telah disiapkan dan ditinjau oleh tamu. Konfirmasi alami seperti “I confirm” dan “I confirm it” diterima. AVA tidak menerima konfirmasi yang mengubah permintaan yang telah disiapkan. Asisten mengulangi permintaan yang telah disiapkan secara lisan sebelum meminta konfirmasi. Alur ini hanya menggunakan audio. Alur suara tidak pernah merujuk pada apa pun yang ditampilkan, diperlihatkan, atau ada di layar. Alur ini juga tidak pernah merujuk pada konten di atas, di bawah, atau petunjuk visual lainnya. Tamu hanya mengonfirmasi permintaan yang diucapkan dan tidak pernah memberikan kolom permintaan internal. Jika permintaan tidak dapat divalidasi, asisten tetap memberikan penjelasan yang aman bagi tamu. Asisten dapat meminta detail yang kurang atau menawarkan layanan yang telah dikonfigurasi untuk hotel.

Uji permintaan suara tamu

1. Mulai sesi suara dengan reservasi pengujian masa menginap aktif yang telah diverifikasi.

2. Ajukan pertanyaan tentang masa menginap tersebut.

3. Minta layanan tamu, seperti handuk tambahan.

4. Dengarkan asisten mengulangi permintaan persis secara lisan.

5. Ucapkan “I confirm” atau “I confirm it” tanpa mengubah permintaan.

   ✓ Asisten menjawab dengan informasi masa menginap yang tersedia. ✓ Asisten mengulangi permintaan tanpa merujuk pada layar atau tampilan. ✓ Permintaan hanya dikirim setelah konfirmasi.

Minta layanan tanpa menyertakan semua detail yang diperlukan selama pengujian.

✓ Asisten menjelaskan informasi yang dibutuhkannya. ✓ Asisten dapat menawarkan layanan yang tersedia, bukan memberikan penolakan umum.

Gunakan reservasi pengujian sebelum check-in untuk memastikan nomor kamarnya tetap privat.

Tangani Fitur Pembantu Suara Opsional

Sidebar suara meminta topik yang disarankan kepada gateway.

Saat permintaan menyertakan ID file Vertex RAG, AVA membaca dokumen tersebut terlebih dahulu. Fitur pembantu suara opsional lainnya, seperti leksikon transkrip dan cakupan pengetahuan, menggunakan pola yang sama. Saat ID file tidak tersedia, AVA menggunakan penyimpanan vektor lama. Giliran audio eksplisit kini menunggu transkrip yang sudah final sebelum dapat memicu RAG. Hal ini mencegah panggilan alat yang tidak relevan saat mikrofon senyap atau tidak tersedia.

Hal ini membuat alur suara tetap berjalan alih-alih menampilkan kesalahan 502.

Yang Anda lihat: Daftar topik kosong atau tampak tidak diperbarui.

Perbaikan:

1. Biarkan sesi suara tetap terbuka dan lanjutkan percakapan
2. Muat ulang halaman jika Anda mengharapkan saran yang lebih baru
3. Pastikan dokumen chatbot terkait diberi status Active
4. Pastikan permintaan suara menyertakan ID file Vertex RAG
5. Pastikan gateway dapat menjangkau microservice chat

Apa yang berubah

Fitur pembantu suara kini tetap membiarkan alur berjalan saat terjadi kegagalan. Tamu tetap dapat melanjutkan, meskipun data fitur pembantu tidak tersedia.

Giliran audio tidak memicu balasan yang diharapkan

Yang Anda lihat: Tamu berbicara, tetapi asisten mengabaikan giliran tersebut atau menjawab terlambat.

Perbaikan:

1. Pastikan mikrofon berfungsi dan tidak dibisukan
2. Tunggu transkrip selesai sebelum menguji lagi
3. Mulai sesi suara baru jika giliran tersebut sudah tergantikan
4. Terapkan ulang voice gateway setelah perubahan runtime apa pun

Mengapa ini terjadi

Gateway menolak pemanggilan alat audio eksplisit sampai memiliki transkrip yang sudah final. Hal ini mencegah pencarian RAG yang tidak relevan dari giliran audio yang senyap atau belum lengkap.

Sesuaikan Waktu Respons Suara

Gunakan setelan gateway ini saat balasan suara terasa terlalu lambat atau macet di tengah respons.

Pengaturan	Yang Dikendalikan	Bawaan
VOICE_GATEWAY_RAG_REQUEST_TIMEOUT_MS	Waktu maksimum untuk satu permintaan RAG lengkap	60000
VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS	Waktu tunggu untuk potongan streaming pertama	30000
VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS	Waktu tunggu di antara potongan streaming	15000

Cara kerja timeout

• Balasan streaming menggunakan timeout potongan pertama terlebih dahulu.
• Setelah potongan pertama, idle timeout melindungi stream yang aktif.
• Balasan non-streaming hanya menggunakan timeout permintaan maksimum.
• Gateway menaikkan timeout permintaan maksimum bawaan menjadi 60 detik.

Kapan perlu menyesuaikannya

Yang Anda lihat: Asisten berhenti sebelum jawaban yang lambat selesai.

Perbaikan:

1. Naikkan VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS
2. Naikkan VOICE_GATEWAY_RAG_REQUEST_TIMEOUT_MS jika jawaban masih mengalami timeout
3. Naikkan VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS jika stream berhenti di antara potongan
4. Terapkan ulang voice gateway setelah mengubah nilai lingkungan

Yang Anda lihat: Balasan terus berjalan, tetapi tidak ada data yang masuk untuk sementara.

Perbaikan:

1. Turunkan VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS
2. Turunkan VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS
3. Pastikan timeout permintaan maksimum cukup tinggi untuk penyedia AI Anda

Pola Pesan yang Direkomendasikan

1. Buat Voice Welcome Message singkat dan natural
2. Buat Voice Default Answer sopan dan berorientasi pada tindakan
3. Gunakan Instruction untuk aturan yang stabil, bukan pengumuman sesaat

Contoh balasan cadangan yang baik

"Maaf, saya belum memiliki informasi itu saat ini. Silakan minta bantuan kepada tim resepsionis."

Pemecahan Masalah

Penyimpanan gagal dengan "Invalid content"

Yang Anda lihat: Anda mengeklik Save dan mendapatkan kesalahan validasi.

Perbaikan:

1. Pastikan kolom berisi teks biasa
2. Hapus blok teks yang sangat panjang
3. Coba simpan lagi

Balasan suara tidak sesuai dengan instruksi Anda

Yang Anda lihat: Tamu mendengar respons yang tidak mengikuti nada yang Anda harapkan.

Perbaikan:

1. Buka Instruction dan buat aturan lebih spesifik
2. Klik Save
3. Mulai sesi suara baru dan uji lagi

Halaman penyiapan suara tidak tersedia

Yang Anda lihat: Anda tidak dapat menemukan Voice Setup di sidebar.

Perbaikan:

1. Pastikan paket Anda mencakup alat AI chatbot
2. Pastikan peran Anda memiliki izin penyiapan chatbot
3. Muat ulang halaman setelah perubahan akses

Saran topik tampak kosong

Yang Anda lihat: Sidebar suara tidak menampilkan topik yang disarankan.

Perbaikan:

1. Lanjutkan menggunakan alur suara
2. Periksa apakah dokumen chatbot terkait masih berstatus Processing
3. Pastikan gateway dapat menjangkau microservice chat
4. Tinjau setelan topik yang di-cache jika daftar tetap tidak diperbarui

Permintaan layanan tamu tidak terkirim

Yang Anda lihat: Asisten mengulangi permintaan layanan tamu, tetapi tidak ada permintaan yang terkirim.

Perbaikan:

1. Jawab pertanyaan konfirmasi asisten dengan jelas.
2. Ulangi permintaan layanan tamu jika percakapan berganti topik.
3. Mulai sesi suara baru jika prompt konfirmasi sudah kedaluwarsa.
4. Hubungi dukungan jika permintaan yang sudah dikonfirmasi tetap tidak terkirim.

Asisten merujuk pada layar atau tampilan

Yang Anda lihat: Asisten menyebut sesuatu yang ditampilkan, diperlihatkan, di atas, atau di bawah.

Perbaikan:

1. Minta asisten mengulangi seluruh permintaan secara lisan.
2. Konfirmasikan hanya permintaan yang diucapkan ketika setiap detail sudah benar.
3. Hubungi dukungan jika asisten terus menggunakan rujukan visual.

Asisten tidak menerima konfirmasi yang diubah

Yang Anda lihat: Tamu mengonfirmasi, tetapi menambahkan waktu, jumlah, atau detail layanan yang berbeda.

Perbaikan:

1. Biarkan asisten menyiapkan permintaan yang diperbarui.
2. Tunggu asisten mengulangi seluruh permintaan.
3. Ucapkan “I confirm” atau “I confirm it” tanpa mengubah permintaan.

Asisten meminta detail permintaan tambahan

Yang Anda lihat: Asisten meminta informasi yang kurang atau menyarankan layanan yang tersedia.

Perbaikan:

Hal ini wajar jika permintaan housekeeping belum dapat divalidasi. Berikan detail yang diminta, lalu konfirmasikan permintaan lengkap tersebut.

Nomor kamar sebelum check-in diucapkan

Yang Anda lihat: Asisten mengucapkan nomor kamar sebelum tamu melakukan check-in.

Perbaikan:

1. Akhiri sesi suara.
2. Catat reservasi dan detail panggilan tamu.
3. Segera hubungi dukungan untuk ditinjau.

Masih Mengalami Kendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Penyimpanan terus gagal setelah beberapa kali mencoba
• ❌ Respons suara mengabaikan prompt yang sudah disimpan
• ❌ Balasan suara tetap mengalami timeout setelah setelan gateway disesuaikan
• ❌ Masalah berlanjut selama lebih dari 30 menit

Sebaiknya sertakan:

• Tangkapan layar halaman Voice Setup Anda
• Teks persis yang Anda coba simpan
• Nilai timeout yang sedang digunakan
• Waktu saat masalah mulai terjadi

Panduan Terkait

• Siapkan Chatbot Anda
• Kelola Dokumen Chatbot
• Buat Tautan Live Chat untuk Tamu