KI-Konfiguration — Systembeschreibung
Datenmodell der KI-Konfiguration mit zwei Stufen, Validierung beim Speichern, Verbindungstest und Modellliste, Leeren des Caches und Besonderheiten der Rechteprüfung.
Überblick
Modelleinstellungen der KI-Aufrufe (E-Mail-Klassifizierung, Firmenauflösung, Kontierung, Workflow-Schritte): je Scope zwei Stufen (Tier 1 und Tier 2 als Fallback) mit Anbieter, Modell, Temperatur, Token-Grenze, Schwelle und Prompt. Die Seite zeigt außerdem die Routing-Übersicht des zentralen KI-Dienstes und die Liste der „pausierenden“ Modelle.
Datenmodell
Die Tabellennamen tragen in der Datenbank das eigene Präfix der Installation.
| Tabelle | Zweck | Hauptfelder |
|---|---|---|
aiconfig | Konfiguration eines Scopes | Name, Scope (eindeutig), Beschreibung, Schwelle, Aktiv-Kennzeichen, Zeichengrenze des Textkörpers, je Stufe Anbieter, Modell, Temperatur, max. Tokens; System-Prompt, Benutzer-Prompt-Vorlage, zusätzlicher Kontext, automatische Einfügungen, Status |
Die API-Schlüssel stehen nicht in dieser Tabelle, sondern in den Moduleinstellungen.
Ablauf und Validierung
- Formular: Standardwerte (Gemini auf Tier 1 und Tier 2, Schwelle 0,95), Scope-Beschreibung aus einem Sprachschlüssel, Hilfe „Welches Modell wofür?“.
- Speichern: Name Pflicht; Scope nur Kleinbuchstaben, Ziffern, Unterstrich; Schwelle 0–1; System-Prompt und Tier-2-Modell Pflicht außer bei den Scopes der Workflow-Schritte; Tier-1-Modell Pflicht; Scope eindeutig.
- Verbindungstest: je ein winziger echter API-Aufruf für das Tier-1- und (falls ausgefüllt) das Tier-2-Paar der Zeile über den Paartest des zentralen Dienstes; Ergebnis je Paar, ohne API-Schlüssel. Fehlercodes:
PERMISSION_DENIED,NOT_FOUND,NOT_CONFIGURED,SELFTEST_FAILED. Ein echter, kostenpflichtiger Aufruf. - Modellliste: ruft die je Anbieter tatsächlich verfügbaren Modelle ab.
- Löschen: physisch, ohne Verweisprüfung.
- Cache leeren: leert den gesamten Anwendungscache, den Vorlagencache und die Cache-Dateien und liefert eine Statistik.
Berechtigungen
- Ebene 1: Das Formular prüft den Zugriff auf den Pfad; Speichern, Löschen und Cache leeren prüfen das Änderungsrecht.
- Ebene 2:
add(nur Sichtbarkeit der Schaltfläche),test(Verbindungstest, Modellliste),debug. Die Katalogschlüssellist,edit,deletefragt der Controller nicht ab. - Ebene 3: keine.
Bekannte Einschränkungen
- Die Liste läuft ohne Prüfung eines Funktionsrechts.
- Cache leeren leert den Cache der gesamten Anwendung, nicht nur den des KI-Moduls.
- Die Menügruppe steht bei den Stammdaten in Entwicklung.