jobs

13 Funktionen in dieser Kategorie.

jobs.list GET /api/admin/ingestion-jobs

Ingestion-Jobs auflisten (paginiert, filterbar)

Hilfe

Listet Ingestion-Jobs auf, optional gefiltert nach Datenquelle oder Status. Unterstützt Paginierung mit limit/offset.

Parameter

Name	Typ	Required	Default	Beschreibung
`ds_id`	integer	Nein	—	Filter nach Datenquellen-ID
`status`	string	Nein	—	Filter nach Status (pending, running, completed, error)
`limit`	integer	Nein	—	Maximale Anzahl Ergebnisse (Default: 50)
`offset`	integer	Nein	—	Offset für Paginierung (Default: 0)

Beispiel-Prompts

Zeig mir alle Jobs
Jobs für Datenquelle 3
Laufende Jobs anzeigen

raw_response: Ja

jobs.status GET /api/admin/ingestion-jobs/{job_id}

Status eines einzelnen Jobs

Hilfe

Zeigt detaillierte Informationen zu einem Ingestion-Job: Status, Fortschritt, Statistiken und Resume-Ketten.

Parameter

Name	Typ	Required	Default	Beschreibung
`job_id`	integer	Ja	—	Job-ID

Beispiel-Prompts

Status von Job 42
Was macht Job 7?

raw_response: Ja

jobs.logs GET /api/admin/ingestion-jobs/{job_id}/file-logs

File-Logs eines Ingestion-Jobs

Hilfe

Zeigt das Per-File-Protokoll eines Jobs: Welche Dateien wurden verarbeitet, übersprungen oder hatten Fehler. Filterbar und paginiert.

Parameter

Name	Typ	Required	Default	Beschreibung
`job_id`	integer	Ja	—	Job-ID
`status`	string	Nein	—	Filter nach File-Status
`search`	string	Nein	—	Dateinamen-Suche
`sort`	string	Nein	—	Sortierfeld (Default: file_name)
`direction`	string	Nein	—	Sortierrichtung: asc/desc (Default: asc)
`limit`	integer	Nein	—	Max Ergebnisse (Default: 100, max: 1000)
`offset`	integer	Nein	—	Offset (Default: 0)

Beispiel-Prompts

File-Logs von Job 42
Fehlerhafte Dateien in Job 7

raw_response: Ja

jobs.schedule GET /api/admin/datasources/{ds_id}/schedule

Cron-Schedule einer Datenquelle

Hilfe

Zeigt den konfigurierten Cron-Schedule für automatische Ingestion einer Datenquelle.

Parameter

Name	Typ	Required	Default	Beschreibung
`ds_id`	integer	Ja	—	ID der Datenquelle

Beispiel-Prompts

Schedule von DS 1
Hat Datenquelle 3 einen Schedule?

raw_response: Ja

jobs.start Chat-only

Inkrementelle Indexierung starten

Hilfe

Startet eine inkrementelle Indexierung für eine Datenquelle. Nur neue/geänderte Dateien werden verarbeitet (File-Hash-Vergleich). Die Datenquelle muss aktiv sein (is_active=1).

Parameter

Name	Typ	Required	Default	Beschreibung
`ds_id`	integer	Ja	—	ID der Datenquelle

Beispiel-Prompts

Starte die Indexierung für Datenquelle 5
Indexiere DS 12

raw_response: Nein

Chat-only (kein HTTP-Mapping)

jobs.start_full Chat-only

Voll-Neuindexierung starten

Hilfe

Startet eine vollständige Neuindexierung: ALLE bestehenden Embeddings der Datenquelle werden gelöscht und alle Dateien neu verarbeitet. Kann bei großen Datenquellen Stunden dauern. IRREVERSIBEL.

Parameter

Name	Typ	Required	Default	Beschreibung
`ds_id`	integer	Ja	—	ID der Datenquelle

Beispiel-Prompts

Starte Voll-Reindexierung für DS 5
Alle Dateien von Datenquelle 12 neu indexieren

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: ds {ds_id} voll-reindexieren

raw_response: Nein

Chat-only (kein HTTP-Mapping)

jobs.cancel Chat-only

Laufenden Ingestion-Job abbrechen

Hilfe

Bricht einen laufenden oder wartenden Job ab. Der Abbruch erfolgt über die DB-Spalte requested_action (prozess-unabhängig).

