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

130 lines
4.1 KiB
Markdown

<!-- titel -->
Konfiguration
----------------------------------------
<!-- art -->
kern
----------------------------------------
<!-- ziel -->
Stellt Konfigurationsdaten für Ingest-Profile, Modelle, Chat-Nachrichten und Agent bereit
----------------------------------------
<!-- regeln -->
- ROLE_SUPER_ADMIN darf alle Funktionen aufrufen
- ROLE_KNOWLEDGE_ADMIN darf Konfigurationen lesen
- POST erfordert gültiges CSRF-Token
- Flash-Nachrichten zeigen Erfolg und Fehler
- JsonResponse ohne Browser-Cache-Header
- Default-Ausgabe ist JSON
- Ingest-Profil entfernen fehlt
- Model-Konfiguration löschen fehlt
- Model-Konfiguration Retrieval testen fehlt
----------------------------------------
<!-- funktion -->
Ingest-Profil anlegen
<!-- ziel -->
Legt ein Ingest-Profil an, das Dokument-Importe steuert
<!-- regeln -->
- Nur Super-Admin kann aufrufen
- CSRF-Token erforderlich
- Erfolgsmeldung bei Anlage
<!-- testen -->
- Seite admin-ingest-profiles-create öffnen
- Alle Felder ausfüllen
- Formular absenden
- Erfolgsmeldung bestätigt Anlage
----------------------------------------
<!-- funktion -->
Ingest-Profile anzeigen
<!-- regeln -->
- ROLE_KNOWLEDGE_ADMIN erforderlich
- Tabelle mit Spalten
- Aktives Profil hervorgehoben
<!-- testen -->
- Admin-Bereich öffnen
- Seite "Ingest-Profiles" aufrufen
- Tabelle mit Profilen sichtbar
----------------------------------------
<!-- funktion -->
Konfiguration aktivieren
<!-- ziel -->
Macht eine Konfiguration zur aktiven Konfiguration
<!-- regeln -->
- Nur SUPER_ADMIN darf diese Funktion auslösen
- POST-Request erforderlich
<!-- testen -->
- admin_model_config_list öffnen
- POST-Request an activate-Endpunkt senden
- Weiterleitung zur Liste
- Konfiguration ist aktiv
----------------------------------------
<!-- funktion -->
Konfiguration anzeigen
<!-- ziel -->
Zeigt die aktuelle RetrieX-Konfiguration zur Diagnose
<!-- regeln -->
- Standardausgabe ist JSON
- summary zeigt formatierte Übersicht
- Zeigt alle Konfigurationsbereiche
<!-- testen -->
- Befehl ausführen: mto:agent:config:dump-effective
- JSON-Ausgabe mit Config-Struktur
----------------------------------------
<!-- funktion -->
Konfiguration bereitstellen
<!-- ziel -->
Liefert dem Chatfrontend alle nötigen Konfigurationsdaten in einem Request
<!-- regeln -->
- Keine Browser-Cache-Header
- JsonResponse mit Konfigurationsdaten
- Mischt Konfiguration aus drei Quellen
<!-- testen -->
- GET chat-messages-frontend
- Antwort ist JsonResponse
- Enthält limits.prompt und limits.uploads
- Keine Browser-Cache-Header gesetzt
----------------------------------------
<!-- funktion -->
Konfigurationen anzeigen
<!-- ziel -->
Zeigt alle Model-Generation-Konfigurationen im Admin-Bereich
<!-- regeln -->
- ROLE_KNOWLEDGE_ADMIN erforderlich
<!-- testen -->
- Admin-Endpoint für Model-Konfiguration aufrufen
- LMB auf Konfiguration in der Liste
- Liste der Konfigurationen sichtbar
----------------------------------------
<!-- funktion -->
Konfigurationsmuster prüfen
<!-- ziel -->
Prüft alle PHP-Dateien auf Verwendung von Kernmustern und markierten Token
<!-- regeln -->
- Ohne Option wird eine Zusammenfassung angezeigt
- json gibt das vollständige Ergebnis maschinenlesbar aus
- details zeigt die Warnungen als Tabelle
- all fügt niedrigpriore REVIEW-Befunde hinzu
- Fehlende Dateien werden als skipped_files gezählt
<!-- testen -->
- mto:agent:config:audit-patterns ausführen
- Zusammenfassung mit Zählern prüfen
- json anhängen und JSON-Struktur validieren
- details anhängen und Tabelle prüfen
- all anhängen und REVIEW-Zeilen prüfen
----------------------------------------
<!-- funktion -->
Tool-Freigaben aktualisieren
<!-- ziel -->
Schaltet einzelne Werkzeuge einer Anbindung im Chat frei oder sperrt sie
<!-- regeln -->
- Freigabe toggelt zwischen an und aus
- Ungültiges Token zeigt Fehlermeldung
- Erfolg zeigt Bestätigung
- Fehler zeigt Exception-Nachricht
<!-- testen -->
- Admin-Übersicht öffnen
- POST-Anfrage mit source_key, tool_name und tool_enabled senden
- Flash-Message prüfen
- Zurückleitung zur Übersicht
----------------------------------------
<!-- funktion -->
Ingest-Profil entfernen