Értsd meg a Rivya feladatállapotait, kreditfoglalását, szolgáltatói beküldését, callbackjeit, pollingját, előzményeit, értesítéseit, hibáit és kreditkezelését.

Akkor használd ezt az útmutatót, amikor meg kell értened, mi történik egy kép-, videó- vagy hanggenerálási feladat beküldése után a Rivyában.

Egy helyen magyarázza el a feladatállapotokat, a kreditfoglalást, a szolgáltatói befejezést, az előzményeket, az értesítéseket és a sikertelen feladatok kezelését.

A valódi feladatállapotok

A jelenlegi aszinkron generálási életciklus négy látható állapotot használ:

WAITING
GENERATING
SUCCESS
FAILED

Ezek az állapotok az ai_task rekordban tárolódnak, és a Studio, az előzmények, a dashboard és az értesítési folyamat is újrahasználja őket.

Mi történik beküldéskor

1. A Rivya ellenőrzi a kérést

Mielőtt bármi eljutna egy szolgáltatóhoz, a Rivya ellenőrzi:

létezik-e a modell
engedélyezett-e a közvetlen generálás ennél a modellnél
az adott futtatási mód aszinkron feladatokra épül-e
érvényes-e a prompt hossza
normalizálva vannak-e az űrlapparaméterek
a referenciafájlok megfelelnek-e annak, amit a modell elfogad

Egyes modelleknek további szabályaik vannak. Például a hangizoláláshoz feltöltött hangfájl és időtartam-ellenőrzés is kell.

2. A Rivya létrehozza a feladatrekordot

A Rivya először létrehoz egy ai_task bejegyzést WAITING állapottal.

Ez a rekord tárolja a modellt, a kategóriát, a promptot, a paramétereket, a lefoglalt krediteket, a számlázási típust, majd később az eredményt vagy a hibaállapotot.

3. A kreditek a szolgáltatói beküldés előtt fogyasztódnak el

Ez fontos: aszinkron generálásnál a Rivya még azelőtt elköltöttnek tekinti a feladat kreditjeit, hogy a munkát elküldené a felsőbb szolgáltatásnak.

Ha túl kevés a kredit:

a feladat sikertelenként lesz megjelölve
a felsőbb szolgáltatás soha nem kap hívást
létrejöhet egy elégtelen kreditről szóló értesítés

4. Létrejön a szolgáltatói feladat

Ha rendelkezésre állnak a kreditek, a Rivya beküldi a feladatot a megfelelő felsőbb szolgáltatásnak, és eltárolja a szolgáltatói feladatazonosítót.

Ekkor az állapot GENERATING értékre vált.

Hogyan tudja meg a Rivya az eredményt

A Rivya két befejezési útvonalat támogat:

szolgáltatói callback olyan környezetekben, ahol a callback engedélyezett
állapotfrissítés és polling, amikor callbackes befejezés nem érhető el

A callbackes útvonal a feladat véglegesítése előtt a webhook aláírását is ellenőrzi.

Ha a callback azelőtt érkezik meg, hogy a szolgáltatói eredmény teljesen kész lenne, a Rivya elhalaszthatja a véglegesítést, és az upstream állapot ellenőrzésével újra próbálkozhat.

Sikeres útvonal

Siker esetén a Rivya:

eltárolja az eredmény URL-jeit
az állapotot SUCCESS értékre állítja
elszámolja a feladatot
elérhetővé teszi a kimenetet a generálási előzményekben
generálási sikerértesítést hoz létre

Ezért marad látható egy elkészült kép vagy videó akkor is, miután elhagyod az oldalt.

Hibás útvonal

Hiba esetén a Rivya:

eltárolja a hibaüzenetet
az állapotot FAILED értékre állítja
visszatéríti a krediteket, ha a hiba foglalás után történt, és vissza kell fordítani
tartósan visszanézhető generálási hibaértesítést hoz létre

Ez eltér egy ideiglenes toast üzenettől. A hiba a fiók rekordjának részévé válik.

Hol látod a feladat állapotát

Ugyanaz a feladat több helyen is megjelenhet:

az aktív Studio-ban, amíg fut
az Előzményekben, miután lezárult
az Értesítési központban a fontos kimeneteknél
a /dashboard oldalon a legutóbbi generálások között

Ez a közös állapot az egyik oka annak, hogy a termék következetesnek érződik, nem pedig eldobható munkamenetek sorának.

Miben más a Chat

A Chat is számlázható, de nem ugyanazt az aszinkron feladatrekordot használja. A chatfordulók így tárolódnak:

chatmunkamenetek
chatüzenetek

Tokenalapú chatmodelleknél a Rivya először lefoglalhat krediteket, majd a használat visszaérkezése után elszámolhatja a végső összeget. Ha a végső összeg alacsonyabb, a különbözet visszatérül.

Az általános szabály tehát:

a kép-, videó- és hanggenerálás ai_task rekordot használ
a chat mentett munkameneteket és üzenetszintű elszámolást használ

Feladatállapot ellenőrzőlista

Amikor egy generálás zavaros, lassú, sikertelen vagy hiányzik, ellenőrizd:

Először azonosítsd a feladat típusát: chatelszámolás, kép, videó, hang vagy eszközzel támogatott chat.
Nézd meg, hogy a kreditek a szolgáltatói beküldés előtt lettek-e lefoglalva, vagy a használat után lettek-e elszámolva.
Keresd meg a szolgáltatói callbacket, a polling eredményét, az előzményelemet és az értesítést, mielőtt azt feltételeznéd, hogy az eredmény elveszett.
Válaszd szét a felhasználó által javítható hibákat a szolgáltatói vagy infrastrukturális hibáktól.
Újrafuttatás előtt erősítsd meg, hogy egy sikertelen feladatnak vissza kell-e fordítania a krediteket.

Ellenőrizd újra, mielőtt ismét futtatod

Ellenőrizd újra, ha ugyanaz a prompt folyamatosan hibázik, egy feladat túl sokáig marad folyamatban, a kreditek kimenet nélkül tűnnek elköltöttnek, vagy éppen egy nehezebb duplikált futtatás beküldésére készülsz.

Rivya-feladatok életciklusának útmutatója