ตั้งค่าพรอมป์ต์ผู้ช่วยเสียง

ตั้งค่าแบบเร็ว

ตั้งค่าข้อความต้อนรับ คำตอบ fallback และ instruction ได้ในประมาณ 5 นาที

คู่มือนี้ช่วยให้คุณควบคุมสิ่งที่ผู้เข้าพักได้ยินเมื่อใช้ผู้ช่วยเสียง

นอกจากนี้ยังอธิบายว่า topic suggestions ใช้ Vertex RAG ก่อนเมื่อมี file IDs เมื่อไม่มี file IDs ผู้ช่วยจะย้อนกลับไปใช้ legacy retrieval คุณยังปรับจังหวะการตอบของเสียงได้ ตอนนี้ gateway จะรอ transcript ที่ finalize แล้วก่อนใช้ explicit audio turns

Runtime default

หาก OPENAI_REALTIME_MODEL ไม่ได้ตั้งค่า AVA จะใช้ gpt-realtime-2.1-mini ตั้งค่าให้ชัดเจนถ้าทีมของคุณต้องการ Realtime model อื่น

Vertex AI platform

การตอบเสียงใช้ Vertex AI platform เดียวกับการตอบ chatbot หากคำตอบเสียงดูผิดปกติ ให้ยืนยันการตั้งค่า platform ก่อน

ไปที่: Chatbot → Voice Setup

อ้างอิงด่วน

การตั้งค่า	ควบคุมอะไร	ผลลัพธ์สำหรับผู้เข้าพัก
Voice Welcome Message	ข้อความพูดครั้งแรกในเซสชันเสียง	ผู้เข้าพักได้ยินคำทักทายของโรงแรมอย่างชัดเจน
Voice Default Answer	คำตอบเมื่อไม่มีคำตอบที่เชื่อถือได้	ผู้เข้าพักยังได้รับคำตอบที่สุภาพ
Instruction	แนวทางโทนและพฤติกรรมของ AI เสียง	คำตอบสอดคล้องกับสไตล์การสื่อสารของโรงแรม
Topic Suggestions	ข้อเสนอหัวข้อในแถบข้างสำหรับคำถามที่พบบ่อย	ผู้เข้าพักเห็นคำแนะนำจาก Vertex RAG หรือหัวข้อสำรองแบบเดิม
RAG Request Timeout	เวลารอสูงสุดสำหรับคำตอบเสียง	คำตอบที่ช้ายังคงทำงานต่อจนถึงขีดจำกัดสูงสุด
First Chunk Timeout	เวลารอชิ้นส่วนคำตอบสตรีมชิ้นแรก	ช่วยหยุดคำตอบ AI ที่ค้างนานได้เร็วขึ้น
Stream Idle Timeout	เวลารอระหว่างชิ้นส่วนที่สตรีม	สตรีมที่เสียจะล้มเหลวก่อนค้างค้างอยู่ตลอด

สิทธิ์แพ็กเกจ

• การตั้งค่า Voice ต้องใช้แพ็กเกจแบบชำระเงิน
• บัญชีแพ็กเกจฟรีจะแสดงข้อความให้อัปเกรดและไม่สามารถบันทึกการตั้งค่าเสียงได้

หากต้องการอัปเกรด ให้ไปที่ Settings → Billing & Subscription

ก่อนเริ่มต้น

ยืนยันเงื่อนไขต่อไปนี้:

• คุณมีสิทธิ์จัดการการตั้งค่า chatbot
• แพ็กเกจของคุณมีฟีเจอร์ AI chatbot
• คุณรู้คำทักทายและคำตอบ fallback ที่ต้องการใช้
• ทีมเทคนิคของคุณทราบค่าหมดเวลาปัจจุบันของ voice gateway

ตั้งค่าข้อความเสียง

1. ไปที่ Chatbot → Voice Setup

2. ใน Voice Messages อัปเดต Voice Welcome Message

3. อัปเดต Voice Default Answer

4. คลิก Save ในแต่ละการ์ด

   ✓ จะมีข้อความสำเร็จแสดงขึ้น ✓ เวลาที่บันทึกจะแสดงถัดจากปุ่ม

ตั้งค่า Voice Instruction

1. ที่หน้าเดียวกัน หา Voice Instruction

