Rivya-Leitfaden zum Aufgabenlebenszyklus

Nutzen Sie diesen Leitfaden, wenn Sie verstehen möchten, was nach dem Einreichen einer Bild-, Video- oder Audio-Generierungsaufgabe in Rivya passiert.

Er erklärt Aufgabenstatus, Credit-Reservierung, Anbieter-Abschluss, History, Notifications und Behandlung fehlgeschlagener Aufgaben an einer Stelle.

Die echten Aufgabenstatus

Der aktuelle asynchrone Generierungslebenszyklus nutzt vier sichtbare Status:

• WAITING

• GENERATING

• SUCCESS

• FAILED

Diese Status werden auf ai_task gespeichert und über Studio, History, Dashboard und Notifications hinweg wiederverwendet.

Was beim Einreichen passiert

1. Rivya validiert die Anfrage

Bevor etwas einen Anbieter erreicht, prüft Rivya:

• ob das Modell existiert

• ob direkte Generierung für dieses Modell aktiviert ist

• ob die Runtime auf async tasks basiert

• ob die Prompt-Länge gültig ist

• ob Formularparameter normalisiert sind

• ob Referenzdateien zu dem passen, was das Modell akzeptiert

Einige Modelle haben zusätzliche Regeln. Audio-Isolation erfordert zum Beispiel eine hochgeladene Audiodatei plus Dauerprüfung.

2. Rivya erstellt den Aufgabendatensatz

Rivya erstellt zuerst einen ai_task-Eintrag mit dem Status WAITING.

Dieser Datensatz speichert Modell, Kategorie, Prompt, Params, reservierte Credits, Abrechnungstyp und später Ergebnis oder Fehlerzustand.

3. Credits werden vor der Anbieter-Submission verbraucht

Das ist wichtig: Bei asynchroner Generierung gibt Rivya die Aufgaben-Credits aus, bevor der Job upstream gesendet wird.

Wenn die Credits zu niedrig sind:

• wird die Aufgabe als fehlgeschlagen markiert

• wird der Upstream-Service nie aufgerufen

• kann eine Benachrichtigung wegen unzureichender Credits erstellt werden

4. Der Anbieterjob wird erstellt

Wenn Credits verfügbar sind, reicht Rivya die Aufgabe beim passenden Upstream-Service ein und speichert die Upstream-Task-ID.

An diesem Punkt wechselt der Status zu GENERATING.

Wie Rivya das Ergebnis erfährt

Rivya unterstützt zwei Abschlusswege:

• Anbieter-Callback in Umgebungen mit aktivierten Callbacks

• Statusaktualisierung und Polling, wenn Callback-Abschluss nicht verfügbar ist

Der Callback-Pfad verifiziert außerdem die Webhook-Signatur, bevor eine Aufgabe finalisiert wird.

Wenn ein Callback eintrifft, bevor das Anbieterergebnis vollständig bereit ist, kann Rivya zurückstellen und durch erneutes Prüfen des Upstream-Status später noch einmal versuchen.

Erfolgspfad

Bei Erfolg tut Rivya Folgendes:

• Ergebnis-URLs speichern

• Status auf SUCCESS setzen

• die Aufgabe abrechnen

• die Ausgabe in der Generierungshistory verfügbar machen

• eine Generation-Success-Notification erstellen

Darum bleibt ein fertiges Bild oder Video sichtbar, nachdem Sie die Seite verlassen haben.

Fehlerpfad

Bei Fehlern tut Rivya Folgendes:

• Fehlermeldung speichern

• Status auf FAILED setzen

• Credits erstatten, wenn der Fehler nach der Reservierung passiert ist und rückgängig gemacht werden sollte

• eine Generation-Failed-Notification für dauerhafte Prüfung erstellen

Das unterscheidet sich von einem temporären Toast. Der Fehler wird Teil des Kontodatensatzes.

Wo Sie den Aufgabenstatus sehen

Dieselbe Aufgabe kann an mehreren Stellen erscheinen:

• im aktiven Studio, während sie läuft

• in History, nachdem sie abgeschlossen ist

• im Notifications Center für wichtige Ergebnisse

• auf /dashboard unter den letzten Generierungen

Dieser gemeinsame Zustand ist einer der Gründe, warum das Produkt zusammenhängend wirkt statt wegwerfbar.

Wie sich Chat unterscheidet

Chat ist ebenfalls abrechenbar, nutzt aber nicht denselben asynchronen Aufgabendatensatz. Chat-Turns werden gespeichert als:

• Chat-Sitzungen

• Chat-Nachrichten

Bei tokenbasierten Chat-Modellen kann Rivya Credits zunächst reservieren und den finalen Betrag nach zurückgemeldeter Nutzung abrechnen. Wenn der finale Betrag niedriger ist, wird die Differenz erstattet.

Die grobe Regel lautet also:

• Bild-, Video- und Audio-Generierung nutzen ai_task

• Chat nutzt gespeicherte Sitzungen und nachrichtenbasierte Abrechnung

Als Nächstes lesen

• Bild-Workflows in Rivya

• Video-Workflows in Rivya

• Audio-Workflows in Rivya

• Credits und Abrechnung

• Troubleshooting in Rivya

• Notifications Center

• History

Checkliste zum Aufgabenstatus

Wenn eine Generierung verwirrend, langsam, fehlgeschlagen oder verschwunden wirkt, prüfen Sie:

• Identifizieren Sie zuerst den Aufgabentyp: Chat-Abrechnung, Bild, Video, Audio oder toolgestützter Chat.

• Prüfen Sie, ob Credits vor Anbieter-Submission reserviert oder nach Nutzung abgerechnet wurden.

• Suchen Sie nach Anbieter-Callback, Polling-Ergebnis, History-Eintrag und Notification, bevor Sie annehmen, dass das Ergebnis verloren ist.

• Trennen Sie nutzerkorrigierbare Fehler von Anbieter- oder Infrastrukturfehlern.

• Bestätigen Sie, ob eine fehlgeschlagene Aufgabe Credits rückgängig machen sollte, bevor Sie denselben Prompt erneut ausführen.

Vor dem erneuten Ausführen prüfen

Prüfen Sie erneut, wenn derselbe Prompt weiter fehlschlägt, eine Aufgabe zu lange in Bearbeitung bleibt, Credits ohne Ausgabe verbraucht wirken oder Sie kurz davor sind, einen schwereren Duplikatlauf einzureichen.