Siapkan Prompt Asisten Suara

Penyiapan Cepat

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

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

Panduan ini juga menjelaskan bagaimana saran topik memakai Vertex RAG terlebih dahulu ketika file ID tersedia. Saat file ID tidak ada, helper tetap kembali ke retrieval lama. Anda juga dapat menyetel waktu respons suara. Gateway sekarang menunggu transkrip yang sudah final sebelum memakai turn audio eksplisit.

Default saat runtime

Jika OPENAI_REALTIME_MODEL tidak diatur, AVA memakai gpt-realtime-2.1-mini. Set variabel itu secara eksplisit jika tim Anda ingin model Realtime yang berbeda.

Platform Vertex AI

Balasan suara memakai platform Vertex AI yang sama dengan balasan chatbot. Jika jawaban suara terasa tidak sesuai, periksa dulu setelan platform.

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 mendapat respons yang sopan
Instruction	Panduan nada dan perilaku untuk AI suara	Balasan sesuai gaya komunikasi hotel Anda
Topic Suggestions	Prompt sidebar untuk pertanyaan umum tamu	Tamu melihat saran Vertex RAG atau topik cadangan lama
RAG Request Timeout	Batas waktu maksimum menunggu jawaban suara	Balasan lambat tetap berjalan sampai batas maksimum
First Chunk Timeout	Waktu tunggu untuk potongan jawaban streaming pertama	Jeda panjang menghentikan balasan AI yang macet lebih cepat
Stream Idle Timeout	Waktu tunggu antar 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 bisa menyimpan setelan suara.

Untuk upgrade, buka Settings → Billing & Subscription.

Sebelum Mulai

Pastikan persyaratan berikut terpenuhi:

• Anda punya izin untuk mengelola penyiapan chatbot
• Paket Anda mencakup fitur AI chatbot
• Anda tahu sapaan dan teks balasan cadangan yang ingin dipakai
• Tim teknis Anda tahu 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 berikutnya.

Jika instruksi kosong

Menyimpan instruksi kosong akan menerapkan instruksi suara ramah bawaan.

Tangani Helper Suara Opsional

Sidebar suara meminta gateway untuk topik yang disarankan.

Saat request menyertakan file ID Vertex RAG, AVA membaca dokumen itu terlebih dahulu. Helper suara opsional lain, seperti transcript lexicon dan knowledge coverage, memakai pola yang sama. Saat file ID tidak ada, AVA memakai legacy vector store. Turn audio eksplisit kini menunggu transkrip yang sudah final sebelum bisa memicu RAG. Ini mencegah panggilan tool yang tidak relevan saat mikrofon senyap atau tidak tersedia.

Hal ini menjaga alur suara tetap bergerak alih-alih menampilkan error 502.

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

Perbaikan:

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

Apa yang berubah

Helper suara sekarang gagal secara terbuka. Tamu tetap bisa melanjutkan, meskipun data helper tidak tersedia.

Turn audio tidak memicu balasan yang diharapkan

Yang Anda lihat: Tamu berbicara, tetapi asisten mengabaikan turn itu atau menjawab terlambat.

Perbaikan:

1. Pastikan mikrofon berfungsi dan tidak dimute
2. Tunggu transkrip selesai sebelum menguji lagi
3. Mulai sesi suara baru jika turn sebelumnya sudah tergantikan
4. Redeploy voice gateway setelah perubahan runtime apa pun

Mengapa ini terjadi

Gateway menolak panggilan tool audio eksplisit sampai ia memiliki transkrip yang sudah final. Ini mencegah lookup RAG yang tidak relevan dari turn audio yang senyap atau belum lengkap.

Sesuaikan Timing Respons Suara

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

Pengaturan	Yang Dikendalikan	Default
VOICE_GATEWAY_RAG_REQUEST_TIMEOUT_MS	Waktu maksimum untuk satu request RAG penuh	60000
VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS	Waktu tunggu untuk potongan streaming pertama	30000
VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS	Waktu tunggu antar potongan streaming	15000

Cara kerja timeout

• Balasan streaming memakai timeout first-chunk terlebih dahulu.
• Setelah potongan pertama, idle timeout melindungi stream yang aktif.
• Balasan non-streaming hanya memakai timeout request maksimum.
• Gateway menaikkan default timeout request maksimum 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 time out
3. Naikkan VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS jika stream berhenti di antara chunk
4. Redeploy voice gateway setelah mengubah nilai environment

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. Biarkan timeout request maksimum tetap cukup tinggi untuk provider AI Anda

Pola Pesan yang Direkomendasikan

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

Contoh balasan cadangan yang baik

"Maaf, saya belum punya informasi itu saat ini. Silakan hubungi tim front desk untuk bantuan."

Pemecahan Masalah

Penyimpanan gagal dengan "Invalid content"

Yang Anda lihat: Anda klik Save dan mendapat error validasi.

Perbaikan:

1. Pastikan field berisi teks biasa
2. Hapus blok teks yang terlalu panjang
3. Coba simpan lagi

Balasan suara tidak sesuai instruksi

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 hilang

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

Perbaikan:

1. Pastikan paket Anda mencakup alat AI chatbot
2. Pastikan peran Anda punya izin penyiapan chatbot
3. Refresh halaman setelah akses berubah

Saran topik tampak kosong

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

Perbaikan:

1. Lanjutkan memakai alur suara
2. Periksa apakah dokumen chatbot terkait masih Processing
3. Pastikan gateway bisa menjangkau microservice chat
4. Tinjau setelan topik cached jika daftar tetap tidak berubah

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Penyimpanan terus gagal setelah beberapa percobaan
• ❌ Balasan suara mengabaikan prompt yang sudah disimpan
• ❌ Balasan suara masih time out setelah setelan gateway disesuaikan
• ❌ Masalah berlanjut lebih dari 30 menit

Informasi yang membantu untuk disertakan:

• Screenshot halaman Voice Setup Anda
• Teks persis yang coba Anda simpan
• Nilai timeout yang sedang dipakai
• Waktu masalah mulai terjadi

Panduan Terkait

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