Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > ALBERT | AI MATVIS

ALBERT | AI MATVIS einrichten

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

Diese Dokumentation beschreibt die Einrichtung des MATVIS PII-Filter-Handlers in ALBERT | AI. Der Handler ermöglicht die automatische Anonymisierung personenbezogener Daten bei der Nutzung von KI-Sprachmodellen.

Die Einrichtung von ALBERT | AI MATVIS besteht aus folgenden Schritten:

  1. MATVIS einrichten, API-Key und Config-ID bereit halten.
  2. Plugin ALBERT | AI MATVIS in agorum core pro zusätzlich zum Plugin ALBERT | AI installieren.
  3. Einen neuen KI-Handler für MATVIS einrichten, siehe KI-Handler einrichten.
  4. Den neuen KI-Handler in KI-Voreinstellungen verwenden, siehe Verwendung in KI-Voreinstellungen.

Tipp: Sie können zusätzlich weitere KI-Handler ergänzend zu ALBERT | AI MATVIS verwenden. Die beiden folgenden ALBERT | AI KI-Handler ermöglichen ggf. die Pseudonymisierung und Re-Identifizierung weiterer persönlicher Daten:

KI-Handler einrichten

Die Einrichtung des MATVIS-Handlers erfolgt über die KI-Handler-Verwaltung in ALBERT | AI.

Neue KI-Handler-Konfiguration erstellen

  1. Öffnen Sie ☰ > Administration > Konfiguration > KI-Handler.
  2. Klicken Sie auf die Schaltfläche + (Plus), um eine neue Handler-Konfiguration zu erstellen.
  3. Optional: Wählen Sie ein Konfigurationsprojekt aus, um die Konfiguration in einem Projekt zu speichern.
  4. Geben Sie einen Namen für die Handler-Konfiguration ein, z. B.: matvis-pii-filter
  5. Klicken Sie auf Speichern.
  6. Wählen Sie die neue Konfiguration aus und klicken Sie auf Bearbeiten.

 

Einstellungen für den MATVIS-KI-Handler

 

Allgemeine KI-Handler-Einstellungen

Im Konfigurationsfenster geben Sie folgende allgemeine Einstellungen an:

Einstellung Beschreibung
Anzeigename Der für Benutzer sichtbare Name (bereits vorausgefüllt), z. B.: agorum_doc_test_matvis-pii-filter
Beschreibung Eine optionale Beschreibung.
Diese Konfiguration ist aktiv Aktivieren Sie diese Option, um den Handler verwenden zu können.
KI-Handler Wählen Sie in der Auswahlliste den KI-Handler Filtert und anonymisiert sensible Daten über die MATVIS API aus.
Zugriffsrechte: Benutzergruppe Wählen Sie die Benutzergruppe aus, die diese Handler-Konfiguration verwenden darf.

MATVIS-spezifische KI-Handler-Einstellungen

Nach Auswahl des MATVIS-Handlers (Filtert und anonymisiert sensible Daten über die MATVIS API) erscheinen die spezifischen Einstellungen. 

 

Einstellungen für die MATVIS-Zugangsdaten

Einstellung Beschreibung
API-Schlüssel Ihr MATVIS API-Schlüssel. Dieses Feld ist ein Pflichtfeld und wird verschlüsselt gespeichert. Klicken Sie auf das Auge-Symbol, um den API-Key sichtbar zu machen.
Konfigurations-ID Ihre MATVIS Konfigurations-ID. Die Konfigurations-ID bestimmt, welche PII-Kategorien erkannt werden. Dieses Feld ist ein Pflichtfeld.
API-URL Die MATVIS API-URL. 

Standard: https://your-matvis-server/api/v1/filter/inbound

 

MATVIS-Filter-Einstellungen

Einstellung Beschreibung
Groß-/Kleinschreibung ignorieren Wenn aktiviert, werden gefilterte Werte unabhängig von der Groß-/Kleinschreibung in der KI-Antwort wiederhergestellt.
  • true: Groß-/Kleinschreibung wird ignoriert
  • false: Exakte Übereinstimmung der Schreibweise erforderlich
Standard: false
Fuzzy-Matching Aktiviert die unscharfe Suche (Fuzzy Matching) beim Wiederherstellen der Originalwerte. Dies ist hilfreich, wenn die KI leichte Variationen der Platzhalter zurückgibt (z. B. bei Tippfehlern in der KI-Antwort).
  • true: Unscharfe Suche aktiviert (empfohlen)
  • false: Nur exakte Übereinstimmungen

Standard: false

Hinweis: Berücksichtigen Sie, dass das Fuzzy-Matching die Verarbeitung bei großen Texten verlangsamen kann.
Fuzzy-Matching Schwellenwert Der Schwellenwert für die unscharfe Suche als Dezimalzahl zwischen 0 und 1. Je höher der Wert, desto genauer muss die Übereinstimmung sein. In der Oberfläche wird dieser Wert als Prozentwert (0-100%) eingegeben.
Standard: 80% Ähnlichkeit.

MATVIS-Einstellungen testen

Die Konfigurationsoberfläche bietet eine integrierte Testfunktion:

  1. Geben Sie im Feld Text zum Testen einen Beispieltext mit personenbezogenen Daten ein. Beispiel: 
    Bitte kontaktieren Sie Max Mustermann unter max.mustermann@example.com.
  2. Klicken Sie auf Test ausführen.

    Ergebnis: Im Feld Testergebnis wird der anonymisierte Text angezeigt. Beispiel: 

    Bitte kontaktieren Sie [[PERSON_692cfa10-7fb4-4274-926e-b487146ef241]] unter [[EMAIL_ADDRESS_dc849853-9211-4118-ae83-ffee70983ee1]].
  3. Optional: Variieren Sie den Test, um zusätzlich zu testen, dass die Groß- und Kleinschreibung ignoriert wird und auch Fuzzy-Treffer berücksichtigt werden. Beispiele: 
    Bitte kontaktieren Sie max Mustermann unter max.mustermann@beispiel.de.

MATVIS-Handler in KI-Voreinstellungen einbinden

Um den MATVIS-Handler zu verwenden, müssen Sie ihn in KI-Voreinstellungen einbinden:

  1. Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
  2. Wählen Sie die gewünschte KI-Voreinstellung aus und klicken Sie auf Bearbeiten.
  3. Scrollen Sie zum Bereich KI-Handler.
  4. Klicken Sie auf KI-Handler hinzufügen.
  5. Wählen Sie Ihre MATVIS-Handler-Konfiguration in der Handler-Liste aus.
  6. Klicken Sie auf Speichern.

    Ergebnis: Der neue  ALBERT | AI MATVIS KI-Handler wird jetzt für Chats und Automatisierungen mit dieser KI-Voreinstellung verwendet. Die 

Der Handler kann mit anderen Handlern kombiniert werden. Da er sensible Daten anonymisiert, bevor sie an die KI gesendet werden, sollte er in der Handler-Kette möglichst früh positioniert werden – also vor anderen Handlern, die den Eingabetext weiterverarbeiten.