Docs Rivya AI

Hướng dẫn troubleshooting trong Rivya

Khắc phục vấn đề Rivya với gửi chat, uploads, generation tasks bị kẹt, missing results, payment updates, credits, history và notifications.

Đánh giá lần cuối vào 2026/04/28

Dùng hướng dẫn troubleshooting này khi chat, uploads, generation tasks, history, notifications, credits hoặc billing state trong Rivya không hoạt động như kỳ vọng.

Khi Rivya có vẻ bị lỗi, cách sửa nhanh nhất là quyết định lớp nào thật sự đang fail.

Phần lớn vấn đề rơi vào một trong năm nơi:

  • access và sign-in
  • model hoặc input mismatch
  • trạng thái tác vụ bất đồng bộ
  • wallet hoặc payment state
  • saved work lookup

Cách tách này hữu ích hơn nhiều so với xem mọi thứ như một "bug" chung chung.

1. Chat không gửi được

Nếu chat không thật sự chạy, hãy kiểm tra nguyên nhân đơn giản trước:

  • bạn có thể vẫn đang ở public landing flow và cần sign in trước khi gửi
  • draft message có thể đang trống
  • saved session có thể chưa load sạch

Nếu vấn đề nằm ở session cụ thể, hãy mở lại conversation từ Hướng dẫn History trong Rivya thay vì đoán bạn đang ở path nào.

Nếu tác vụ hẹp và lặp lại, restart từ một tool entry cũng có thể sạch hơn tiếp tục trong một plain-chat thread quá rộng.

2. Generation không bắt đầu

Nếu image, video hoặc audio generation fail trước khi thật sự bắt đầu, nguyên nhân thường là:

  • thiếu prompt content bắt buộc
  • dialogue-style audio form chưa hoàn chỉnh
  • model được chọn yêu cầu reference file nhưng chưa cung cấp
  • account không có đủ credits

Hiện tại, insufficient credits có thể làm run fail trước khi upstream service được gọi. Đó là lý do cảm giác "không có gì xảy ra" vẫn có thể để lại failed record thật và một notification.

3. Uploads fail

Uploads được điều khiển theo model, không phải theo category.

Điều đó có nghĩa là:

  • không phải mọi model trong cùng category đều nhận cùng reference kinds
  • không phải mọi model đều nhận cùng số lượng files
  • size và type limits được enforce trước generation request thật

Nếu upload fail, hãy kiểm tra:

  • model có hỗ trợ file kind đó không
  • bạn đã chạm current reference-file limit chưa
  • file type hoặc size có vi phạm upload rules hiện tại không

Nếu workflow là audio cleanup hoặc isolation, hãy nhớ uploaded-audio paths khác về cấu trúc so với prompt-first TTS hoặc voice generation.

4. Task kẹt in progress

Image, video và audio runs là async tasks trong Rivya.

Các trạng thái hiển thị là:

  • WAITING
  • GENERATING
  • SUCCESS
  • FAILED

Nếu một task có vẻ bị kẹt, đừng chỉ nhìn trang hiện tại.

Hãy kiểm tra cả các bề mặt này:

Một số tasks hoàn tất bằng callback, một số bằng polling hoặc refresh. Vì vậy "still generating" tự nó không có nghĩa là "lost". Thường là task vẫn đang chờ upstream result cuối cùng settle.

5. Task failed

Failure trong Rivya thường được lưu lại, không bị ẩn.

Một failed task có thể giữ:

  • chính failed status
  • error message
  • refund state, khi reserved credits nên được reverse
  • generation-failed notification

Vì vậy bước đúng tiếp theo thường là:

  1. đọc failure state
  2. quyết định vấn đề là credits, prompt hay input mismatch
  3. chỉ rerun sau khi sửa đúng nguyên nhân đó

Đừng xem mọi failure như một vấn đề UI tạm thời.

6. Result có vẻ biến mất

Thường thì result không biến mất. Nó chỉ nằm ở sai bề mặt.

Dùng Hướng dẫn History trong Rivya khi câu hỏi là:

Tôi đã tạo hoặc thảo luận điều gì?

Dùng Hướng dẫn trung tâm thông báo Rivya khi câu hỏi là:

Sự kiện account hoặc workflow quan trọng nào đã xảy ra?

Quy tắc rộng là:

  • chat quay về chat history
  • image, video và audio quay về generation history
  • billing và credit events thường rõ nhất trong notifications

7. Payment state trông cũ

Nếu checkout đã xong nhưng wallet hoặc billing state vẫn có vẻ stale, hãy đi theo billing path trước khi giả định payment đã mất.

Product flow hiện tại là:

  1. hoàn tất checkout
  2. quay lại qua /payment
  3. để sản phẩm poll và refresh billing hoặc wallet state
  4. kiểm tra /settings/billing hoặc /settings/credits

Notifications cũng có thể lưu billing outcomes, vì vậy đáng kiểm tra khi account state có vẻ out of sync.

8. Nên kiểm tra ở đâu trước

Dùng shortcut này:

Phần lớn nhầm lẫn đến từ việc kiểm tra sai lớp trước.

Đọc tiếp

Checklist triage troubleshooting

Chọn nơi kiểm tra đầu tiên trước khi lặp lại cùng một hành động:

  • Chat không gửi được: kiểm tra sign-in, session state, model availability và credit behavior.
  • Uploads fail: kiểm tra file type, size, model support và tác vụ có thật sự cần file không.
  • Generation bị kẹt: kiểm tra task status, provider callbacks, polling, history và notifications.
  • Billing trông stale: kiểm tra Checkout return, webhook settlement, billing settings và credits settings.
  • Results có vẻ missing: kiểm tra đúng history kind và task có thật sự completed không.

Kiểm tra lại trước khi escalate

Chỉ escalate sau khi bạn có thể gọi tên account area, task id hoặc payment context, expected result, actual result và last visible state. Điều đó biến support thành diagnosis thay vì guesswork.

Mục lục