คู่มือ Troubleshooting ของ Rivya

ใช้คู่มือ troubleshooting นี้เมื่อ Rivya chat, uploads, generation tasks, history, notifications, credits หรือ billing state ทำงานไม่ตรงตามที่คาด

เมื่อ Rivya ดูเหมือนมีปัญหา วิธีแก้ที่เร็วที่สุดคือระบุให้ได้ว่า layer ใดกำลัง fail จริง

ปัญหาส่วนใหญ่จะอยู่ในหนึ่งในห้าจุดนี้:

• access และ sign-in
• model หรือ input mismatch
• สถานะงาน async
• wallet หรือ payment state
• การค้นหางานที่บันทึกไว้

การแยกแบบนี้มีประโยชน์กว่าการมองทุกอย่างเป็น "bug" ทั่วไปมาก

1. Chat ส่งไม่ได้

หาก chat ไม่ run จริง ให้ตรวจสาเหตุง่าย ๆ ก่อน:

• คุณอาจยังอยู่ใน public landing flow และต้อง sign in ก่อนส่ง
• draft message อาจว่างอยู่
• saved session อาจ load ไม่เรียบร้อย

หากปัญหาเฉพาะกับ session ให้เปิด conversation ใหม่จาก History แทนการเดาว่าคุณเคยอยู่ path ไหน

หาก task แคบและซ้ำ ๆ การ restart จาก tool entry อาจสะอาดกว่าการทำต่อใน plain-chat thread ที่กว้างเกินไป

2. Generation เริ่มไม่ได้

หาก image, video หรือ audio generation fail ก่อนเริ่มจริง สาเหตุทั่วไปคือ:

• prompt content ที่จำเป็นหายไป
• dialogue-style audio form ยังไม่ complete
• selected model ต้องใช้ reference file แต่ไม่ได้ใส่
• account มี credits ไม่พอ

ตอนนี้ insufficient credits สามารถทำให้ run fail ก่อน upstream service ถูกเรียกจริง นั่นคือเหตุผลที่ความรู้สึกว่า "ไม่มีอะไรเกิดขึ้น" ยังอาจทิ้ง failed record และ notification จริงไว้ได้

3. Uploads Fail

uploads ขับเคลื่อนตาม model ไม่ใช่ตาม category

หมายความว่า:

• ไม่ใช่ทุก model ใน category เดียวกันที่รับ reference kinds เดียวกัน
• ไม่ใช่ทุก model ที่รับจำนวน files เท่ากัน
• size และ type limits ถูก enforce ก่อน generation request จริง

หาก upload fail ให้ตรวจว่า:

• model รองรับ file kind นั้นหรือไม่
• คุณชน current reference-file limit แล้วหรือยัง
• file type หรือ size ผิด upload rules ปัจจุบันหรือไม่

หาก workflow เป็น audio cleanup หรือ isolation ให้จำไว้ว่า uploaded-audio paths ต่างทางโครงสร้างจาก prompt-first TTS หรือ voice generation

4. Task ค้าง In Progress

image, video และ audio runs เป็น async tasks ใน Rivya

สถานะที่มองเห็นได้คือ:

• WAITING
• GENERATING
• SUCCESS
• FAILED

หาก task ดูค้าง อย่าดูเฉพาะหน้าปัจจุบัน

ให้ตรวจ surfaces เหล่านี้ด้วย:

• Studio ที่ใช้งานอยู่
• History
• Notifications Center
• /dashboard recent generations

บาง tasks จบด้วย callback บาง tasks จบด้วย polling หรือ refresh ดังนั้น "still generating" ไม่ได้แปลว่า "lost" เสมอไป บ่อยครั้งหมายถึง task ยังรอ final upstream result ให้ settle

5. Task Failed

failure ใน Rivya มักถูกเก็บไว้ ไม่ใช่ถูกซ่อน

failed task อาจเก็บ:

• failed status เอง
• ข้อความ error
• refund state เมื่อ reserved credits ควรถูก reverse
• การแจ้งเตือน generation-failed

ดังนั้น next step ที่ถูกต้องมักเป็น:

1. อ่าน failure state
2. ตัดสินใจว่าปัญหาเกิดจาก credits, prompt หรือ input mismatch
3. rerun หลังแก้สาเหตุเฉพาะนั้นแล้วเท่านั้น

อย่ามองทุก failure เป็น transient UI issue

6. Result ดูเหมือนหายไป

โดยปกติ result ไม่ได้หายไป แค่อยู่ผิด surface

ใช้ History เมื่อคำถามคือ:

ใช้ Notifications Center เมื่อคำถามคือ:

กฎกว้าง ๆ คือ:

• chat กลับไปที่ chat history
• image, video และ audio กลับไปที่ generation history
• billing และ credit events มักเห็นชัดที่สุดใน notifications

7. Payment State ดูเก่า

หาก checkout เสร็จแล้ว แต่ wallet หรือ billing state ยังดู stale ให้ตาม billing path ก่อน อย่าเพิ่งสรุปว่า payment lost

product flow ปัจจุบันคือ:

1. ทำ checkout ให้เสร็จ
2. return ผ่าน /payment
3. ให้ product poll และ refresh billing หรือ wallet state
4. ตรวจ /settings/billing หรือ /settings/credits

Notifications สามารถเก็บ billing outcomes ได้ด้วย จึงควรตรวจเมื่อ account state ดู out of sync

8. ควรตรวจที่ไหนก่อน

ใช้ shortcut นี้:

• Studio ปัจจุบัน: งานที่กำลังทำอยู่แบบ live
• History: saved outputs และ saved conversations
• Notifications Center: operational events ที่เกิดขึ้นแล้ว
• /settings/billing: subscription state
• /settings/credits: wallet balance, packs, expiry และ transactions

ความสับสนส่วนใหญ่มาจากการตรวจผิด layer ตั้งแต่แรก

อ่านต่อ

• Task Lifecycle ใน Rivya
• Image Workflows ใน Rivya
• Video Workflows ใน Rivya
• Audio Workflows ใน Rivya
• References and Uploads ใน Rivya
• Credits & Billing ใน Rivya
• Payment Checkout ใน Rivya

เช็กลิสต์ Triage สำหรับ Troubleshooting

เลือกจุดแรกที่จะตรวจก่อนทำ action เดิมซ้ำ:

• Chat ส่งไม่ได้: ตรวจ sign-in, session state, model availability และ credit behavior
• Uploads fail: ตรวจ file type, size, model support และ task ต้องใช้ file จริงหรือไม่
• Generation ค้าง: ตรวจ task status, provider callbacks, polling, history และ notifications
• Billing ดู stale: ตรวจ Checkout return, webhook settlement, billing settings และ credits settings
• Results ดูเหมือนหาย: ตรวจ history kind ที่ถูกต้อง และ task completed จริงหรือไม่

ตรวจซ้ำก่อน Escalating

Escalate เฉพาะเมื่อคุณระบุ account area, task id หรือ payment context, expected result, actual result และ last visible state ได้แล้ว สิ่งนี้เปลี่ยน support ให้เป็น diagnosis แทน guesswork