Documentazione Rivya AI

Guida Rivya alla risoluzione dei problemi

Risolvi problemi Rivya con invio chat, caricamenti, attività di generazione bloccate, risultati mancanti, aggiornamenti pagamento, crediti, cronologia e notifiche.

Ultima revisione il 2026/04/28

Usa questa guida alla risoluzione dei problemi quando chat, caricamenti, attività di generazione, cronologia, notifiche, crediti o stato di fatturazione in Rivya non si comportano come previsto.

Quando Rivya sembra rotto, la correzione più rapida è decidere quale livello sta davvero fallendo.

La maggior parte dei problemi finisce in uno di cinque posti:

  • accesso e autenticazione
  • disallineamento di modello o input
  • stato attività asincrona
  • stato wallet o pagamento
  • ricerca del lavoro salvato

Questa divisione è molto più utile che trattare tutto come un generico "bug."

1. La chat non invia

Se la chat non parte davvero, controlla prima le cause semplici:

  • potresti essere ancora in un flusso pubblico di landing e dover accedere prima di inviare
  • il messaggio bozza potrebbe essere vuoto
  • la sessione salvata potrebbe non essersi caricata correttamente

Se il problema è specifico della sessione, riapri la conversazione da Cronologia invece di indovinare in quale percorso eri.

Se l'attività è stretta e ripetitiva, può anche essere più pulito ripartire da un ingresso strumento invece di continuare in un thread ampio di chat semplice.

2. Una generazione non parte

Se la generazione immagine, video o audio fallisce prima di iniziare davvero, le cause usuali sono:

  • manca contenuto prompt richiesto
  • un form audio in stile dialogo è incompleto
  • il modello selezionato richiede un file di riferimento e non ne è stato fornito nessuno
  • l'account non ha abbastanza crediti

In questo momento, crediti insufficienti possono far fallire l'esecuzione prima che il servizio a monte venga mai chiamato. Ecco perché la sensazione di "non è successo niente" può comunque lasciare un vero record fallito e una notifica.

3. I caricamenti falliscono

I caricamenti sono guidati dal modello, non dalla categoria.

Questo significa:

  • non tutti i modelli in una categoria accettano gli stessi tipi di riferimento
  • non tutti i modelli accettano lo stesso numero di file
  • limiti di dimensione e tipo vengono applicati prima della richiesta di generazione reale

Se un caricamento fallisce, controlla:

  • se il modello supporta davvero quel tipo di file
  • se hai già raggiunto il limite attuale di file di riferimento
  • se tipo o dimensione del file violano le regole di caricamento attuali

Se il flusso di lavoro è pulizia o isolamento audio, ricorda che i percorsi con audio caricato sono strutturalmente diversi da TTS o generazione vocale guidati prima dal prompt.

4. Attività bloccata in corso

Le esecuzioni immagine, video e audio sono attività asincrone in Rivya.

Gli stati visibili sono:

  • WAITING
  • GENERATING
  • SUCCESS
  • FAILED

Se un'attività sembra bloccata, non guardare solo la pagina corrente.

Controlla anche queste superfici:

Alcune attività finiscono via callback, altre via polling o aggiornamento. Quindi "ancora in generazione" non significa da solo "persa." Spesso significa che l'attività sta ancora aspettando che il risultato finale a monte si stabilizzi.

5. Un'attività è fallita

Il fallimento in Rivya di solito viene conservato, non nascosto.

Un'attività fallita può mantenere:

  • lo stato fallito stesso
  • un messaggio di errore
  • stato di rimborso, quando i crediti prenotati dovrebbero essere stornati
  • una notifica di generazione fallita

Questo significa che il passo successivo giusto di solito è:

  1. leggere lo stato di fallimento
  2. decidere se il problema erano crediti, prompt o disallineamento di input
  3. rieseguire solo dopo aver corretto quella causa specifica

Non trattare ogni fallimento come un problema UI transitorio.

6. Il risultato sembra sparito

Di solito il risultato non è sparito. È solo sulla superficie sbagliata.

Usa Cronologia quando la domanda è:

Che cosa ho creato o discusso?

Usa Centro notifiche quando la domanda è:

Quale evento importante di account o flusso di lavoro è avvenuto?

La regola generale è:

  • la chat torna alla cronologia chat
  • immagini, video e audio tornano alla cronologia generazioni
  • eventi di fatturazione e crediti spesso sono più chiari nelle notifiche

7. Lo stato del pagamento sembra vecchio

Se il checkout è terminato ma lo stato wallet o fatturazione sembra ancora obsoleto, segui il percorso di fatturazione prima di presumere che il pagamento sia perso.

Il flusso prodotto attuale è:

  1. completa il checkout
  2. torna tramite /payment
  3. lascia che il prodotto faccia polling e aggiorni stato di fatturazione o wallet
  4. controlla /settings/billing o /settings/credits

Anche le notifiche possono conservare gli esiti di fatturazione, quindi vale la pena controllarle quando lo stato account sembra non sincronizzato.

8. Dove controllare prima

Usa questa scorciatoia:

  • Studio attuale: lavoro in tempo reale in corso
  • Cronologia: output salvati e conversazioni salvate
  • Centro notifiche: eventi operativi già avvenuti
  • /settings/billing: stato abbonamento
  • /settings/credits: saldo wallet, pacchetti, scadenza e transazioni

La maggior parte della confusione deriva dal controllare prima il livello sbagliato.

Leggi dopo

Lista di controllo di triage per la risoluzione dei problemi

Scegli il primo posto da controllare prima di ripetere la stessa azione:

  • La chat non invia: controlla accesso, stato sessione, disponibilità modello e comportamento crediti.
  • I caricamenti falliscono: controlla tipo file, dimensione, supporto modello e se l'attività ha davvero bisogno di un file.
  • La generazione è bloccata: controlla stato attività, callback provider, polling, cronologia e notifiche.
  • La fatturazione sembra vecchia: controlla ritorno dal Checkout, regolazione webhook, impostazioni fatturazione e impostazioni crediti.
  • I risultati sembrano mancanti: controlla il tipo corretto di cronologia e se l'attività è davvero completata.

Ricontrolla prima di segnalare

Segnala solo dopo che puoi indicare area account, task id o contesto pagamento, risultato atteso, risultato effettivo e ultimo stato visibile. Questo trasforma il supporto in diagnosi invece che in supposizioni.

Indice