KI-Handler PII mit CSV

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Suite. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Der Handler filtert sensible persönliche Informationen (PII - Personally Identifiable Information) aus KI-Anfragen heraus und stellt diese nach der KI-Verarbeitung in den Antworten wieder her. Die zu filternden Begriffe werden aus einer CSV-Datei gelesen.

Eine allgemeine Beschreibung von KI-Handlern finden Sie unter ALBERT | AI KI-Handler einrichten.

Eigenschaft	Wert
Anzeigename in der Oberfläche	PII: Filter personal information with CSV
Technischer Handler-Name	`agorum.ai.csv.filter` (Name der Konfiguration: `agorum_ai_pii_csv_filter`)
Standardmäßig aktiv	ja
Eingriffspunkte (Hooks)	`before`, `after`

Wann verwenden

Datenschutz: Schutz persönlicher Daten wie Namen, Adressen, Geburtsdaten beim Senden an externe KI-Dienste.
Compliance: Einhaltung von DSGVO und anderen Datenschutzvorschriften durch Anonymisierung sensibler Daten.
Bekannte Filterbegriffe: Wenn die zu filternden Begriffe vorab bekannt sind und in einer CSV-Datei gepflegt werden können.
Musterbasiertes Filtern: Filtern von Daten mit bekannten Formaten (z.B. Datumsformate, Telefonnummern) mittels RegEx.
Einfache Wartung: Die CSV-Datei kann ohne Programmierkenntnisse gepflegt werden.

Funktionsweise

Der Handler agorum_ai_pii_csv_filter arbeitet in zwei Phasen:

Before-Hook (vor der KI-Verarbeitung): Sensible Daten werden im Eingabetext und in der Konversationshistorie durch Platzhalter ersetzt (z.B. [[NAME_uuid]], [[CITY_uuid]]).
After-Hook (nach der KI-Verarbeitung): Die Platzhalter in der KI-Antwort werden durch die ursprünglichen Werte ersetzt, sodass der Benutzer die vollständige Antwort erhält.

CSV-Dateiformat

Die CSV-Datei muss eine Kopfzeile mit den Spalten text und category enthalten:

text: Der zu filternde Text oder ein RegEx-Muster
category: Die Kategorie für den Platzhalter (z.B. NAME, DATE, CITY)

Das text-Feld unterstützt zwei Formate:

Klartext: z.B. "Max Mustermann" – filtert exakte Übereinstimmungen
RegEx-Muster: z.B. /\d{2}\.\d{2}\.\d{4}/ – filtert Muster (muss mit / beginnen und enden)

Beispiel CSV-Datei

text,category
"/\d{4}-\d{2}-\d{2}/",date
"/\d{2}\.\d{2}\.\d{4}/",date
"Max Mustermann",name
"Stuttgart",city

Einstellungen

Einstellung	Parameter	Standard	Beschreibung
CSV-Datei	`csvFile`	keiner	Pflichtangabe. Pfad oder UUID der CSV-Datei, die die zu filternden Begriffe enthält. Die CSV-Datei muss die Spalten `text` und `category` in der Kopfzeile haben.
Groß-/Kleinschreibung ignorieren	`caseInsensitive`	`true`	Legt fest, ob bei der Suche nach Übereinstimmungen die Groß-/Kleinschreibung ignoriert werden soll. true: Groß-/Kleinschreibung wird ignoriert (z. B. findet "max mustermann" auch "Max Mustermann") false: Groß-/Kleinschreibung wird beachtet
Fuzzy-Matching aktivieren	`fuzzyMatching`	`true`	Aktiviert die unscharfe Suche (Fuzzy-Matching), die auch ähnliche Schreibweisen findet. true: Ähnliche Schreibweisen werden erkannt (z.B. "Stuttgard" wird als ähnlich zu "Stuttgart" erkannt) false: Nur exakte Übereinstimmungen werden gefunden
Fuzzy-Schwellenwert (%)	`fuzzyMatchingThresholdPercent`	80	Schwellenwert für die Fuzzy-Matching-Übereinstimmung in Prozent. Je höher der Wert, desto ähnlicher müssen die Begriffe sein, um als Treffer zu gelten. Werte von 0 bis 100 sind möglich.
Text für Test	`testText`	keiner	Testtext zum Ausprobieren der Filterfunktion. Dieser Parameter wird nur in der Konfigurationsoberfläche verwendet und hat keinen Einfluss auf die Laufzeit.

In einer KI-Voreinstellung verwenden

Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
Wählen Sie die gewünschte KI-Voreinstellung aus und klicken Sie Bearbeiten.
Scrollen Sie zum Bereich KI-Handler und klicken Sie auf KI-Handler hinzufügen.
Wählen Sie den KI-Handler PII: Filter personal information with CSV in der Liste aus.
Speichern Sie die KI-Voreinstellung.
Ergebnis: Die Begriffe aus der CSV-Datei werden in Chats mit dieser KI-Voreinstellung vor der KI-Verarbeitung durch Platzhalter ersetzt und in der KI-Antwort wieder durch die ursprünglichen Werte ersetzt.

Kombination mit anderen Handlern

Frage	Antwort
Reihenfolge	Der Handler sollte früh in der Handler-Kette eingebunden werden, damit sensible Daten gefiltert werden, bevor sie an andere Handler oder die KI gesendet werden.
Geeignete Kombinationen	Der Handler kann zusammen mit anderen Handlern in einer KI-Voreinstellung verwendet werden. Der Handler kann mit dem agorum_ai_history_compaction-Handler kombiniert werden – die Reihenfolge ist dabei flexibel, da beide unterschiedliche Aufgaben erfüllen.
Nicht kombinieren mit	Keine Besonderheiten bekannt.

Tipps und Fehlersuche

Verwenden Sie die integrierte Testfunktion in der Konfigurationsoberfläche, um die Filterwirkung vor dem Produktiveinsatz zu überprüfen.