2. อธิบายโทน กฎการใช้ถ้อยคำ และพฤติกรรม fallback

3. คลิก Save

   ✓ ระบบจะบันทึก instruction ไว้สำหรับคำตอบเสียงในอนาคต

หาก instruction ว่าง

การบันทึก instruction ที่ว่างจะใช้คำสั่งเสียงแบบเป็นมิตรค่าเริ่มต้นแทน

จัดการผู้ช่วยเสียงเพิ่มเติม

แถบด้านข้างของเสียงจะขอหัวข้อแนะนำจาก gateway

เมื่อคำขอมี Vertex RAG file IDs AVA จะอ่านเอกสารเหล่านั้นก่อน ผู้ช่วยเสียงเพิ่มเติมอื่น ๆ เช่น transcript lexicon และ knowledge coverage ใช้รูปแบบเดียวกัน เมื่อไม่มี file IDs AVA จะใช้ legacy vector store แทน ตอนนี้ explicit audio turns ต้องรอ transcript ที่ finalize แล้วก่อนจึงจะทริกเกอร์ RAG ได้ วิธีนี้ช่วยป้องกันไม่ให้มีการเรียกเครื่องมือที่ไม่เกี่ยวข้องเมื่อไมโครโฟนเงียบหรือใช้งานไม่ได้

วิธีนี้ทำให้ flow เสียงยังเดินต่อ แทนที่จะขึ้นข้อผิดพลาด 502

สิ่งที่เห็น: รายการหัวข้อว่างหรือดูเหมือนข้อมูลเก่า

วิธีแก้:

1. คงเซสชันเสียงไว้และสนทนาต่อ
2. รีเฟรชหน้า หากคุณคาดว่าคำแนะนำล่าสุดควรปรากฏ
3. ยืนยันว่าเอกสาร chatbot ที่เกี่ยวข้องถูกทำเครื่องหมายเป็น Active
4. ยืนยันว่าคำขอเสียงมี Vertex RAG file IDs
5. ยืนยันว่า gateway เข้าถึง chat microservice ได้

อะไรเปลี่ยนไป

ผู้ช่วยเสียงตอนนี้ fail open ผู้เข้าพักยังคงสนทนาต่อได้ แม้ข้อมูล helper จะใช้งานไม่ได้

audio turns ไม่กระตุ้นคำตอบที่คาดไว้

สิ่งที่เห็น: ผู้เข้าพักพูดแล้ว แต่ผู้ช่วยไม่ตอบตามรอบนั้นหรือใช้เวลาตอบนาน

วิธีแก้:

1. ยืนยันว่าไมโครโฟนทำงานและไม่ได้ปิดเสียง
2. รอให้ transcript finalize ก่อนทดสอบอีกครั้ง
3. เริ่มเซสชันเสียงใหม่ หากรอบนั้นถูกแทนที่แล้ว
4. deploy voice gateway ใหม่หลังเปลี่ยน runtime ใด ๆ

เหตุผลที่เกิดขึ้น

gateway จะปฏิเสธ explicit audio tool calls จนกว่าจะมี transcript ที่ finalize แล้ว วิธีนี้ช่วยหลีกเลี่ยงการ lookup RAG ที่ไม่เกี่ยวข้องจาก audio turn ที่เงียบหรือไม่สมบูรณ์

ปรับจังหวะการตอบเสียง

ใช้การตั้งค่า gateway เหล่านี้เมื่อคำตอบเสียงช้าเกินไปหรือค้างกลางทาง

การตั้งค่า	ควบคุมอะไร	ค่าเริ่มต้น
VOICE_GATEWAY_RAG_REQUEST_TIMEOUT_MS	เวลาสูงสุดสำหรับคำขอ RAG แบบเต็ม	60000
VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS	เวลารอชิ้นส่วนแรกของสตรีม	30000
VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS	เวลารอระหว่างชิ้นส่วนที่สตรีม	15000

วิธีการทำงานของ timeout

• คำตอบแบบสตรีมจะใช้ timeout ของชิ้นแรกก่อน
• หลังจากชิ้นแรกแล้ว idle timeout จะคุมสตรีมที่กำลังทำงาน
• คำตอบแบบไม่สตรีมจะใช้เฉพาะ max request timeout
• gateway จะเพิ่ม default max request timeout เป็น 60 วินาที