Parameter

Name	Typ	Required	Default	Beschreibung
`job_id`	integer	Ja	—	Job-ID

Beispiel-Prompts

Breche Job 42 ab
Stoppe die laufende Indexierung

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: job {job_id} abbrechen

raw_response: Nein

Chat-only (kein HTTP-Mapping)

jobs.pause Chat-only

Laufenden Job pausieren

Hilfe

Pausiert einen aktuell laufenden Job. Der Job muss der aktuell ausgeführte sein (get_running_job_id) und darf nicht bereits pausiert sein.

Parameter

Name	Typ	Required	Default	Beschreibung
`job_id`	integer	Ja	—	Job-ID

Beispiel-Prompts

Pausiere Job 42
Halte die Indexierung an

raw_response: Nein

Chat-only (kein HTTP-Mapping)

jobs.resume Chat-only

Pausierten Job fortsetzen

Hilfe

Setzt einen pausierten Job fort. Der Job muss pausiert sein.

Parameter

Name	Typ	Required	Default	Beschreibung
`job_id`	integer	Ja	—	Job-ID

Beispiel-Prompts

Setze Job 42 fort
Indexierung weiterlaufen lassen

raw_response: Nein

Chat-only (kein HTTP-Mapping)

jobs.cleanup_history DELETE /api/admin/ingestion-jobs/history

Alte abgeschlossene Jobs löschen

Hilfe

Löscht alle abgeschlossenen Jobs die älter als die angegebene Anzahl Tage sind. Laufende/wartende/pausierte Jobs werden nicht gelöscht.

Parameter

Name	Typ	Required	Default	Beschreibung
`days`	integer	Nein	—	Jobs älter als X Tage löschen (Default: 30)

Beispiel-Prompts

Lösche Jobs älter als 30 Tage
Job-History bereinigen

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: jobs aelter als {days} tage loeschen

Changelog

Area: jobs | Action: delete

raw_response: Ja

jobs.delete DELETE /api/admin/ingestion-jobs/{job_id}

Einzelnen Job löschen

Hilfe

Löscht einen einzelnen abgeschlossenen/fehlerhaften Job inkl. File-Logs. Laufende, wartende oder pausierte Jobs können nicht gelöscht werden.

Parameter

Name	Typ	Required	Default	Beschreibung
`job_id`	integer	Ja	—	Job-ID

Beispiel-Prompts

Lösche Job 42

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: job {job_id} loeschen

Changelog

Area: jobs | Action: delete

raw_response: Ja | PK-Param: job_id

jobs.schedule.set PUT /api/admin/datasources/{ds_id}/schedule

Automatischen Sync-Schedule setzen

Hilfe

Setzt einen Cron-Schedule für automatische Indexierung einer Datenquelle. Cron-Ausdruck mit 5 Feldern (Minute Stunde Tag Monat Wochentag). Beispiel: '0 2 * * *' = täglich um 02:00 Uhr.

Parameter

Name	Typ	Required	Default	Beschreibung
`ds_id`	integer	Ja	—	ID der Datenquelle
`cron_expr`	string	Ja	—	Cron-Ausdruck (5 Felder)
`preset`	string	Nein	—	Preset-Name (optional, z.B. 'daily', 'weekly')

Beispiel-Prompts

Setze tägliche Synchronisation um 3 Uhr für DS 5
Schedule für DS 12: jeden Montag um 6:00

Changelog

Area: schedules | Action: update

raw_response: Ja | PK-Param: ds_id

jobs.schedule.delete DELETE /api/admin/datasources/{ds_id}/schedule

Automatischen Sync-Schedule entfernen

Hilfe

Entfernt den Cron-Schedule einer Datenquelle. Die Datenquelle wird nicht mehr automatisch synchronisiert.

Parameter

Name	Typ	Required	Default	Beschreibung
`ds_id`	integer	Ja	—	ID der Datenquelle

Beispiel-Prompts

Entferne den Schedule von DS 5
Automatische Synchronisation für DS 12 stoppen

Confirmation

Diese Funktion erfordert eine Bestaetigung. Template: schedule fuer ds {ds_id} loeschen

Changelog

Area: schedules | Action: delete

raw_response: Ja | PK-Param: ds_id