ข้ามไปยังเนื้อหาหลัก

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

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

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

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

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

ค่าเริ่มต้นขณะทำงาน

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

แพลตฟอร์ม Vertex AI

การตอบด้วยเสียงใช้แพลตฟอร์ม Vertex AI เดียวกับการตอบของ chatbot หากคำตอบเสียงดูไม่เป็นไปตามคาด ให้ตรวจสอบการตั้งค่าแพลตฟอร์มก่อน

ไปที่: 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เวลารอระหว่างชิ้นส่วนที่สตรีมสตรีมที่เสียจะล้มเหลวก่อนค้างอยู่ตลอด

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

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

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

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

ยืนยันข้อกำหนดต่อไปนี้:

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

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

  1. ไปที่ Chatbot → Voice Setup

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

  3. อัปเดต Voice Default Answer

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

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

ตั้งค่า Voice Instruction​

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

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

  3. คลิก Save

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

หากคำสั่งว่าง

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

ใช้ข้อมูลการเข้าพักและคำขอแม่บ้านของผู้เข้าพัก​

ผู้ช่วยเสียงสามารถใช้รายละเอียดการเข้าพักปัจจุบันที่ผ่านการตรวจสอบแล้วเพื่อตอบคำถามของผู้เข้าพัก สำหรับเซสชัน QR ห้องแบบคงที่ AVA จะรีเฟรชลิงก์ก่อนใช้งานเสียงเมื่อมีการเข้าพักปัจจุบัน ในโรงแรมที่ตรงกับห้องที่สแกนพอดีหนึ่งรายการ AVA ยังอนุญาตให้การเข้าพัก DUE_OUT แบบ native หนึ่งรายการตรงกันได้ เมื่อสัญญาความสามารถของ PMS รองรับสถานะดังกล่าว มิฉะนั้น การค้นหาด้วย QR ห้องแบบคงที่จะจับคู่เฉพาะการเข้าพัก CHECKED_IN เท่านั้น การค้นหาใช้ค่าห้องที่เข้ารหัสอยู่ใน QR แบบตรงตัว สำหรับเซสชัน QR ตำแหน่งแบบคงที่ AVA จะเก็บไว้เฉพาะบริบทของตำแหน่ง ระบบจะไม่ตรวจสอบการจอง ไม่เชื่อมโยงการเข้าพัก หรือเพิ่มข้อมูลวิดีโอจากการจอง นอกจากนี้ยังช่วยให้ผู้เข้าพักส่งคำขอบริการสำหรับผู้เข้าพักที่กำหนดค่าไว้ได้

คำขอของผู้เข้าพักพฤติกรรมของผู้ช่วยเสียง
ถามเกี่ยวกับการเข้าพักปัจจุบันใช้บริบทการจองที่ผ่านการตรวจสอบแล้วซึ่งมีให้สำหรับผู้เข้าพักนั้น
ขอใช้บริการสำหรับผู้เข้าพักทวนคำขอและขอให้ผู้เข้าพักยืนยันก่อนส่งคำขอ
คำขอไม่มีรายละเอียดที่จำเป็นอธิบายว่าข้อมูลใดขาดหายไปหรือเสนอรายการบริการที่มี
ถามเกี่ยวกับห้องก่อนเช็กอินไม่เปิดเผยหมายเลขห้องก่อนเช็กอินผ่านขั้นตอนเสียง
ใช้เซสชัน QR ตำแหน่งใช้บริบทตำแหน่งโดยไม่มีรายละเอียดการจอง
ต้องมีการยืนยัน

ระบบจะส่งหรือยกเลิกคำขอบริการสำหรับผู้เข้าพักเมื่อผู้เข้าพักยืนยันอย่างชัดเจนเท่านั้น หากบทสนทนาเปลี่ยนไป ผู้เข้าพักต้องยืนยันคำขออีกครั้ง หลังยืนยันแล้ว AVA จะส่งคำขอที่เตรียมไว้และผู้เข้าพักได้ตรวจสอบแล้ว ผู้เข้าพักเพียงยืนยันคำขอที่พูดออกมา และไม่ต้องระบุฟิลด์คำขอภายใน หากตรวจสอบคำขอไม่ได้ ผู้ช่วยจะยังคงใช้คำอธิบายที่ปลอดภัยสำหรับผู้เข้าพัก ผู้ช่วยสามารถขอรายละเอียดที่ขาดหายไปหรือเสนอบริการที่โรงแรมกำหนดค่าไว้ได้

