Zum Inhalt

Entwurf

Diese Seite ist noch nicht freigegeben und nicht am Bildschirm geprüft. Bezeichnungen und Abläufe können noch abweichen.

KI einrichten

Wozu: SOPHA kann ein KI-Modell eines Anbieters einbinden. Hier richtet der Administrator den Zugang ein, setzt ein Budget und gibt die einzelnen KI-Funktionen frei. Eine KI-Funktion heißt hier Skill.

Hinkommen: Menü Einstellungen › KI.

Das Haus braucht dafür einen eigenen Zugang bei einem KI-Anbieter (einen API-Schlüssel). Jeder Aufruf kostet Geld. Ohne aktiven Zugang gibt es keine KI-Funktionen: Das Fragezeichen der Hilfe fehlt in der Kopfleiste, F1 zeigt nur das Handbuch, und der Knopf „KI-Vorschlag“ in der Pfandbewertung ist gesperrt.

Die KI arbeitet an zwei Stellen im Programm. In beiden Fällen schlägt sie nur vor; entscheiden muss der Mensch.

Aufbau

  1. Ein Satz zur Seite.
  2. Ein Statusband:

    • „Bereit — Anbieter …“ mit der Zahl der Kapitel Programmbeschreibung und je Skill einem Kennzeichen. Grün heißt benutzbar; ein graues Kennzeichen nennt den Grund im Tooltip.
    • „Es ist kein aktiver KI-Zugang eingerichtet. Ohne Zugang gibt es keine KI-Funktionen.“
    • „Der Status ist nicht abrufbar: Ihnen fehlt das Recht „KI-Frage stellen“.“
    • „Das KI-Modul ist zurzeit nicht erreichbar.“

    „Neu laden“ fragt den Status erneut ab.

  3. Die Reiter Zugang und Skills. Jeden Reiter sieht nur, wer das Recht dazu hat (siehe Rechte). Fehlen beide Rechte, steht dort nur „Für die KI-Einstellungen fehlt Ihnen das Recht (Anbieter verwalten oder Skills freischalten).“

Reiter „Zugang“

Zugang zum KI-Anbieter. Die eingerichteten Zugänge mit Bezeichnung, Anbieter und dem Schlüssel, nur maskiert. Dazu Kennzeichen: „aktiv“ oder „inaktiv“, „Primärer Zugang“, „Schlüssel vom …“, „geprüft am …“ und „AVV bestätigt am …“. „Zugang erneut prüfen“ prüft den hinterlegten Schlüssel beim Anbieter. Hat der Anbieter einen Fehler gemeldet, steht er als „Letzter Fehler“ darunter. Ohne Zugang steht dort „Noch kein Zugang eingerichtet.“

API-Schlüssel. So richtet man einen Zugang ein:

  1. Anbieter wählen, bei Bedarf eine Bezeichnung eingeben.
  2. Den Schlüssel in API-Schlüssel einfügen.
  3. Primärer Zugang angehakt lassen oder abwählen.
  4. „Schlüssel speichern und prüfen“ (oder Enter im Schlüsselfeld).

SOPHA prüft den Schlüssel sofort beim Anbieter; das kostet keine Token. Nur bei Erfolg wird der Zugang aktiv: „Der Zugang wurde geprüft und ist aktiv.“ Sonst: „Der Anbieter hat den Zugang abgelehnt: …“. Danach ist das Feld wieder leer. Der Schlüssel wird nie wieder angezeigt, nur maskiert.

Budget. Erscheint, sobald ein Zugang eingerichtet ist, und gilt für den primären Zugang.

  • Budget (EUR): Grenze für den Zeitraum. 0 löscht die Grenze.
  • Warnschwelle (EUR): ab hier warnt SOPHA.
  • Zeitraum: „kein Budget“, „je Tag“, „je Monat“, „je Jahr“ oder „gesamt“.
  • Gilt ab: ab diesem Tag wird gezählt; bei „gesamt“ ist das die einzige Grenze.
  • „Budget speichern“.

Überschreitet ein Aufruf die Warnschwelle, steht unter seiner Antwort ein Hinweis. Ist das Budget ausgeschöpft, weist SOPHA den nächsten Aufruf ab. Geprüft wird gegen das schon Verbrauchte; der letzte Aufruf vor der Grenze läuft deshalb noch ganz durch.

