3.4 KiB
3.4 KiB
Aufträge
kern
Verarbeitet asynchrone Aufgaben mit Verfolgung von Status und Ereignissen
- ROLE_ADMIN_AREA für Admin-Statusabruf erforderlich
- Admin-Bereich für Ereignisse gilt ohne Events-Endpunkt
- Antwort enthält lastEventId, updatedAt, startedAt, completedAt, runningStaleAfterSeconds
- Vollständiger Kontext muss explizit angefordert werden, Standard ist eingeschränkter Kontext
- Abgeschlossene, fehlgeschlagene und abgebrochene Ingest-Jobs werden mit Exitcode SUCCESS beendet
- Dry-Run gibt im Output einen Hinweis zum Zwischenspeicher-Status aus
- Ingest-Job-Verarbeitung leert PHP-Laufzeit- und Vector-Service-Cache nach Abschluss
Auftrag starten
Übermittelt einen Prompt zur asynchronen Verarbeitung im Hintergrund
- Leere Prompts werden abgelehnt
- Prompts über dem Zeichenlimit werden abgelehnt
- Ungültige Upload-IDs werden abgelehnt
- Job-ID besteht aus 48 Hexadezimalzeichen
- Erstellt Job mit Status pending
- POST ask-jobs mit gültigem Prompt
- Antwort enthält jobId
- Statuscode ist 200
- POST ask-jobs mit leerem Prompt
- Statuscode ist 400
- POST ask-jobs mit zu langem Prompt
- Statuscode ist 413
Auftragsereignisse abrufen
Ermöglicht dem Client, Auftragsereignisse zu pollen
- Unbekannte Auftrags-ID gibt HTTP 404 zurück
- Veraltete laufende Aufträge werden als fehlgeschlagen markiert
- Ereignisse nach after werden zurückgegeben
- GET ask-jobs jobId events after 0
- Antwort enthält status, events, lastEventId
- Unbekannte jobId gibt HTTP 404
Auftragsstatus anzeigen
Ermöglicht dem Admin, den aktuellen Status eines Auftrags ohne Seitenreload zu prüfen
- ROLE_ADMIN_AREA erforderlich
- JSON mit id, type, status, startedAt, finishedAt, errorMessage, logPath
- 404 bei unbekannter Auftrags-ID
- Detailseite eines Auftrags öffnen
- Statusabfrage per AJAX auslösen
- JSON mit status und Zeitstempeln empfangen
Auftragsstatus prüfen
Ermöglicht das Prüfen des aktuellen Zustands eines Auftrags
- jobId ist eine 48-stellige Hexadezimalzahl
- Ungültige jobId liefert Status missing
- Abgelaufene Aufträge werden als failed markiert
- Antwort enthält status, message, timestamps und serverTime
- ask-jobs-Endpunkt mit jobId aufrufen
- JSON-Antwort mit Status prüfen
- Status pending, running, completed, interrupted oder failed zurückgegeben
Ingest-Job starten
Startet einen bereitgestellten Ingest-Job über seine UUID
- Job-ID als Pflichtargument erforderlich
- Job-Status muss ausführbar sein
- Abgeschlossene Jobs werden nicht erneut ausgeführt
- Dry-Run vermeidet Seiteneffekte
- Fehler führen zu FAILURE-Exitcode
- Befehl mit gültiger Job-ID ausführen
- Job wird verarbeitet
- Erfolgsmeldung erscheint
Ingest-Jobs auflisten