KI-Handler PII mit KI

Der Handler dient zur automatischen Pseudonymisierung und Re-Identifizierung von personenbezogenen Daten (PII - Personally Identifiable Information) in KI-Anfragen und -Antworten.

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 AI
Technischer Handler-Name	agorum.ai.ai.filter (Name der Konfiguration: agorum_ai_pii_ai_filter)
Standardmäßig aktiv	ja
Eingriffspunkte (Hooks)	before, after

Wann verwenden

• Datenschutz-Compliance: Wenn personenbezogene Daten gemäß DSGVO nicht an externe KI-Dienste übermittelt werden dürfen.
• Sensible Dokumente: Bei der Verarbeitung von Dokumenten mit Kundendaten, Mitarbeiterinformationen oder anderen personenbezogenen Inhalten.
• Revisionssichere Umgebungen: In Umgebungen, in denen der Schutz personenbezogener Daten besonders wichtig ist.
• Anonymisierte KI-Analysen: Wenn KI-Analysen auf Textinhalten durchgeführt werden sollen, ohne dabei echte Personendaten preiszugeben.

Funktionsweise

Der Handler agorum_ai_pii_ai_filter arbeitet in zwei Phasen:

1. Vor der KI-Verarbeitung (Before-Hook): Sensible Daten wie Namen, E-Mail-Adressen, Telefonnummern, Geburtsdaten, Adressen, IBAN und Sozialversicherungsnummern werden mithilfe eines konfigurierbaren KI-Presets erkannt und durch Platzhalter ersetzt (z.B. [[NAME_uuid]]). Dadurch werden die eigentlichen personenbezogenen Daten nicht an die KI übermittelt.
2. Nach der KI-Verarbeitung (After-Hook): Die Platzhalter in der KI-Antwort werden wieder durch die ursprünglichen Originalwerte ersetzt, sodass der Benutzer eine vollständige und lesbare Antwort erhält.

Unterstützte Datentypen

Der Handler erkennt standardmäßig folgende Kategorien personenbezogener Daten:

• name: Personennamen (z.B. "Max Mustermann", "Dr. Maria Schmidt-Müller")
• birthdate: Geburtsdaten (nur Geburtsdaten, keine sonstigen Datumsangaben)
• street: Straßen mit Hausnummer (z.B. "Musterstraße 10")
• city: Postleitzahl und/oder Stadt (z.B. "12345 Musterhausen")
• phone: Private Telefonnummern
• email: Private E-Mail-Adressen
• iban: Bankverbindungen (IBAN)
• account: Kontonummern
• ssn: Sozialversicherungsnummern

Einstellungen

Einstellung	Parameter	Standard	Beschreibung
KI-Voreinstellung	presetName	keiner	Pflichtangabe. Name des KI-Presets, das zur Erkennung sensibler Daten verwendet wird. Das Preset analysiert den Text und gibt die gefundenen personenbezogenen Daten als JSON-Array zurück.
Zusätzlicher Kontext	additionalContext	keiner	Zusätzlicher Kontext, der an das KI-Preset übergeben wird. Kann verwendet werden, um die Erkennung zu verfeinern oder domänenspezifische Anweisungen zu geben.
Groß-/Kleinschreibung ignorieren	caseInsensitive	true	Steuert, ob die Erkennung Groß-/Kleinschreibung ignoriert und separate Platzhalter für Schreibvarianten erstellt. true: Schreibvarianten werden erkannt und separat ersetzt (z.B. "Max" und "MAX" werden beide gefunden). false: Nur exakte Übereinstimmungen werden gefunden.
Fuzzy-Matching aktivieren	fuzzyMatching	true	Aktiviert die unscharfe Suche (Fuzzy Matching) mittels Levenshtein-Distanz, um auch ähnliche Varianten zu finden. true: Ähnliche Varianten werden erkannt (z.B. Tippfehler oder leicht abweichende Schreibweisen). false: Nur exakte Übereinstimmungen werden erkannt.
Fuzzy-Schwellenwert (%)	fuzzyMatchingThresholdPercent	80 %	Schwellenwert für das Fuzzy Matching. Der Wert liegt zwischen 0 und 100 Prozent, wobei höhere Werte eine engere Übereinstimmung erfordern.

In einer KI-Voreinstellung verwenden

1. Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
2. Wählen Sie die gewünschte KI-Voreinstellung aus und klicken Sie Bearbeiten.
3. Scrollen Sie zum Bereich KI-Handler und klicken Sie auf KI-Handler hinzufügen.
4. Wählen Sie den KI-Handler PII: Filter personal information with AI in der Liste aus.
5. Speichern Sie die KI-Voreinstellung.

   Ergebnis: Personenbezogene Daten werden in Chats mit dieser KI-Voreinstellung vor der Übertragung an die KI durch Platzhalter ersetzt und in der KI-Antwort wieder durch die Originalwerte ersetzt.

Kombination mit anderen Handlern

Frage	Antwort
Reihenfolge	Der PII-Filter sollte vor anderen Handlern ausgeführt werden, damit sensible Daten bereits anonymisiert sind, bevor andere Handler diese verarbeiten.
Geeignete Kombinationen	Der Handler agorum_ai_pii_ai_filter kann und sollte mit anderen KI-Handlern kombiniert werden.
Nicht kombinieren mit	Keine Besonderheiten bekannt.

Tipps und Fehlersuche

• Mit der Test-Funktion in der Konfigurationsoberfläche können Sie die Filterung direkt mit einem Beispieltext ausprobieren und das Ergebnis prüfen.
• Stellen Sie sicher, dass das referenzierte KI-Preset korrekt konfiguriert ist und ein valides JSON-Format zurückgibt. Ohne funktionierendes Preset werden keine Daten gefiltert.