ทดสอบคำขอเสียงของผู้เข้าพัก​

  1. เริ่มเซสชันเสียงด้วยการจองทดสอบการเข้าพักปัจจุบันที่ผ่านการตรวจสอบแล้ว

  2. ถามคำถามเกี่ยวกับการเข้าพัก

  3. ขอใช้บริการสำหรับผู้เข้าพัก เช่น ผ้าเช็ดตัวเพิ่ม

  4. ยืนยันคำขอเมื่อผู้ช่วยทวนคำขอ

    ✓ ผู้ช่วยตอบด้วยข้อมูลการเข้าพักที่มีอยู่ ✓ ระบบจะส่งคำขอหลังการยืนยันเท่านั้น

ระหว่างการทดสอบ ให้ขอใช้บริการโดยไม่ระบุรายละเอียดที่จำเป็นทั้งหมด

✓ ผู้ช่วยจะอธิบายว่าต้องการข้อมูลใด ✓ ผู้ช่วยสามารถเสนอบริการที่มี แทนการปฏิเสธแบบทั่วไป

ใช้การจองทดสอบก่อนเช็กอินเพื่อยืนยันว่าหมายเลขห้องจะยังคงเป็นข้อมูลส่วนตัว

จัดการตัวช่วยเสียงที่เป็นตัวเลือก​

แถบด้านข้างของเสียงจะขอหัวข้อแนะนำจาก 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 ได้
มีอะไรเปลี่ยนไป

ตอนนี้ตัวช่วยเสียงจะล้มเหลวแบบเปิดทางให้ดำเนินการต่อ ผู้เข้าพักยังคงสนทนาต่อได้ แม้ข้อมูลตัวช่วยจะใช้งานไม่ได้

รอบเสียงไม่ทริกเกอร์คำตอบที่คาดไว้​

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

วิธีแก้:

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

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

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

ใช้การตั้งค่า 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. ดีพลอย 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 สำหรับกฎที่คงที่ ไม่ใช่ประกาศครั้งเดียว
ตัวอย่างคำตอบสำรองที่ดี

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

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

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

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

วิธีแก้:

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

คำตอบเสียงไม่ตรงกับคำสั่งของคุณ​

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

วิธีแก้:

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

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

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

วิธีแก้:

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

คำแนะนำหัวข้อดูว่างเปล่า​

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

วิธีแก้:

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

ระบบไม่ส่งคำขอบริการสำหรับผู้เข้าพัก​

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

วิธีแก้:

  1. ตอบคำถามยืนยันของผู้ช่วยให้ชัดเจน
  2. ขอใช้บริการนั้นอีกครั้ง หากบทสนทนาเปลี่ยนหัวข้อ
  3. เริ่มเซสชันเสียงใหม่ หากคำขอยืนยันหมดอายุ
  4. ติดต่อฝ่ายสนับสนุน หากคำขอที่ยืนยันแล้วก็ยังไม่ถูกส่ง

ผู้ช่วยขอรายละเอียดคำขอเพิ่มเติม​

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

วิธีแก้:

กรณีนี้เป็นพฤติกรรมที่คาดไว้เมื่อยังตรวจสอบคำขอแม่บ้านไม่ได้ ระบุรายละเอียดที่ขอ แล้วจึงยืนยันคำขอที่ครบถ้วน

มีการพูดหมายเลขห้องก่อนเช็กอิน​

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

วิธีแก้:

  1. จบเซสชันเสียง
  2. บันทึกข้อมูลการจองและรายละเอียดการโทรของผู้เข้าพัก
  3. ติดต่อฝ่ายสนับสนุนทันทีเพื่อให้ตรวจสอบ

ยังแก้ปัญหาไม่ได้ใช่ไหม​

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

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

ข้อมูลที่ควรแนบ:

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