Modelle im Katalog. Die Modelle des Anbieters mit Kontext, Bilder, Effort, Schema, Preis je Mio. Tokens (ein / aus) und aktiv. Nur zur Anzeige.

Reiter „Skills“

Je Skill eine Karte. Im Kopf stehen der Name und Kennzeichen: „benutzbar“ oder „gesperrt“, die Datenschutzklasse „öffentlich“ oder „sensibel“, „Opt-In nötig“, „mit Bildern“, „strukturierte Antwort“ und „eigene Einstellung“ bzw. „Katalogvorgabe“. Darunter sagt die Beschreibung, was an den Anbieter geht. Ist der Skill gesperrt, nennt ein Band den Grund.

Skill Klasse Freigabe nötig
Anwenderhilfe öffentlich nein
KI-Pfandbewertung sensibel ja

Der Skill „Freie Frage“ steht bis zur nächsten Ausbaustufe der KI weder in dieser Liste noch im Statusband.

Einstellungen je Skill:

  • Aktiv: aus = der Skill ist für diesen Mandanten stillgelegt.
  • Freigabe (Opt-In): die ausdrückliche Zustimmung des Hauses, siehe unten. Danach steht „freigegeben am …“ darunter.
  • Modell und Effort: leer („Vorgabe“) gilt die Vorgabe des Katalogs. Das vorgegebene Modell steht unter dem Feld Modell.
  • Max. Tokens.
  • Protokoll: was SOPHA von Frage und Antwort aufbewahrt. „keins“: nichts; „gekürzt“: die ersten 500 Zeichen; „voll“: alles.
  • Aufbewahrung (Tage): Danach leert SOPHA die aufbewahrten Inhalte. Zeitpunkt, Modell, Token und Kosten des Aufrufs bleiben, denn aus ihnen rechnet SOPHA das Budget. 0 oder leer: ohne Frist.
  • Budget (EUR) und Zeitraum: ein eigenes Budget des Skills innerhalb des Budgets beim Anbieter. Eine Warnschwelle hat es nicht.

„Speichern“ wird erst wählbar, wenn sich an der Karte etwas geändert hat.

Skill freigeben

Wer bei einem Skill mit „Opt-In nötig“ die Freigabe (Opt-In) einschaltet, bekommt den Dialog „Skill „…“ freigeben“. Er zeigt unter „Was an den KI-Anbieter geht“ die Beschreibung des Skills und erinnert: Mit der Freigabe bestätigt man, dass mit dem Anbieter ein Auftragsverarbeitungsvertrag (AVV) besteht. Zeitpunkt und Benutzer der Freigabe hält SOPHA fest.

  • „Freigeben“ gibt den Skill frei und speichert sofort.
  • „Abbrechen“ lässt die Freigabe aus.

Datenschutz

An den Anbieter geht nur, was der Skill braucht:

  • Anwenderhilfe: die Programmbeschreibung, die Frage und die Stelle im Programm. Keine Kunden- oder Geschäftsdaten.
  • KI-Pfandbewertung: die Beschreibung der Ware, die erfassten Warendaten mit Kategorien und Stichwörtern, höchstens vier Fotos und die Pfandkurse des Hauses. Keine Kundendaten. Auch die Werte, die der Mitarbeiter schon eingetragen hat, gehen bewusst nicht mit; der Vorschlag soll unabhängig sein. Fotos können aber Gravuren oder Personen zeigen; deshalb ist der Skill „sensibel“ und braucht die Freigabe. Den Vorschlag selbst beschreibt Pfandbewertung › KI-Vorschlag.

Rechte

Recht Code wofür
KI-Anbieter und Schluessel verwalten $23E3 Reiter „Zugang“
KI-Skills freischalten und einstellen $23E5 Reiter „Skills“
KI-Frage stellen $23E4 Statusband; die Hilfe zur Bedienung
  • Ohne „KI-Frage stellen“ bleiben für den Benutzer alle KI-Funktionen aus, auch der KI-Vorschlag in der Pfandbewertung.
  • Den KI-Vorschlag steuert zusätzlich das Recht „KI-Bewertungsvorschlag anfordern“ ($110B), siehe Pfandbewertung.

Die übrigen Einstellungen des KI-Moduls stehen im Katalog Einstellungen.

Siehe auch

Gilt für SOPHA NG 1.0 · Stand 2026-10-24