WikiAPI-Katalogintegrity

integrity

10 Funktionen in dieser Kategorie.

integrity.run POST /api/admin/integrity/run

Integritaetspruefung starten

Hilfe

Startet eine vollstaendige Integritaetspruefung aller Datenschichten (Qdrant, Elasticsearch, chunk_datasources, file_hashes). Der Vorgang laeuft im Hintergrund — Status ueber integrity.status abfragen.

Beispiel-Prompts

  • Starte Integritaetspruefung
  • Pruefe die Datenkonsistenz
  • Sind die Datenschichten konsistent?
  • System-Integritaet pruefen
raw_response: Ja
integrity.status GET /api/admin/integrity/status

Integritaetspruefung-Status abfragen

Hilfe

Gibt den Status der laufenden oder letzten Integritaetspruefung zurueck. Enthaelt Fortschritt und Ergebnisse.

Beispiel-Prompts

  • Wie weit ist die Integritaetspruefung?
  • Integritaets-Status?
  • Ist die Pruefung fertig?
raw_response: Ja
integrity.quick GET /api/admin/integrity/quick

Schnelle Schicht-Zaehlung

Hilfe

Zaehlt Chunks in allen 4 Datenschichten (Qdrant, ES, chunk_datasources, datasource_embeddings) und vergleicht. Laeuft synchron (wenige Sekunden).

Beispiel-Prompts

  • Wie viele Chunks sind in Qdrant vs ES?
  • Schnelle Integritaetspruefung
  • Schicht-Counts vergleichen
raw_response: Ja
integrity.repair_ds_ids POST /api/admin/integrity/repair/ds-ids

DS-IDs in Qdrant synchronisieren

Hilfe

Synchronisiert das ds_ids-Payload-Feld aller Chunks in Qdrant mit den tatsaechlichen Zuordnungen aus chunk_datasources. Laeuft im Hintergrund.

Beispiel-Prompts

  • Synchronisiere ds_ids in Qdrant
  • DS-IDs reparieren
  • Qdrant ds_ids aktualisieren

Confirmation

Diese Funktion erfordert eine Bestätigung. Template: ds_ids in qdrant synchronisieren

Changelog

Area: integrity | Action: update

raw_response: Ja
integrity.repair_orphans POST /api/admin/integrity/repair/orphans

Verwaiste Chunks aus Qdrant loeschen

Hilfe

Scannt ALLE Chunks in Qdrant und loescht diejenigen, die keine Zuordnung in chunk_datasources haben. DESTRUKTIV — vollstaendiger Scan. Laeuft im Hintergrund.

Beispiel-Prompts

  • Loesche verwaiste Chunks
  • Orphan-Cleanup ausfuehren
  • Verwaiste Chunks bereinigen

Confirmation

Diese Funktion erfordert eine Bestätigung. Template: verwaiste chunks aus qdrant löschen

Changelog

Area: integrity | Action: delete

raw_response: Ja
integrity.repair_stats POST /api/admin/integrity/repair/stats

Chunk-Statistiken in datasource_embeddings korrigieren

Hilfe

Zaehlt die tatsaechlichen Chunks pro Datenquelle in chunk_datasources und aktualisiert chunk_count in datasource_embeddings. Laeuft im Hintergrund.

Beispiel-Prompts

  • Statistiken korrigieren
  • Chunk-Counts aktualisieren
  • datasource_embeddings reparieren

Confirmation

Diese Funktion erfordert eine Bestätigung. Template: chunk-statistiken korrigieren

Changelog

Area: integrity | Action: update

raw_response: Ja
integrity.repair_reset_meta POST /api/admin/integrity/repair/reset-meta

Verwaiste Metadaten loeschen (alle Qdrant-Collections leer)

Hilfe

Loescht alle Eintraege in chunk_datasources, file_hashes und datasource_embeddings. NUR ausfuehren wenn ALLE Qdrant-Collections leer sind — das System prueft dies automatisch und bricht ab falls noch Chunks in irgendeiner Collection vorhanden sind. WICHTIG: Wenn Qdrant noch Daten enthaelt, stattdessen integrity.repair_reconstruct verwenden — das rekonstruiert die Metadaten aus den vorhandenen Qdrant-Daten ohne Datenverlust.

Beispiel-Prompts

  • Verwaiste Metadaten loeschen
  • Qdrant ist komplett leer, Metadaten bereinigen

Confirmation

Diese Funktion erfordert eine Bestätigung. Template: alle metadaten löschen (chunk_datasources, file_hashes, datasource_embeddings)

Changelog

Area: integrity | Action: delete

raw_response: Ja
integrity.repair_reconstruct POST /api/admin/integrity/repair/reconstruct

Metadaten aus Qdrant-Daten rekonstruieren

Hilfe

Rekonstruiert chunk_datasources und datasource_embeddings aus den vorhandenen Qdrant-Chunks. Fuer jeden Chunk wird der source-Pfad gegen die Datasource-Pfade gematcht. Anschliessend werden die ds_ids-Payloads in Qdrant aktualisiert. Durchsucht ALLE Qdrant-Collections (Multi-Modell). Kein Datenverlust — file_hashes werden bei der naechsten Indexierung automatisch wieder aufgebaut.

Beispiel-Prompts

  • Metadaten aus Qdrant rekonstruieren
  • chunk_datasources aus Qdrant wiederherstellen
  • DS-Zuordnungen aus Vektordaten rekonstruieren
  • Metadaten wiederherstellen

Confirmation

Diese Funktion erfordert eine Bestätigung. Template: metadaten aus qdrant-daten rekonstruieren

Changelog

Area: integrity | Action: update

raw_response: Ja
integrity.repair_rebuild POST /api/admin/integrity/repair/rebuild

Fragmentierte Qdrant-Collections neu aufbauen

Hilfe

Erstellt einen Snapshot, loescht die Collection und stellt sie aus dem Snapshot wieder her. Entfernt leere Segmente und gibt Speicherplatz frei. Nur fuer Collections mit >10.000 Chunks und >5 Segmenten (konsistent mit check_qdrant_fragmentation).

Beispiel-Prompts

  • Qdrant-Collection rebuilden
  • Collection neu aufbauen
  • Leere Segmente entfernen

Confirmation

Diese Funktion erfordert eine Bestätigung. Template: fragmentierte qdrant-collections neu aufbauen (snapshot/restore)

Changelog

Area: integrity | Action: update

raw_response: Ja
integrity.cleanup_colbert POST /api/admin/integrity/cleanup/colbert

Stale ColBERT-Collections bereinigen

Hilfe

Startet den manuellen Cleanup veralteter ColBERT-Collections und verwaister colbert::*-DB-Eintraege im Hintergrund.

Beispiel-Prompts

  • Stale ColBERT-Collections bereinigen
  • ColBERT-Cleanup starten

Confirmation

Diese Funktion erfordert eine Bestätigung. Template: stale colbert-collections bereinigen

Changelog

Area: integrity | Action: delete

raw_response: Ja