# Pseudonymisierung
> Namen, Adressen und Kennungen verlassen Ihren Arbeitsbereich als Platzhalter, und die Antwort kommt mit den echten Werten zurück. Das Ersetzen ist reiner Algorithmus, ohne Modell dazwischen, und es lernt aus dem, was ein Modell in Ihrem eigenen Netz findet.
Wenn der KI-Assistent antwortet, geht die Frage an das Modell des Anbieters, den Sie angebunden haben. Mit eingeschalteter Pseudonymisierung sieht dieses Modell nie die Namen Ihrer Kundinnen und Kunden, ihre E-Mail-Adressen oder ihre IBANs. Das AI-Gateway von nexxus tauscht jeden dieser Werte gegen einen Platzhalter wie `Person 1` oder `Firma 1`, bevor die Anfrage hinausgeht, und setzt die echten Werte in die Antwort zurück, bevor Sie sie lesen.
Nehmen wir wieder Brandt & Söhne, den Installationsbetrieb aus [KI anbinden](/de/setup/connect-ai/). Das Modell für den Alltag läuft dort bei IONOS, einer Cloud in der EU, und da ist die Pseudonymisierung standardmäßig an. Eine Mitarbeiterin bittet um eine Zahlungserinnerung an eine Kundin. IONOS schreibt die Erinnerung an `Person 1` bei der `Firma 1`, und die Mitarbeiterin liest sie an Erika Musterfrau bei der Musterbau GmbH adressiert.
## Kein Modell dazwischen
Was das Gateway ersetzt, findet es per Tabelle und festen Mustern. Kein Modell entscheidet, ob ein Wort ein Name ist, und nichts wird geraten: Derselbe Text ergibt jedes Mal dieselben Platzhalter. Das Ersetzen kostet keine Tokens, und keine Anfrage wartet auf ein zweites Modell.
### Was ohne Modell erkannt wird
| Art | Erkannt an | Platzhalter |
|---|---|---|
| Personen | Partner, Kontakte und Mitarbeitende in nexxus. Ein Name nach „Herr“ oder „Frau“. | `Person 1` |
| Firmen | Partner in nexxus. Ein Name vor einer Rechtsform wie GmbH oder AG. | `Firma 1` |
| E-Mail | Das Format. Dateinamen wie `logo@2x.png` bleiben stehen. | `E-Mail 1` |
| Telefon | Internationale Nummern (`+49`, `0049`) und nationale mit Trennzeichen. Eine reine Ziffernfolge nur als deutsche Mobilnummer oder nach „Tel.“, „Fax“ und Ähnlichem. Ein Betrag (`%`, `€`) ist keine Telefonnummer. | `Telefon 1` |
| IBAN | Die Länge für das Land und die Prüfung nach ISO 13616 (mod 97). | `IBAN 1` |
| Adressen | Eine deutsche Straße mit Hausnummer (Straße, Weg, Gasse, Platz, Allee, Ring, Damm, Ufer), dazu Postleitzahl und Ort, wenn sie folgen. | `Adresse 1` |
| Kennungen | Steuer-ID (Prüfziffer nach ISO 7064 MOD 11,10, so gegliedert, wie das Finanzamt sie druckt, oder nach einer Bezeichnung), Sozialversicherungsnummer (Prüfziffer), Krankenversichertennummer (Prüfziffer, nach einer Bezeichnung), Kartennummer (Kartennetz und Luhn-Prüfung, gruppiert wie auf der Karte oder nach einer Bezeichnung). Ihre eigenen Muster. | `Nummer 1` |
| Geburtsdaten | Ein Datum nur nach einer Bezeichnung wie „geboren am“ oder „Geburtsdatum“. Fristen und Termine bleiben stehen. | `Geburtsdatum 1` |
| Begriffe | Ihre Begriffsregeln, zum Beispiel interne Projektnamen. | `Begriff 1` |
Ergebnisse von Werkzeugen werden genauso behandelt, mit einer Ergänzung: Felder, die einen Vornamen, einen Nachnamen, eine E-Mail-Adresse, eine Telefonnummer oder eine Steuernummer enthalten, werden ganz ersetzt, und ihre Werte danach auch überall sonst in derselben Anfrage.
Die Detektoren lassen lieber einen Wert durch, als einen falschen zu fangen. Ein falscher Treffer macht die Antwort kaputt: Ein Betrag oder eine Frist, aus der `Telefon 1` wurde, nützt dem Modell nichts. Für das, was durchrutscht, gibt es die lernende Prüfung weiter unten.
### Wie sich die Platzhalter verhalten
- **Lesbare Wörter, je Art durchnummeriert** in der Reihenfolge, in der sie zuerst vorkommen: `Person 1`, `Person 2`, `Firma 1`. Das Modell liest sie als Namen und schreibt sie zurück. Die Wörter sind in jeder Sprache deutsch, weil das Gateway einen einzigen Satz Bezeichnungen hat.
- **Stabil für das ganze Gespräch.** `Firma 1` bleibt in jedem Zug `Firma 1`, und eine einmal vergebene Nummer geht nie an einen zweiten Wert. Verschiedene Schreibweisen desselben Werts („0171 1234567“, „0171/1234567“) teilen sich einen Platzhalter.
- **Zurückgesetzt, wie auch immer das Modell sie schreibt**: `FIRMA 1`, `Firma1`, `[Firma 1]` und der Genitiv `Firma 1s` werden alle wieder zum echten Wert. Das Gateway setzt sie auch in Werkzeugaufrufen zurück, bevor ein Werkzeug läuft. Eine Suche nach `Person 1` sucht also nach dem echten Namen.
- **Eine Nummer, die die Tabelle nicht kennt, bleibt sichtbar.** Erfindet das Modell `Person 7`, lesen Sie `Person 7`.
## Es lernt von selbst
Regeln können nicht jeden Namen kennen. Jemand erwähnt einen Lieferanten, der noch nicht in nexxus steht, oder eine Kundennummer in einem Format, das kein Detektor kennt. Um solche Lücken zu finden, lässt nexxus eine Prüfung auf einem Modell laufen, dem Sie vertrauen: einem in Ihrem eigenen Netz oder einem bei Privatemode, wo das Modell in einer verschlüsselten Umgebung rechnet (Confidential Computing). Dieses Modell sitzt nie zwischen Ihren Leuten und dem Anbieter. Es liest nur hinterher mit, und was es findet, wird zu Regeln, die wieder ohne Modell laufen.
### Was die Prüfung macht
Alle zehn Minuten nimmt die Prüfung eine Stichprobe der Chatnachrichten, die Ihre Leute in den letzten 24 Stunden geschrieben haben (standardmäßig 25 %, nur Nachrichten ab 20 Zeichen). Das Modell der Prüfung listet auf, was es darin schützen würde, und nexxus vergleicht diese Liste mit dem, was das Gateway ersetzt hat:
- **Erkannt:** Das Gateway hatte es ersetzt. Das ist der Anteil, den die Übersicht zeigt.
- **Durchgerutscht:** Das Gateway hat es im Text gelassen. Daraus wird eine Frage, zusammen mit der Regel, die es gefangen hätte. Ging die Anfrage pseudonymisiert an einen Cloud-Anbieter, ist es außerdem eine Warnung.
- **Zu viel:** Das Gateway hat etwas ersetzt, das das Modell nicht aufgelistet hat, zum Beispiel einen Produktnamen, der wie eine Firma aussieht. Daraus wird eine Frage nach weniger Schutz.
Bevor eine Frage erscheint, testet nexxus ihre Regel an allen geprüften Texten. Die Frage sagt deshalb, wie oft sie treffen würde (Treffer in 3 Texten). Funde, die dieselbe Regel brauchen, werden zu einer Frage zusammengefasst.
### Wer antwortet
- **Die Person, deren Nachricht es war,** sieht im Chat unter dieser Nachricht eine Karte: Kurze Frage zur Pseudonymisierung, mit Ja, ersetzen, Nein und Nicht mehr fragen. Ein Ja fügt den Begriff, die Schreibweise oder das Muster sofort hinzu. Für mehr Schutz braucht es keinen Administrator.
- **Administratoren** entscheiden alles auf der Seite Pseudonymisierung, auch was der Chat nicht kann: weniger Schutz (eine Ausnahme) und Regeln für ein Feld eines Datensatzes, die über alle Datensätze reichen.
- **Niemand**, bei Schreibweisen bekannter Datensätze. Findet die Prüfung „Muster-Bau“ für den Partner Musterbau GmbH, wird die Schreibweise ohne Rückfrage zur Regel, weil sie nur Schutz hinzufügt. Das lässt sich mit Schreibweisen bekannter Datensätze ohne Rückfrage übernehmen abschalten.
### Der Schutzprompt
Im Reiter Schutzprompt schreiben Sie in eigenen Worten auf, was nie hinausgehen darf: „Unsere Projektnamen Falke und Leuchtturm sind intern. Patientennummern sehen aus wie P-123456.“ Regeln vorschlagen liest den Text einmal mit dem Modell der Prüfung und markiert jede Stelle: wird eine Regel, nur Prüfung (keine feste Regel möglich, die Prüfung achtet darauf) oder gibt es schon. Sie übernehmen die Vorschläge, die Sie wollen. Das ist der einzige Modelllauf. Danach arbeiten die Regeln ohne Modell, und normale Anfragen kosten dafür keine Tokens.
### Die Zahl und die nächsten Schritte
Die Übersicht zeigt, wie viel von dem, was die Prüfung gefunden hat, die Regeln erkennen: der gefundenen Angaben automatisch erkannt. Das Ziel sind 95 %. Solange die Prüfung keine Texte gelesen hat, gibt es keine Zahl, nur Noch nichts geprüft. Ein neuer Arbeitsbereich startet also nie mit einer Schätzung.
Darunter listet die Karte So steigt die Erkennung auf, was zu tun ist, in dieser Reihenfolge:
1. Was die Prüfung am Messen hindert: Pseudonymisierung ausgeschaltet, kein sicheres Modell, keins gewählt oder das gewählte nicht mehr eingerichtet, Prüfung ausgeschaltet, Budget für heute verbraucht.
2. Zu wenige gefundene Werte für eine verlässliche Zahl (sie braucht 10). Mit einem höheren Stichprobenanteil geht es schneller.
3. Offene Fragen.
4. Die Arten, bei denen am meisten durchrutscht, höchstens drei, jede mit dem passenden Schritt: ein Partner oder eine Begriffsregel für Namen, eine Musterregel für Nummern mit festem Aufbau, der Schutzprompt für interne Begriffe. Verteilt sich das Durchgerutschte so dünn, dass keine Art heraussticht, ist der Schritt ein höherer Stichprobenanteil.
5. Ein Schutzprompt, wenn es noch keinen gibt, und Schreibweisen, die auf eine Antwort warten.
Jeder Schritt hat einen Knopf, der dorthin führt, wo er erledigt wird. Sind 95 % erreicht, bleiben nur noch die Hindernisse.
## Bevor Sie beginnen
- Die Rolle Administrator. Die Seite Pseudonymisierung ist nur für Administratoren, weil sie die ersetzten Werte zeigen kann.
- Mindestens ein angebundener Anbieter, siehe [KI anbinden](/de/setup/connect-ai/).
- Für die lernende Prüfung: ein Modell in Ihrem eigenen Netz (ein OpenAI-kompatibler Endpunkt auf einem privaten Host, zum Beispiel Ollama oder vLLM) oder ein Modell bei Privatemode. Ohne ein solches Modell funktioniert das Ersetzen genauso, aber die Prüfung misst nichts.
## Einschalten
1. Öffnen Sie und dort den Reiter Einstellungen. Stellen Sie im Abschnitt Pseudonymisierung den Punkt KI-Anfragen pseudonymisieren auf An und klicken Sie auf Speichern.
Steht er auf Nur zählen, geht jede Anfrage im Klartext hinaus, und das Gateway zählt nur, was es ersetzt hätte.
2. Lassen Sie Anbieter außerhalb der EU immer pseudonymisieren eingeschaltet. Der Schalter ist von Anfang an an und setzt jeden Anbieter außerhalb der EU auf Immer, auch einen, der auf Nie oder Standard aus steht.
3. Öffnen Sie und einen Anbieter. Wählen Sie unter Pseudonymisierung, wie sie gilt:
| Einstellung | Im Chat |
|---|---|
| Immer | Erkannte Namen und Kennungen gehen nur als Platzhalter hinaus. Im Chat nicht abschaltbar. |
| Standard an | Neue Chats starten pseudonymisiert. Jede Person kann es für ein Gespräch abschalten. |
| Standard aus | Neue Chats starten im Klartext. Jede Person kann es einschalten. |
| Nie | Das Modell sieht immer Klartext. Gedacht für Modelle im eigenen Netz. |
| Automatisch | Richtet sich danach, wo der Anbieter rechnet, siehe unten. |
Automatisch ist der Startwert jedes Anbieters:
| Wo der Anbieter rechnet | Automatisch heißt |
|---|---|
| Eine Cloud außerhalb der EU: OpenAI, Anthropic, Google und jede andere Cloud, OpenAI-kompatible Cloud-Endpunkte eingeschlossen | Immer |
| Eine Cloud in der EU: IONOS, Scaleway | Standard an |
| Privatemode | Standard aus |
| Ihr eigenes Netz | Nie |
4. Wählen Sie im Reiter Einstellungen unter Modell der Prüfung das Modell und speichern Sie. Wählbar sind nur Modelle in Ihrem Netz und bei Privatemode. nexxus nimmt genau dieses Modell für die Prüfung, die Vorschläge zum Schutzprompt und den Vergleich in der Sandbox, und kein anderes. Solange keins gewählt ist, pausiert die Prüfung.
Optional legen Sie unter Automatische Prüfung fest:
- Prüfung an
- Tokens pro Tag, standardmäßig 50.000
- Stichprobe der Nachrichten, standardmäßig 25 %
- Schreibweisen bekannter Datensätze ohne Rückfrage übernehmen
5. Wechseln Sie zum Reiter Übersicht. Der Status lautet Schutz aktiv. Arbeiten Sie So steigt die Erkennung von oben ab.
6. Schreiben Sie im Reiter Schutzprompt den Schutzprompt, klicken Sie auf Regeln vorschlagen und übernehmen Sie die Vorschläge.
## Was Ihr Team im Chat sieht
Im Eingabebereich des Chats zeigt ein Chip, wie das Gespräch hinausgeht: Pseudonymisiert, Klartext oder Eigenes Netz. Steht der Anbieter auf Standard an oder Standard aus, schaltet ein Klick darauf für dieses Gespräch um.
Jede Antwort zeigt ihren Datenweg. Bei einem pseudonymisierten Zug steht an der Station des Gateways „Ersetzt erkannte Namen und Kennungen durch Platzhalter und setzt sie in der Antwort zurück“, und Ersetzt zählt, was getauscht wurde. Platzhalter erscheinen im Chat nicht, weil die Antwort schon zurückgesetzt ankommt. Wie man eine Antwort liest, steht unter [Mit dem KI-Assistenten arbeiten](/de/use/assistant/#eine-antwort-lesen).
## Die Seite Pseudonymisierung
bündelt alles auf einer Seite mit acht Reitern. Der Menüpunkt zählt offene Fragen und Warnungen, damit sie nicht warten, bis jemand die Seite öffnet.
| Reiter | Was Sie dort finden |
|---|---|
| Übersicht | Den erkannten Anteil, die Lernkurve (Anteil je Tag, mit einer Marke, wo sich der Schutzprompt geändert hat), die Zahlen von heute (heute pseudonymisiert, zu viel ersetzt, ging im Klartext raus, offene Fragen, Prüfbudget heute), den Anteil Je Art und die nächsten Schritte. Bericht exportieren speichert das als Datei, zum Beispiel für eine Prüfung durch Dritte. |
| Fragen | Was die Prüfung gefunden hat und Stimmen aus Chats, jeweils mit ihrer Regel und wie oft sie treffen würde. Übernehmen oder Ablehnen; bei weniger Schutz Nicht mehr ersetzen oder Weiter ersetzen. Jetzt prüfen startet sofort einen Prüflauf. |
| Warnungen | Daten, die im Klartext an ein Modell außerhalb Ihres Netzes gingen, obwohl die Pseudonymisierung an war: nach dem Ersetzen noch in der Anfrage, oder von der Prüfung gefunden, ohne dass eine Regel sie kannte. |
| Regeln | Was nexxus ersetzt, ohne ein Modell zu fragen, mit Herkunft und Treffern in 30 Tagen. Bei den eingebauten steht Eingebaut, gilt immer. Regel anlegen, Archivieren, Exportieren. |
| Ersetzt | Was in den letzten 30 Tagen ersetzt wurde. Die Werte bleiben verborgen bis Werte anzeigen, und das Anzeigen wird protokolliert. Einträge verschwinden mit ihrem Gespräch. |
| Schutzprompt | Ihre eigenen Worte, die vorgeschlagenen Regeln und frühere Fassungen unter Verlauf. |
| Sandbox | Fügen Sie einen Text ein und sehen Sie, was das Modell bekäme. Nichts geht an ein Modell, außer Sie klicken auf Vergleichen: Dann läuft dieselbe Frage einmal im Klartext und einmal pseudonymisiert auf dem Modell der Prüfung, und Sie sehen, ob die Antwort schlechter wird. |
| Einstellungen | Die beiden Schalter der Pseudonymisierung, das Modell der Prüfung und wie viel sie liest. Gespeichert wird erst mit Speichern, Verwerfen holt den gespeicherten Stand zurück. |
### Eigene Regeln
Regel anlegen bietet drei Arten:
- **Begriff:** ein Wort oder eine Wendung, zum Beispiel ein Projektname.
- **Muster:** für Codes mit festem Aufbau. `#` ist eine Ziffer, `A` ein Großbuchstabe, `a` ein Kleinbuchstabe, `*` ein Buchstabe oder eine Ziffer, und alles andere steht für sich selbst: `KD-#####` fängt `KD-20417`. Ein Muster ist 3 bis 40 Zeichen lang und enthält mindestens drei von `#`, `A`, `a` und `*`. nexxus schickt dem Gateway nie einen regulären Ausdruck, so dass keine Regel es ausbremsen kann.
- **Ausnahme:** ein Wert, der nie ersetzt wird, auch wenn ein Muster oder ein Datensatz passt. Sie bedeutet weniger Schutz, und der Dialog sagt das.
Eine Regel gilt für den ganzen Arbeitsbereich. Schreibweisen von Datensätzen und Regeln für Felder eines Datensatzes kommen aus den Fragen, nicht aus diesem Dialog. Eine Schreibweise teilt sich den Platzhalter ihres Datensatzes.
## Was im Hintergrund passiert
- **Eine Tabelle je Gespräch.** Das Gateway hält die Paare aus Wert und Platzhalter neben dem Verlauf des Gesprächs, so dass ein späterer Zug auch Platzhalter aus früheren Zügen zurücksetzt.
- **Kein ungeschützter Ausweg.** Scheitert das Ersetzen, scheitert die Anfrage, statt im Klartext hinauszugehen. Ist nexxus für das Wörterbuch nicht erreichbar, nimmt das Gateway das zuletzt abgeholte.
- **Ein zweiter Blick vor dem Senden.** Nach dem Ersetzen durchsucht das Gateway die Anfrage noch einmal nach geschützten Werten. Was es dann noch findet, wird eine Warnung.
- **Nur zählen heißt nur zählen.** In diesem Modus erledigt das Gateway dieselbe Arbeit an einer Kopie, zählt, was es ersetzt hätte, und schickt die Anfrage unverändert.
- **Bilder und Dateien werden nicht pseudonymisiert.** Das Gateway zählt sie und reicht sie durch. Text in einem Bild erreicht das Modell, wie er ist.
- **Die Prüfung bleibt auf dem gewählten Modell.** Vor jedem Aufruf prüft nexxus noch einmal, dass es in Ihrem Netz oder bei Privatemode läuft. Ist es dort nicht mehr eingerichtet, pausiert die Prüfung, statt auf ein anderes Modell auszuweichen. Sie hört auch auf, wenn das Token-Budget des Tages verbraucht ist.
## Wenn etwas nicht klappt
- **Die Übersicht zeigt Noch nichts geprüft.** Die Karte So steigt die Erkennung nennt den Grund. Meistens: „Die Prüfung braucht ein Modell in eurem Netz oder bei Privatemode. Keins ist eingerichtet, deshalb misst sie nichts.“ Richten Sie ein solches Modell ein, wie unter [Modelle auf eigenen Servern](/de/setup/connect-ai/#modelle-auf-eigenen-servern) beschrieben.
- **„Für die Prüfung ist noch kein Modell gewählt. Bis eins gewählt ist, misst sie nichts.“** Wählen Sie es im Reiter Einstellungen unter Modell der Prüfung.
- **„Das gewählte Modell der Prüfung ist nicht mehr in eurem Netz oder bei Privatemode eingerichtet.“** Der Anbieter wurde abgeschaltet, gelöscht oder rechnet nicht mehr in Ihrem Netz. Wählen Sie unter Einstellungen ein anderes Modell, oder richten Sie den Anbieter wieder ein. Bis dahin pausieren die Prüfung, die Vorschläge zum Schutzprompt und der Vergleich in der Sandbox.
- **„Das Prüfbudget für heute ist verbraucht. Morgen geht es weiter, oder ihr erlaubt mehr Tokens am Tag.“** Erhöhen Sie Tokens pro Tag unter Einstellungen, oder warten Sie bis zum nächsten Tag.
- **Ein Name ging im Klartext hinaus.** Er steht unter Warnungen. Zur Frage führt zur Regel, die ihn fangen würde. Gibt es keine Frage, legen Sie eine Begriffsregel an, oder legen Sie die Person als Kontakt in nexxus an. Dann erkennt nexxus den Namen von selbst.
- **Es wird zu viel ersetzt**, zum Beispiel ein Produktname mit einer Rechtsform darin. Beantworten Sie die Frage mit Nicht mehr ersetzen, oder legen Sie eine Ausnahme an.
- **Die Antwort zeigt einen Platzhalter** wie `Person 7`. Das Modell hat eine Nummer geschrieben, die die Tabelle nicht kennt. Fragen Sie noch einmal, oder sehen Sie in der Sandbox nach, was das Modell bekommen hat.
- **„Pseudonymisierung konnte nicht umgeschaltet werden“** im Chat. Der Text nach dem Doppelpunkt nennt den Grund. Laden Sie die Seite neu und schalten Sie noch einmal um.
## Wie es weitergeht