142 lines
4.9 KiB
Markdown
142 lines
4.9 KiB
Markdown
<!-- titel -->
|
|
Knowledge-Räume
|
|
----------------------------------------
|
|
<!-- art -->
|
|
kern
|
|
----------------------------------------
|
|
<!-- ziel -->
|
|
Stellt Knowledge-Räume bereit und verwaltet deren Inhalte sowie Anbindungen
|
|
----------------------------------------
|
|
<!-- regeln -->
|
|
- CSRF-Token wird bei POST-Anfragen geprüft
|
|
- no-report verhindert das Schreiben von Berichtsdateien
|
|
- Anbindung Tool-Allowlist aktualisiert separate Anbindung
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Batch-Import durchführen
|
|
<!-- ziel -->
|
|
Importiert Wissensdokumente aus einem Verzeichnis in den Wissensspeicher
|
|
<!-- regeln -->
|
|
- 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
|
|
<!-- testen -->
|
|
- Batch-Import im Dry-Run-Modus ausführen
|
|
- PHPUnit-Test KnowledgeBatchImportCommandTest ausführen
|
|
- Erfolgsstatus und Reportdateien prüfen
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Chat-Freigabe umschalten
|
|
<!-- ziel -->
|
|
Aktiviert oder deaktiviert den Chat-Zugriff für einen gespeicherten Inhalt
|
|
<!-- regeln -->
|
|
- Nur POST-Anfragen werden akzeptiert
|
|
- CSRF-Token wird geprüft
|
|
- Kanditat-ID muss existieren
|
|
<!-- testen -->
|
|
- Seite mit Anbindungsinhalten öffnen
|
|
- POST an Endpunkt senden
|
|
- candidate_id senden
|
|
- chat_enabled senden
|
|
- Übersicht wird angezeigt
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Chat-Verfügbarkeit prüfen
|
|
<!-- ziel -->
|
|
Schaltet den Chat-Zugriff für einen Wissensraum ein oder aus
|
|
<!-- regeln -->
|
|
- 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
|
|
<!-- testen -->
|
|
- 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
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Facts prüfen
|
|
<!-- ziel -->
|
|
Prüft die diagnostischen Ingest-Facts im Index auf Vollständigkeit und korrekte Struktur
|
|
<!-- regeln -->
|
|
- 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
|
|
<!-- testen -->
|
|
- Befehl ohne Argumente ausführen
|
|
- Chunk-Überschriften mit Metriken prüfen
|
|
- Warnung bei leerem Ergebnis prüfen
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Kandidaten wählen
|
|
<!-- ziel -->
|
|
Wählt einen Tool- oder Resource-Kandidaten zur Wissensraumnutzung aus
|
|
<!-- regeln -->
|
|
- CSRF-Token erforderlich
|
|
- Nur Tool- oder Resource-Kandidaten verarbeitbar
|
|
- Kandidat wird nach Auswahl auf approved gesetzt
|
|
- Weiterleitung zur Überblickansicht mit Review-Dialog
|
|
<!-- testen -->
|
|
- Ü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
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Knowledge-Räume anzeigen
|
|
<!-- ziel -->
|
|
Stellt alle Knowledge-Räume mit Status und Anbindungen übersichtlich dar
|
|
<!-- regeln -->
|
|
- Lädt Verfügbarkeit und Chat-Auswahl
|
|
- Lädt Anbindungsinhalte und Kandidaten
|
|
- Rendert admin knowledge-spaces index html-twig
|
|
<!-- testen -->
|
|
- Admin-Seite Knowledge-Räume aufrufen
|
|
- Seite mit Wissensraum-Übersicht prüfen
|
|
- Knowledge-Räume mit Verfügbarkeit angezeigt
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Live-Vorschau laden
|
|
<!-- ziel -->
|
|
Lädt Ressourceninhalt live zur Prüfung vor Freigabe
|
|
<!-- regeln -->
|
|
- POST-Request mit gültigem CSRF-Token
|
|
- Gibt JSON mit Inhalt und Status zurück
|
|
- Nur für Ressourcen vom Typ resource verfügbar
|
|
<!-- testen -->
|
|
- 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
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Ressourcenprüfung durchführen
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Textteile suchen
|
|
<!-- ziel -->
|
|
Findet Textteile, die einer Suchanfrage semantisch ähneln
|
|
<!-- regeln -->
|
|
- 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
|
|
<!-- testen -->
|
|
- POST such-chunks mit query und limit
|
|
- Antwort enthält sortierte Treffer mit chunk_id
|
|
----------------------------------------
|
|
<!-- funktion -->
|
|
Wissensräume prüfen
|
|
<!-- ziel -->
|
|
Prüft die Funktionsfähigkeit aller Wissensraum-Komponenten
|
|
<!-- testen -->
|
|
- Admin-Übersicht öffnen
|
|
- Diagnose starten
|
|
- Alle Prüfungen bestanden
|