PII: Filter personal information with CSV

Technischer Name: agorum_ai_pii_csv_filter

Anzeigename: PII: Filter personal information with CSV

Was macht der Handler?

Der Handler agorum_ai_pii_csv_filter 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.

Funktionsweise

Der Handler arbeitet in zwei Phasen:

1. Before-Hook (vor der KI-Verarbeitung): Sensible Daten werden im Eingabetext und in der Konversationshistorie durch Platzhalter ersetzt (z.B. [[NAME_uuid]], [[CITY_uuid]]).
2. 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

Empfohlener Einsatzzweck

Der Handler eignet sich besonders für:

• 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.

Einstellungen

Parameter	Beschreibung
CSV-Datei (Pflicht)	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 (optional)	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 Standard: true
Fuzzy-Matching aktivieren (optional)	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 Standard: true
Fuzzy-Schwellenwert (optional)	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. Standard: 80
Text für Test (optional)	Testtext zum Ausprobieren der Filterfunktion. Dieser Parameter wird nur in der Konfigurationsoberfläche verwendet und hat keinen Einfluss auf die Laufzeit.

Verwendung in KI-Voreinstellungen

Der Handler kann zusammen mit anderen Handlern in einer KI-Voreinstellung verwendet werden. Beachten Sie Folgendes:

• 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.
• Der Handler kann mit dem agorum_ai_history_compaction-Handler kombiniert werden – die Reihenfolge ist dabei flexibel, da beide unterschiedliche Aufgaben erfüllen.