Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI KI-Handler einrichten
PII: Filter personal information with AI
Technischer Name: agorum_ai_pii_ai_filter
Anzeigename: PII: Filter personal information with AI
Was macht der Handler?
Der Handler agorum_ai_pii_ai_filter dient zur automatischen Pseudonymisierung und Re-Identifizierung von personenbezogenen Daten (PII - Personally Identifiable Information) in KI-Anfragen und -Antworten.
Funktionsweise
Der Handler arbeitet in zwei Phasen:
- 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. - 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
Hinweis: Firmendaten wie Firmenname, Firmenadresse, geschäftliche Telefonnummern und E-Mail-Adressen (z.B. info@, contact@) werden absichtlich nicht gefiltert.
Empfohlener Einsatzzweck
Der Handler eignet sich optimal für folgende Szenarien:
- 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.
Einstellungen
| Parameter | Beschreibung |
|---|---|
| KI-Voreinstellung (Pflicht) |
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 (Optional) |
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 (Optional) |
Steuert, ob die Erkennung Groß-/Kleinschreibung ignoriert und separate Platzhalter für Schreibvarianten erstellt.
true |
| Fuzzy-Matching aktivieren (Optional) |
Aktiviert die unscharfe Suche (Fuzzy Matching) mittels Levenshtein-Distanz, um auch ähnliche Varianten zu finden.
true |
| Fuzzy-Schwellenwert (Optional) |
Schwellenwert für das Fuzzy Matching. Der Wert liegt zwischen 0 und 100 Prozent, wobei höhere Werte eine engere Übereinstimmung erfordern. Standard: 80% |
Tipp: Mit der Test-Funktion in der Konfigurationsoberfläche können Sie die Filterung direkt mit einem Beispieltext ausprobieren und das Ergebnis prüfen.
Verwendung in KI-Voreinstellungen
Der Handler agorum_ai_pii_ai_filter kann und sollte mit anderen KI-Handlern kombiniert werden. Dabei ist die Reihenfolge wichtig:
Der PII-Filter sollte vor anderen Handlern ausgeführt werden, damit sensible Daten bereits anonymisiert sind, bevor andere Handler diese verarbeiten.
Achtung: 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.