เมื่อใดควรปรับ

สิ่งที่เห็น: ผู้ช่วยหยุดก่อนคำตอบที่ช้าจะจบ

วิธีแก้:

1. เพิ่ม VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS
2. เพิ่ม VOICE_GATEWAY_RAG_REQUEST_TIMEOUT_MS หากคำตอบยัง timeout
3. เพิ่ม VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS หากสตรีมหยุดระหว่างชิ้นส่วน
4. deploy voice gateway ใหม่หลังเปลี่ยนค่า environment

สิ่งที่เห็น: คำตอบยังทำงานต่อ แต่ไม่มีอะไรออกมาสักพัก

วิธีแก้:

1. ลด VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS
2. ลด VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS
3. คง max request timeout ให้นานพอสำหรับผู้ให้บริการ AI ของคุณ

รูปแบบข้อความที่แนะนำ

1. ทำให้ Voice Welcome Message สั้นและเป็นธรรมชาติ
2. ทำให้ Voice Default Answer สุภาพและเน้นการดำเนินการ
3. ใช้ Instruction สำหรับกฎที่คงที่ ไม่ใช่ประกาศครั้งเดียว

ตัวอย่าง default answer ที่ดี

"ขออภัย ตอนนี้ฉันยังไม่มีข้อมูลนั้น กรุณาติดต่อทีมฟรอนต์เดสก์เพื่อขอความช่วยเหลือ"

การแก้ไขปัญหา

บันทึกไม่ผ่านพร้อมข้อความ "Invalid content"

สิ่งที่เห็น: คุณคลิก Save แล้วได้ข้อความผิดพลาดจากการตรวจสอบ

วิธีแก้:

1. ยืนยันว่าฟิลด์เป็นข้อความธรรมดา
2. ลบข้อความที่ยาวมากออก
3. ลองบันทึกอีกครั้ง

คำตอบเสียงไม่ตรงกับ instruction

สิ่งที่เห็น: ผู้เข้าพักได้ยินคำตอบที่ไม่เป็นไปตามโทนที่คาดไว้

วิธีแก้:

1. เปิด Instruction และเขียนกฎให้เฉพาะเจาะจงขึ้น
2. คลิก Save
3. เริ่มเซสชันเสียงใหม่แล้วทดสอบอีกครั้ง

หน้าตั้งค่า Voice หายไป

สิ่งที่เห็น: คุณหา Voice Setup ไม่เจอในแถบด้านข้าง

วิธีแก้:

1. ยืนยันว่าแพ็กเกจของคุณมีเครื่องมือ AI chatbot
2. ยืนยันว่า role ของคุณมีสิทธิ์ตั้งค่า chatbot
3. รีเฟรชหน้าหลังมีการเปลี่ยนสิทธิ์

Topic suggestions ดูว่างเปล่า

สิ่งที่เห็น: แถบด้านข้างของเสียงไม่มีหัวข้อแนะนำ

วิธีแก้:

1. ใช้ flow เสียงต่อไป
2. ตรวจว่าเอกสาร chatbot ที่เกี่ยวข้องยังอยู่ในสถานะ Processing
3. ยืนยันว่า gateway เข้าถึง chat microservice ได้
4. ตรวจการตั้งค่า topic ที่แคชไว้ หากรายการยังดูเก่า

ยังติดปัญหาอยู่?

ติดต่อ success@vouch-technologies.com หาก:

• ❌ บันทึกยังล้มเหลวหลังลองใหม่
• ❌ คำตอบเสียงไม่สนใจพรอมป์ต์ที่บันทึกไว้
• ❌ คำตอบเสียงยัง timeout หลังปรับการตั้งค่า gateway
• ❌ ปัญหายังคงอยู่เกิน 30 นาที

ข้อมูลที่ช่วยได้:

• ภาพหน้าจอหน้า Voice Setup
• ข้อความที่คุณพยายามบันทึกแบบตรงตัว
• ค่า timeout ที่ใช้อยู่ตอนนั้น
• เวลาที่เริ่มเกิดปัญหา

คู่มือที่เกี่ยวข้อง

• Set Up Your Chatbot
• Manage Chatbot Documents
• Create a Live Chat Link for Guests