Files
planer2/daten/RAG/knowledge-raeume.md
2026-07-29 15:19:41 +02:00

4.9 KiB

Knowledge-Räume

kern

Stellt Knowledge-Räume bereit und verwaltet deren Inhalte sowie Anbindungen

  • CSRF-Token wird bei POST-Anfragen geprüft
  • no-report verhindert das Schreiben von Berichtsdateien
  • Anbindung Tool-Allowlist aktualisiert separate Anbindung

Batch-Import durchführen

Importiert Wissensdokumente aus einem Verzeichnis in den Wissensspeicher

  • upload-dir ist Zieldateiverzeichnis
  • user-email identifiziert Ersteller
  • activate-derived-on-success erfordert normalize-markdown
  • dry-run erzeugt keine Dateien oder Versionen
  • reindex startet genau einen Indexlauf
  • Berichte ohne --no-report in report-dir
  • Batch-Import im Dry-Run-Modus ausführen
  • PHPUnit-Test KnowledgeBatchImportCommandTest ausführen
  • Erfolgsstatus und Reportdateien prüfen

Chat-Freigabe umschalten

Aktiviert oder deaktiviert den Chat-Zugriff für einen gespeicherten Inhalt

  • Nur POST-Anfragen werden akzeptiert
  • CSRF-Token wird geprüft
  • Kanditat-ID muss existieren
  • Seite mit Anbindungsinhalten öffnen
  • POST an Endpunkt senden
  • candidate_id senden
  • chat_enabled senden
  • Übersicht wird angezeigt

Chat-Verfügbarkeit prüfen

Schaltet den Chat-Zugriff für einen Wissensraum ein oder aus

  • POST-Request erforderlich
  • CSRF-Token wird geprüft
  • Ungültiges Token zeigt Fehlermeldung
  • Unterscheidet Server-Ressource, gespeicherte Ressource und Standard-Raum
  • Erfolgreiche Änderung zeigt Bestätigung
  • POST an admin_knowledge_spaces_chat_availability_update mit _token und chat_enabled
  • Leerer RaumId liefert Flash danger
  • Gültiger Toggle liefert Flash success
  • Chat-Verfügbarkeit geändert

Facts prüfen

Prüft die diagnostischen Ingest-Facts im Index auf Vollständigkeit und korrekte Struktur

  • type filtert nach spezifischem Fact-Typ
  • query durchsucht Titel, Text und alle Fact-Felder
  • Standard-Limit zeigt maximal 10 Chunks
  • json gibt maschinenlesbare Ausgabe zurück
  • Warnung bei fehlenden oder leeren Fakten
  • Befehl ohne Argumente ausführen
  • Chunk-Überschriften mit Metriken prüfen
  • Warnung bei leerem Ergebnis prüfen

Kandidaten wählen

Wählt einen Tool- oder Resource-Kandidaten zur Wissensraumnutzung aus

  • CSRF-Token erforderlich
  • Nur Tool- oder Resource-Kandidaten verarbeitbar
  • Kandidat wird nach Auswahl auf approved gesetzt
  • Weiterleitung zur Überblickansicht mit Review-Dialog
  • Überblickansicht öffnen
  • POST an provider-candidate-select mit source_key, candidate_kind
  • Flash-Nachricht über Erfolg oder Warnung
  • Redirect zur Überblickansicht mit provider_review_open=1

Knowledge-Räume anzeigen

Stellt alle Knowledge-Räume mit Status und Anbindungen übersichtlich dar

  • Lädt Verfügbarkeit und Chat-Auswahl
  • Lädt Anbindungsinhalte und Kandidaten
  • Rendert admin knowledge-spaces index html-twig
  • Admin-Seite Knowledge-Räume aufrufen
  • Seite mit Wissensraum-Übersicht prüfen
  • Knowledge-Räume mit Verfügbarkeit angezeigt

Live-Vorschau laden

Lädt Ressourceninhalt live zur Prüfung vor Freigabe

  • POST-Request mit gültigem CSRF-Token
  • Gibt JSON mit Inhalt und Status zurück
  • Nur für Ressourcen vom Typ resource verfügbar
  • POST an admin knowledge-spaces provider-resource-live-preview mit candidate_id
  • Response enthält JSON mit ok und content
  • Im Dialog erscheint der live gelesene Inhalt

Ressourcenprüfung durchführen

Textteile suchen

Findet Textteile, die einer Suchanfrage semantisch ähneln

  • Gibt Treffer absteigend nach Ähnlichkeit zurück
  • Limit wird auf maximal 200 begrenzt
  • Optionale doc_ids filtern Treffer nach Dokument
  • Ohne doc_ids werden Treffer aus allen Dokumenten zurückgegeben
  • POST such-chunks mit query und limit
  • Antwort enthält sortierte Treffer mit chunk_id

Wissensräume prüfen

Prüft die Funktionsfähigkeit aller Wissensraum-Komponenten

  • Admin-Übersicht öffnen
  • Diagnose starten
  • Alle Prüfungen bestanden