Dokumentation des KI:connect Administrations-Backend

HINWEIS: Die nachfolgende Dokumentation ist Work in Progress. Abweichungen zum aktuellen Deployment des KI:connect Administrations-Backend sind möglich.

Letzte Änderung: 2025-09-08


Wenn Sie als Administrator/in für Ihre Heimateinrichtung technische Fragen zur Administration von KI:connect haben, wenden Sie sich gerne an: servicedesk@itc.rwth-aachen.de


Zusätzlich haben wir eine Mailingliste für Administratorinnen und Administratoren angelegt, in der wir über wesentliche Meilensteine, technische Updates und aktuelle Anliegen informieren. Melden Sie sich gerne an!

Mailingliste für Admins

Inhalt

Vorbemerkung

Im Rahmen dieses Dokuments wird Ihre Hochschule oder Einrichtung durchgängig als “Heimateinrichtung” bezeichnet. Mit dem Begriff sind also alle Partnereinrichtungen von KI:connect gemeint, die den Dienst nutzen möchten.

1. Empfehlung: Reihenfolge der Arbeitsschritte

Wenn Ihre Heimateinrichtung noch nicht an KI:connect angeschlossen ist und dieser Anschluss nun stattfinden soll, empfehlen wir den folgenden Ablauf von Arbeitsschritten:


Phase

gap

Arbeitsschritte
Initiales Setup   i. Registrierung in der zuständigen DFN-Delegation
ii. Einrichtung des Shibboleth Logins
iii. Konfiguration der Firewall-Einstellungen
     
KI-Modelle einbinden   i. Registrierung von API-Endpunkten
ii. Konfiguration von Nutzendengruppen und Authentifizierungs-Regeln
iii. Deployment von KI-Modellen und Nutzungslimits
     
User Interface anpassen   i. Branding der UI
ii. Anpassung des Hilfemenüs


Alle Arbeitsschritte werden im weiteren Verlauf des Dokuments beschrieben.

2. Initiales Setup

Der Anschluss Ihrer Heimateinrichtung an KI:connect beginnt mit der Konfiguration der Shibboleth-Anmeldung. Dafür sind mehrere Schritte umzusetzen, die nachfolgend beschrieben werden.

2.1 Registrierung in der zuständigen Delegation im DFN-Verein

Der Dienst KI:connect nutzt für das Single Sign On die Authentifizierungs- und Autorisierungs-Infrastruktur für die Wissenschafts- und Bildungs-Community in Deutschland, die vom DFN-Verein als Identity Provider (IDP) betrieben wird. Damit können zugangsberechtigte Personen identifiziert und für den Dienst angemeldet werden.

KI:connect erwartet für das Berechtigungsmanagement derzeit den Namensraum des IDM.nrw. Dieses hat gemäß der URN-Registry im deutschen Forschungsnetz den Titel urn:geant:dfn.de:idm.nrw. Ihre Organisation sollte die Vorgaben dieses Namensraums erfüllen, um die Shibboleth Anmeldung für KI:connect nutzen zu können. Weitere Informationen zu den Namensräumen finden sich in der URN-Registry des DFN-Vereins.

2.2 Einrichtung des Shibboleth Logins

Um das SAML-basierte Shibboleth Login zu ermöglichen, müssen an der Heimateinrichtung verschiedene Attribute festgelegt werden. Die Namen der Attribute sind standardisiert und folgen dem eduPerson-Schema. Wenden Sie sich für Unterstützung an die/den IdM-Beauftragte/n in Ihrer Heimateinrichtung.

Die Konfiguration dieser Attribute an der Heimateinrichtung geschieht üblicherweise in einer Konfigurationsdatei oder in einer grafischen Benutzoberfläche zur Shibboleth Administration. Dort müssen für die zugangsberechtigten Nutzendengruppen mehrere Attribute eingetragen werden, die im Shibboleth-Sprech als “required” bezeichnet werden.

Die erforderlichen Attribute und weitere Schritte werden nachfolgend beschrieben.

2.2.1 Kontaktaufnahme zu KI:connect

Als nächster Schritt wird Ihre Heimateinrichtung durch das KI:connect Team für den Shibboleth Zugang freigeschaltet. Dazu muss Ihre Heimateinrichtung die technischen Ansprechpersonen benennen, mit denen wir zusammenarbeiten dürfen. Wir haben ein Kurzformular für Sie bereitgestellt, das die Kontaktdaten von KI:connect bereits enthält und komfortabel von Ihnen ergänzt werden kann:


Kurzformular für technische Ansprechpersonen


Setzen Sie sich dann gerne mit uns in Verbindung und fügen das ausgefüllte Formular Ihrer Mail als Anhang bei. Sie erreichen uns jederzeit über diese Mailadresse:


servicedesk@itc.rwth-aachen.de


Ihre im Kurzformular benannten technischen Ansprechpersonen können einen vorläufigen Zugriff auf das Administrations-Backend beantragen. Mit diesem Zugriff können alle nachfolgend beschriebenen Konfigurationsschritte vorgenommen werden, um den späteren Roll-Out zeitnah vorzubereiten, auch wenn der geschlossene Kooperationsvertrag mit der RWTH Aachen noch nicht vorliegt. Wenn der vorläufige Administrations-Zugriff gewünscht ist, kreuzen Sie einfach die entsprechende Checkbox im Kurzformular an.


Wichtig: Vor dem Eingang des Kooperationsvertrages dürfen keine weiteren Mitglieder Ihrer Heimateinrichtung Zugriff auf KI:connect und insbesondere das Frontend erhalten.


Sobald Ihr Kurzformular mit gesetztem Häkchen oder die Kombination aus Kurzformular und Kooperationsvertrag bei uns eingegangen ist, kann die Shibboleth-Freischaltung für Ihre Heimateinrichtung erfolgen. Ihre im Kurzformular benannten Ansprechpersonen werden darüber umgehend per Mail informiert.

Anschließend kann Ihre Heimateinrichtung alle weiteren Schritte zur Bereitstellung von KI:connect selbständig durchführen.


2.2.2 Shibboleth entityID

Für den Dienst KI:connect wird folgende Shibboleth entityID genutzt:

<EntityDescriptor entityID="https://genai.rwth-aachen.de/shibboleth"></EntityDescriptor>

Die Metadaten zum Dienst sind auch im Repository des DFN-AAI zu finden: https://www.aai.dfn.de/metadata/dfn-aai-sp-metadata.xml

2.2.3 Attribute für Frontend-Nutzende

Frontend-Nutzende sind Personen an der Heimateinrichtung, die Zugriff auf alle User-seitigen Funktionen der Web-Oberfläche https://chat.kiconnect.nrw/ erhalten sollen. Diese User können grundsätzlich alle Funktionen der Web-Oberfläche nutzen, aber keinen Zugriff auf das Administration-Backend erlangen.

Für Frontend-Nutzende sind folgende Attribute als “required” gekennzeichnet:

  • pairwise-id:
    urn:oasis:names:tc:SAML:profiles:pairwise-id

  • scoped affiliation:
    FriendlyName="eduPersonScopedAffiliation"
    Name="urn:oid:1.3.6.1.4.1.5923.1.1.1.9"

  • Rufname:
    FriendlyName="givenName"
    Name="urn:oid:2.5.4.42"

  • Nachname:
    FriendlyName="sn"
    Name="urn:oid:2.5.4.4"

2.2.4 Attribute für Administratorinnen und Administratoren

Administratorinnen und Administratoren sind Personen, die sowohl alle User-seitigen Funktionen der Web-Oberfläche als auch das Administration-Backend nutzen können. Für diese sind weitere Attribute erforderlich:

  • Entitlement für Admins:
    FriendlyName="eduPersonEntitlement"
    Name="urn:oid:1.3.6.1.4.1.5923.1.1.1.7"

Um später das Administrations-Backend zur Konfiguration für ihre Heimateinrichtung sehen zu können, muss ein Admin Account den folgende Wert für das eduPersonEntitlements haben:

  • eduPersonEntitlement für Einrichtungs-Admins:
    urn:geant:dfn.de:idm.nrw:<SCOPE>:role:rid=10000023-9:rname=ki_connect_Einrichtungsadmin

Achtung: Im oberen Konfigurationsstring steht <SCOPE> als Platzhalter für den Kontext der Heimateinrichtung. Üblicherweise ist dies einfach die Domain der Heimateinrichtung.

2.3 Konfiguration der Firewall-Einstellungen der Heimateinrichtung

Einzelne Partner von KI:connect haben von Fehlern im Zusammenhang mit einem Virtual Network bzw. der Firewall in Microsoft Azure berichtet, welche die Nutzung von KI:connect gestört haben. Die Fehlerursache wird nachfolgend beschrieben.

Für die meisten Heimateinrichtungen sieht der Datenfluss bei der Nutzung von KI:connect wie folgt aus:


In diesem Szenario hinterlegt die Heimateinrichtung beliebige API-Endpunkte zu KI-Anbietern im KI:connect Administrations-Backend. Die API-Endpunkte befinden sich im IT-Netz der KI-Anbieter, z.B. bei der GWDG oder in der Microsoft Azure Cloud. Zu keinem Zeitpunkt fließen hier Daten direkt von der Heimateinrichtung zum KI-Anbieter, sondern immer über KI:connect als Schnittstelle. Die Firewall der Heimateinrichtung muss in diesem Fall lediglich Verbindungen zu KI:connect zulassen, wofür üblicherweise keine Änderungen der Firewall-Konfiguration erforderlich sind.

Einige KI-Anbieter ermöglichen die Absicherung der angebotenen API-Endpunkte mit Firewall-Regeln, z.B. per IP Filtering. Heimateinrichtungen können können damit die Zugriff auf den Endpunkt beschränken, etwa auf IP-Adressen innerhalb der Heimateinrichtung zulassen. Dies ist z.B. im Rahmen der Microsoft Azure Services möglich. Der Datenfluss folgt dann einem anderen Schema:


Sind die Firewall-Regeln durch die Heimateinrichtung nicht korrekt, gesetzt, werden API-Verbindungen durch KI:connect vom KI-Anbieter abgelehnt, weil sich die Server von KI:connect außerhalb der eingestellten Firewall-Regeln befinden. Die Heimateinrichtung muss die Firewall des KI-Anbieters entsprechend konfigurieren. Für die Freigabe der KI:connect Produktivserver ist dazu folgende IPv4-Range zu verwenden:

IP-Range der KI:connect Produktivserver: 137.226.6.*

3. Administrations-Backend aufrufen

Der Aufruf des Administrations-Backend verläuft über die reguläre KI:connect Website unter https://chat.kiconnect.nrw/. Personen, die für das Administrations-Backend berechtigt sind, finden im Profil-Menü am unteren Rand in der linken Seitenleiste den Eintrag “Admin Einstellungen”. Dieser Eintrag wird normalen Usern nicht angezeigt. Ein Klick auf diesen Eintrag führt zum Administrations-Backend.

Die Vergabe der Administrations-Berechtigung wird in Abschnitt 2.2 Einrichtung des Shibboleth Logins beschrieben.


4. API-Endpunkte zu KI-Modellen registrieren

Hinweis: Die bislang beschriebene Einrichtung des Shibboleth Logins verlief außerhalb der KI:connect Web-Oberfläche. Alle weiteren Konfigurationen finden nun über das KI:connect Administrations-Backend statt, in das Sie sich zunächst einloggen müssen.


Nach dem Login in das Administrations-Backends wählen Sie zuerst den Menüpunkt “Zugangsdaten” in der linken Seitenleiste. Es werden dann die bereits hinterlegten API-Endpunkte angezeigt. Mit einem Klick auf das “Auge” Icon kann die URL der Endpunkte in der Tabelle angezeigt oder verborgen werden.


4.1 API-Endpunkt anlegen

Klicken Sie auf den Button “Neue Zugangsdaten”. Im angezeigten Dialog definieren Sie für jeden API-Endpunkt drei Parameter:

  1. Zugangsdaten Name: Der Name, der in allen übrigen Dialogen des Administrations-Backend für die Identifikation des Endpunktes angezeigt wird.

  2. Endpoint: Die URL des Endpunktes.

    Wichtig: In KI:connect ist üblicherweise die reine URL inklusive der Subdomain des Endpunkts einzutragen, aber ohne Subdirectories und ohne Parameter.

    Beispiel: Wenn Endpunkte im Microsoft Azure Dashboard angezeigt werden, wird häufig eine URL mit Subdirectories und Parametern erstellt. So könnte der von Azure angezeigte Endpunkt zu einem GPT-4o Modell wie folgt lauten:

    https://dev-aoairwthgpt-swe.openai.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2025-01-01-preview

    In KI:connect würde dieser Endpunkt zu einem Fehler führen. Als Endpunkt in KI:connect darf ausschließlich die URL samt Subdomain eingetragen werden. Letztere werden von KI:connect auf Basis der weiter unten beschriebenen Deployments automatisch ergänzt. Die KI:connect-kompatible Variante im obigen Beispiel wäre:

    https://dev-aoairwthgpt-swe.openai.azure.com

  3. API-Schlüssel: Geheimer String, der zur Authentifikation am Endpunkt übergeben wird. Der API-Schlüssel kann im KI:connect Administrations-Backend niemals angezeigt werden. Nach dem Speichern wird er immer über vier Sternchen repräsentiert.

Klicken Sie nach Eingabe der Parameter auf “Speichern”, um den neuen Endpunkt zu speichern. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.


4.2 API-Endpunkt bearbeiten

Sie können Name, URL und API-Key jedes Endpunktes bearbeiten. Klicken Sie dazu auf das “Stift” Icon. Es wird derselbe Dialog wie beim Anlegen eines Endpunktes angezeigt. Dort können Sie die Parameter des Endpunktes verändern. Klicken Sie zum Übernehmen der Änderungen den Button “Speichern”. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.


4.3 Löschen von API-Endpunkten

Klicken Sie auf ein “Papierkorb” Icon, um den zugehörigen Endpunkt zu löschen. In der daraufhin angezeigten Sicherheitsabfrage klicken Sie auf den Button “Löschen”, um den Endpunkt endgültig zu entfernen.

Achtung: Ein gelöschter Endpunkt kann nicht wiederhergestellt werden.


5. Konfiguration von Nutzendengruppen

Nach der Registrierung von API-Endpunkten müssen Nutzendengruppen eingerichtet und deren Zugriff auf die registrierten API-Endpunkte parametrisiert werden. Das dazu notwendige Vorgehen wird nachfolgend beschrieben.

5.1 Einrichtung von Nutzendengruppen

Nutzendengruppen dienen dazu, verschiedene Gruppen von Personen oder anderen Shibboleth-Entitäten voneinander unterscheiden zu können, z.B. Mitarbeitende und Studierende. Um Nutzendengruppen einzurichten, klicken Sie in der linken Seitenleiste auf den Menüpunkt “Nutzergruppen”.


5.1.1 Erstellung von Nutzendengruppen

Klicken Sie auf den Button Neue Gruppe, um eine neue Nutzendengruppe anzulegen. Im daraufhin angezeigten Dialog werden für diese Nutzendengruppe mehrere Parameter festgelegt, die nachfolgend beschrieben werden.


  1. Titel: Name für die neue Nutzendengruppe, der in allen übrigen Dialogen des Administrations-Backend für die Identifikation der Gruppe angezeigt wird.

  2. Hard Limit: Feste Budgetobergrenze der Nutzendengruppe pro Monat. Bei Erreichen des Limits wird der Zugang zu allen kostenpflichtigen KI-Modellen für alle Mitglieder der jeweiligen Gruppe automatisch gesperrt, so dass die Nutzendengruppe keine weiteren Kosten verursachen kann.

    Hinweis: Das Hard Limit kann nur greifen, wenn bei den KI-Modellen korrekte Angaben für Tokenkosten gemacht wurden. Deren Einstellung wird in Abschnitt 5.3 Deployment von KI-Modellen konfigurieren beschrieben.

  3. Dokumenten Upload Richtlinie: Schließlich können Sie für die Nutzendengruppe festlegen, wie viele Dokumente (z.B. PDF, DOCX, XLSX; abhängig vom jeweiligen KI-Modell) in einem Chat durch die User hochgeladen werden können.

    In beiden Upload-Richtlinien gibt es ein technisches Limit für die maximale Tokenzahl, die von der Summe aller hochgeladenen Dokumente nicht überschritten werden darf. Je nach Upload-Richtlinie kann ein sehr langes Dokument oder mehrere kürzere Dokumente dieses Limit überschreiten. Sobald Uploads diese Grenzen überschreiten, wird den Nutzenden eine entsprechende Meldung angezeigt und der Upload wird abgelehnt.

    Die Optionen für die Updload-Richtlinie sind:

    • Keine: Das Upload Icon im Chat-Fenster ist nicht verfügbar und es können einem Chat keine Dokumente beigefügt werden.
    • Einzelnes Dokument: Es kann genau ein Dokument pro Chat hochgeladen werden. Sobald ein Dokument hochgeladen wurde, wird das Upload Icon ausgegraut. Ein einmal hochgeladenes Dokument kann nicht mehr aus dem Chat entfernt werden.
    • Unbegrenzt Dokumente: Die Nutzenden können beliebig viele Dokumente hochladen.

  4. Aktiv: Ist der Schieber eingeschaltet, wird die Nutzendengruppe aktiv gesetzt. Enthaltene User können sich erfolgreich authentifizieren und alle für sie festgelegten Deployments von KI-Modellen nutzen. Ist der Schieber deaktiviert, schlägt die Nutzung von KI:connect für Mitglieder dieser Nutzendengruppe mit einer entsprechenden Informationsseite fehl.

Tipp für Admins: Die Schaltfläche Aktiv ermöglicht eine risikofreie Konfiguration von KI:connect sowohl in der initialen Roll-Out Phase als auch beim späteren Anlegen neuer Nutzendengruppen. Inaktive Nutzendengruppen sind im Administrations-Backend funktionsgleich mit aktiven Nutzendengruppen. Es können also alle gewünschten Parametrisierungen vorgenommen werden. Erst mit Aktivieren der Nutzendengruppe wird diese für das Frontend zugelassen.

Um das Anlegen der neuen Nutzendengruppe abzuschließen, klicken Sie auf den “Speichern”-Button. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.


5.1.2 Bearbeiten von Nutzendengruppen

Zum Bearbeiten einer Nutzendengruppe wählen Sie den Menüpunkt “Nutzergruppen” in der linken Seitenleiste. Klicken Sie dann auf das “Auge” Icon der gewünschten Nutzendengruppe. Daraufhin wird das Dialogfenster zur Konfiguration der Gruppen angezeigt. Klicken Sie hier auf den Button Gruppe bearbeiten.


Daraufhin wird der gleiche Dialog wie für das Anlegen von Nutzendengruppen angezeigt. Verändern Sie hier die gewünschten Parameter und klicken zum Übernehmen auf den Button “Speichern”. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.

5.1.3 Löschen von Nutzendengruppen

Zum Bearbeiten einer Nutzendengruppe wählen Sie den Menüpunkt “Nutzergruppen” in der linken Seitenleiste. Klicken Sie dann auf das “Papierkorb” Icon der gewünschten Nutzendengruppe. Daraufhin wird eine Sicherheitsabfrage angezeigt. Klicken Sie zum endgültigen Entfernen der Nutzendengruppe auf den Button “Löschen”.


Achtung: Das Löschen einer Nutzendengruppe entfernt auch alle für diese Nutzendengruppe eingerichteten Deployments von KI-Modellen. Eine gelöschte Nutzendengruppe inklusiver der eingerichteten Parametrisierungen und Deployments kann nicht wiederhergestellt werden. Deployments, für die keine Nutzendengruppen (mehr) existieren, werden automatisch auf “inaktiv” gesetzt.

5.2 Nutzendengruppe mit Authentifizierungs-Regeln verknüpfen

Nach dem Anlegen oder Bearbeiten einer Nutzendengruppe kehrt das Administrations-Backend nicht zur Tabelle der existierenden Nutzendengruppen zurück. Stattdessen wird nun die angelegte Gruppe angezeigt und weitere Konfigurationsschritte für die Gruppe angeboten.

Der Grund für dieses Vorgehen liegt darin, dass eine neu angelegte Nutzendengruppe zunächst lediglich eine “leere Hülle” ist, der noch keine Personen an Ihrer Heimateinrichtung zugeordnet sind. Diese Zuordnung wird nachfolgend beschrieben.

5.2.1 Einrichtung von Authentifizierungs-Regeln

Um einer Nutzendengruppe Personen oder anderen Shibboleth-Entitäten hinzuzufügen, ist die Verknüpfung der Gruppe mit Authentifizierungsregeln auf Basis der Shibboleth-Anmeldung notwendig. Um eine Authentifizierungsregel für die angezeigte Gruppe anzulegen, klicken Sie auf den Button “Neue Regel”.


KI:connect erlaubt zwei Arten von Authentifizierungs-Regeln, Affiliation und Entitlement. Diese werden nachfolgend erläutert:

  1. Affiliation: Die Authentifizierung erfolgt hier auf Basis der vom Identity Provider gelieferten eduPersonScopedAffiliation. Der Wert besteht aus einem linken und einem rechten Teil, getrennt duch ‘@’. Der linke Teil spezifiziert verschiedene Kategorien für die Art der Zugehörigkeit einer Person zu einer Organisationseinheit, die der rechte Teil dann spezifiziert (Security Domain). Ein Beispiel für eine solche Affiliation ist “student@uni-musterstadt.de”.


  2. Entitlement: Alternativ kann eine Authentifizierung auf Basis des vom Identity Provider übergebenen Entitlements stattfinden. Hierzu kann z.B. die URN-Registry im deutschen Forschungsnetz genutzt werden. Das Entitlement besteht aus mehreren Teilen, getrennt durch Doppelpunkte. Das Schema ist:

    Namensraum:Rollentyp:Attribute

    Die Elemente in diesem Schema haben folgende Bedeutungen:

    • Namensraum: Dies ist aktuell der Namensraum des IDM.nrw Projekts, geschrieben als urn:geant:dfn.de:idm.nrw:<SCOPE>: Dabei ist <SCOPE> die Domain der eigenen Organisation, also z.B. “uni-musterstadt.de”

    • Rollentyp: Dies ist üblicherweise role (oder contextrole).

    • Attribute: Es werden für KI:connect immer vier Attribute verarbeitet:

      1. rid: ID der Rolle, die die Mitglieder der Nutzendengruppen haben müssen.
      2. rname: Anzeigename der Rolle
      3. cid: ID der Heimateinrichtung
      4. cname: Anzeigename der Heimateinrichtung

    Ein Beispiel für ein Entitlement ist:

    urn:geant:dfn.de:idm.nrw:uni-musterstadt.de:role:rid=ABCDEF12-A123-B456-C789-ABCDEF123456:rname=Mitglieder-Organisationseinheit:cid=ORG-13OPQ:cname=tu9.de


Sie können in einer Authentifizierungs-Regel auch gleichzeitig eine Affiliation und ein Entitlement hinterlegen. Sind beide Angaben innerhalb einer Regel gemacht, werden sie per UND verknüpft. Personen müssen also beide Vorgaben erfüllen, um authentifiziert zu werden.


Zudem können mehrere Authentifizierungs-Regeln für eine Nutzendengruppe angelegt werden. Diese werden per ODER verknüpft, so dass Personen in derselben Nutzendengruppe über unterschiedliche Vorgaben zugelassen werden können.


5.2.2 Authentifizierungs-Regeln bearbeiten

Klicken Sie dazu auf das Zahnrad neben der Authentifizierungs-Regel. Es wird derselbe Dialog wie beim Anlegen einer Authentifizierungs-Regel angezeigt. Dort können Sie die Parameter der Authentifizierungs-Regel verändern. Klicken Sie zum Übernehmen der Änderungen den Button “Speichern”. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.

5.2.3 Löschen von Authentifizierungs-Regeln

Klicken Sie dazu auf das “Papierkorb”-Icon neben der Authentifizierungs-Regel. Daraufhin wird eine Sicherheitsabfrage angezeigt. Klicken Sie zum endgültigen Entfernen der Authentifizierungs-Regel auf den Button “Löschen”.


5.2.4 Nutzende mit mehreren Nutzendengruppen

Eine Person oder Shibboleth-Entität kann mehreren Nutzendengruppen zugeordnet werden. Dies kann auf mehrere Weisen geschehen:

  1. Eine Person oder Shibboleth-Entität verfügt über mehrere Rollen in ihrem Entitlement: sie kann z.B. sowohl die Rolle “staff” und ebenfalls die Rolle “student” haben. Verschiedene Authentifizierungsgegeln beinhalten damit dieselbe Person oder Shibboleth-Entität.
  2. Verschiedene Nutzendengruppen beinhalten dieselben Authentifizierungsregeln: Ein Entitlement wie etwa “employee” kann in den Authentifizierungsregeln mehrerer Nutzendengruppen definiert sein, z.B. bei den Nutzendengruppen “staff” und “rectorate”.

In diesem Fall wird direkt nach dem Login der betreffenden Personen oder Shibboleth-Entität ein Auswahlmenü angezeigt. Darin können die Nutzenden ihre Nutzendengruppe auswählen, über die u.a. die verfügbaren KI-Modelle sowie die Nutzungslimits abhängen.


Zum späteren Wechsel der Nutzendengruppe genügt ein Klick auf das Profil im unteren Bereich des Chatverlaufs. Im daraufhin angezeigten Menü kann über den Eintrag Nutzendengruppe wechseln dasselbe Auswahlmenü wie nach dem initialen Login angezeigt werden.


5.3 Deployment von KI-Modellen konfigurieren

In KI:connect ist die Bereitstellung von KI-Modellen untrennbar mit Nutzendengruppen verbunden. Es muss also mindestens eine Nutzendengruppe in KI:connect eingerichtet sein. Die dazu notwendigen Schritte sind im Abschnitt beschrieben.

Klicken Sie auf das Menü “Nutzergruppen” in der linken Seitenleiste. Es werden Ihnen nun die eingerichteten Nutzendengruppen in Tabellenform angezeigt.

In der Tabelle finden Sie neben jeder Nutzendengruppe ein “Zahnrad”-Icon. Klicken Sie dieses an, um zur Parametrisierung und zum Deployment der KI-Modelle für die zugehörige Nutzendengruppe zu gelangen.


5.3.1 Deployment einrichten

Sobald Sie eine Nutzendengruppe anzeigen, können Sie KI-Modelle für die Nutzendengruppe bereitstellen. Diese Bereitstellung wird in KI:connect als “Deployment” bezeichnet. Wenn noch kein Deployment erstellt wurde, Klicken Sie auf “Neues Deployment”.


5.3.1.1 Modellübergreifende Parameter

Jedes Deployment hat eine Reihe von Standardparametern, die ausgefüllt werden müssen bzw. können. Diese werden nachfolgend beschrieben.


  1. Interner Name: Der eindeutige Identifikator für das Deployment innerhalb von KI:connect. Dieser Identifikator wird in allen Dialogen zur identifikation des Deployments genutzt.

  2. Remote Deployment Name: Der Name für das KI-Modell, der im API-Call an den Endpunkt übergeben wird.

  3. Datenverarbeitungsregion: Serverstandort des KI-Anbieters, in dem das gewählte Modell ausgeführt wird. Derzeit sind hier die Optionen Deutschland, EU und Global wählbar. Wenn Ihr Modell keinen Serverstandort ausweist, wählen Sie den Listeneintrag --.


  4. Label Modell: Der erste Teil des Anzeigenamens für das Modell im Frontend. Der gesamte Anzeigename im Frontend wird nach dem Schema Label Modell + Leerzeichen + Label Version gebildet.

  5. Label Version: Der zweite Teil des Anzeigenamens für das Modell im Frontend. Der gesamte Anzeigename im Frontend wird nach dem Schema Label Modell + Leerzeichen + Label Version gebildet.

  6. Modell: Das konkrete KI-Modell für das Deployment. Die Auswahl legt fest, mit welcher API-Version das Modell angesprochen wird. In der Liste werden alle von KI:connect derzeit unterstützten KI-Modelle angezeigt. Für andere Modelle (z.B. Anthropic Claude) ist die API-Kompatibilitäts-Schicht noch nicht angepasst.


    Achtung: Die in der Drop-Down Liste angezeigten Modelle werden nicht mit den tatsächlich gewählten Zugangsdaten abgeglichen. Es ist also möglich, dass Sie in der Drop-Down-Liste Modell ein Modell auswählen, das der Endpunkt nicht unterstützt.

  7. Zugangsdaten: Wählen Sie hier einen der API-Endpunkte aus, die Sie im Menü Zugangsdaten registriert haben.


  8. Maximal Tokens Eingabe: Hier legen Sie fest, wie viele Tokens ein User-Prompt maximal haben darf. Für diesen Wert gibt es keine konkreten Empfehlungen, da er von der maximalen Kontextlänge des Modells abhängt. Erfahrungsgemäß sollte ein Prompt nicht länger als 10% der maximalen Kontextlänge des gewählten KI-Modells sein, damit ein sinnvoller Chat mit mehreren Prompts und KI-Antworten möglich ist.

  9. Maximal Tokens Ausgabe: Hier legen Sie fest, wie viele Tokens eine Completion durch das KI-Modell maximal haben darf. Für diesen Wert gibt es keine konkreten Empfehlungen, da er von der maximalen Kontextlänge des Modells abhängt. Erfahrungsgemäß sollte ein Prompt nicht länger als 25% der maximalen Kontextlänge des gewählten KI-Modells sein, damit ein sinnvoller Chat mit mehreren Prompts und KI-Antworten möglich ist.

  10. Preis Eingabe: Die Kosten pro 1.000 Tokens für User-Prompts.

  11. Chached Prompt Preis Einige KI-Modelle erlauben das Chaching von häufig wiederverwendeten Prompts wie z.B. dem System Prompt oder von Custom Instructions. Diese Prompts werden in vorverarbeiteter Form gespeichert und sind deshalb preiswerter als andere Eingabe-Prompts.

  12. Preis Ausgabe: Die Kosten pro 1.000 Tokens für Completions durch das KI-Modell

  13. Deployment zur Titelgenerierung: KI:connect generierte automatische Titel für Prompts, während die erste Completion auf einen User-Prompt erfolgt. Dafür wird ein eigenes KI-Modell genutzt. Dabei muss es sich um ein existierendes Deployment für die aktuelle Nutzendengruppe handeln. Es wird empfohlen, das preiswerteste Modell für die Titelgenerierung zu verwenden.

    Hinweis: Das Deployment zur Titelgenerierung kann immer nur ein bestehendes Deployment für die aktuelle Nutzendengruppe sein. Dabei spielt es keine Rolle, ob das gewählte Modell als “Aktiv” markiert ist oder nicht (siehe Punkt 14). Wenn Sie also Ihr erstes Deployment erstellen, wird in der Drop-Down-Liste nur ein Eintrag vorhanden sein, nämlich das aktuell hinzuzufügende Deployment. Wenn Sie später kostengünstigere Deployments ergänzen, sollten Sie alle Deployments zur Titelgenerierung entsprechend anpassen.


  14. Aktiv: Sobald Sie den Schieber einschalten, wird das Deployment für die Frontend-Nutzenden in der Liste auswählbarer KI-Modelle. Ist der Schieber deaktiviert, wird das Deployment nicht angezeigt.

  15. System Prompt: Der System Prompt kann am Ende des Dialogs konfiguriert werden. Ein System Prompt ist eine Anweisung an das KI-Modell, die nicht sichtbar für den User immer als erster Prompt eines Chats mitgeschickt wird. Sie können hier beliebige Anweisungen an das KI-Modell hinterlegen, um das Antwortverhalten des KI-Modells zu steuern.

    Wenn hier kein System Prompt eingetragen wird, wird der Standard System Prompt verwendet, der bei den Standardparametern für KI-Modelle festgelegt worden ist.


Sie können im gleichen Dialogfenster noch weitere, Modell-spezifische Parameter festlegen, die das Verhalten des KI-Modells beeinflussen. Diese werden im nächsten Abschnitt beschrieben.

5.3.1.2 Modell-spezifische Parameter

Scrollen Sie ein bisschen weiter, um die Modell-spezifischen Parameter anzuzeigen. Sie können alle Felder leer lassen oder auch nur einzelne der Parameter festlegen.

Für Parameter, die leer gelassen werden, wird der Standardwert verwendet, der bei denStandardparametern für KI-Modelle festgelegt worden ist.

Für KI-Modelle ohne Reasoning-Fähigkeit wie ChatGPT-4o oder Llama-3.3-70B stehen folgende Parameter zur Verfügung:

  1. Temperature: Die Kreativität oder Zufälligkeit der KI-Antworten. Je höher der Wert, des zufälliger die Textgenerative der KI. Geeignete Werte hängen vom konkreten KI-Modell ab.

  2. Top P: Die Variabilität der KI-Antworten. Je höher der Wert, des unterschiedlicher ist die Formulierung der Antworten. Geeignete Werte hängen vom konkreten KI-Modell ab.

  3. Presence Penalty: Wahrscheinlichkeit, mit der ein KI-Modell bereits verwendete Konzepte wiederholt statt neue Ideen zu produzieren. Geeignete Werte hängen vom konkreten KI-Modell ab.

  4. Frequency Penalty: Wahrscheinlichkeit, mit der ein KI-Modell bereits verwendete Begriffe (bzw. Tokens) wiederholt statt neue Formulierungen zu produzieren. Geeignete Werte hängen vom konkreten KI-Modell ab.


Für die so genannten “Reasoning Modelle” wie ChatGPT-o3 oder ChatGPT-o5 Reasoning stehen andere Parameter zur Verfügung. Aktuell sind dies:

  1. Resoning Effort Level: Tiefe des Reasoning Prozesses. Ein niedrigerer Wert kann zu schnelleren Antworten und der Produktion von weniger Reasoning Tokens führen. Geeignete Werte hängen vom konkreten KI-Modell ab.


5.3.2 Deployment bearbeiten

Klicken Sie dazu auf das Zahnrad neben dem Deployment. Es wird derselbe Dialog wie beim Anlegen eines Deployments-Regel angezeigt. Dort können Sie die Parameter des Deployments verändern. Klicken Sie zum Übernehmen der Änderungen den Button “Speichern”. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.

5.3.3 Deployment löschen

Klicken Sie dazu auf das “Papierkorb”-Icon neben dem Deployment. Daraufhin wird eine Sicherheitsabfrage angezeigt. Klicken Sie zum endgültigen Entfernen des Deployments auf den Button “Löschen”.

5.3.4 Deployments kopieren

Das Anlegen von Deployments erfordert eine Vielzahl von Einstellungen. Um das Anlegen von Deployments zu erleichtern, kann ein vorhandenes Deployment kopiert werden. Klicken Sie dazu auf das “Kopieren”-Icon am rechten Rand des Deployments neben dem Zahnrad-Button.

Nach dem Klick öffnet sich der Dialog zum Neu-Anlegen eines Deployments, allerdings sind die meisten Felder bereits mit den Werten aus dem kopierten Deployment vorbelegt.


5.3.5 Deployments sortieren

Die Deployments können manuell sortiert werden. Die Sortierreihenfolge legt fest, in welcher Abfolge die Modelle in der Auswahlliste im User-Frontend angezeigt werden.

Zum Sortieren können entweder die Buttons mit den Hoch- / Runter-Pfeilen links neben dem Modellnamen oder das Grip-Icon am linken Rand des Deploments verwendet werden


5.4 Nutzungslimits konfigurieren

Wenn noch kein Nutzungslimit für ein Deployment angelegt wurde, kann die Nutzendengruppe so lange mit dem KI-Modell arbeiten, bis das Hard Limit für die Budgetobergrenze der Nutzendengruppe für den laufenden Monate erreicht ist.

Deshalb empfiehlt es sich, spezifische Nutzungslimits für jedes Deployment anzulegen. KI:connect ermöglicht das Anlegen individueller Nutzungslimits für jedes Deployment, d.h. für jede Kombination aus Nutzendengruppe und KI-Modell, um eine möglichst feingranulare Steuerung der KI-Nutzung vorzunehmen.


Diese Nutzungslimits gelten pro Person und werden den Nutzenden im Frontend angezeigt. Wenn das Nutzungslimit für ein KI-Modell von einer Person erreicht wurde, erhält die Person eine Nachricht, dass sie das aktuell gewählte KI-Modell bis zum Ablauf des festgelegten Zeitraums nicht mehr nutzen kann. Sie kann aber auf andere Modelle umschalten und das dort festgelegte Nutzungslimit erneut voll ausschöpfen. Das Einrichten von Sammel-Nutzungslimits für mehrere Deployments ist aktuell noch nicht möglich.

Ein Nutzungslimit in KI:connect ist als “Rolling Limit” implementiert und wird immer auf Basis der eingestellten Zeiteinheit geprüft. Wenn z.B. das Nutzungslimit 30 Prompts in 3 Stunden gewählt wurde, wird bei jedem neuen Prompt geprüft, ob er zur Überschreitung des Limits in exakt den letzten 3 h (also 10.800 sec) führen würde. Ist dies der Fall, wird der User informiert und der Prompt nicht ausgeführt. Sobald aber der älteste Prompt aus dem Limit-Zeitraum herausfällt, kann ein neuer Prompt wieder erfolgreich abgeschickt werden.

Das zur Einrichtung von Nutzungslimits notwendige Vorgehen wird nachfolgend beschrieben.

5.4.1 Nutzungslimits einrichten

Klicken Sie für das Anlegen eines Nutzungslimits auf + Neues Nutzungslimit.


Im daraufhin angezeigten Dialog können Sie mehrere Eigenschaften festlegen:

  1. Maximale Tokens: Geben Sie hier die maximale Tokenzahl ein, die im weiter unten definierten Zeitraum von einer/m Nutzenden verbraucht werden dürfen. Es werden Eingabe- und Ausgabetokens gemeinsam gerechnet. Bei Erreichen des Limits wird ein entsprechender Hinweis im Frontend angezeigt.

  2. Maximale Aufforderungen: Geben Sie hier die maximale Anzahl von Prompts ein, die im weiter unten definierten Zeitraum von einer/m Nutzenden geschrieben werden dürfen. Bei Erreichen des Limits wird ein entsprechender Hinweis im Frontend angezeigt (s.o.).

  3. Zeitraum: Geben Sie hier den Zeitraum ein, für den die Einhaltung der Limits berechnet wird. Es können vier verschiedene Zeiteinheiten ausgewählt werden: (i) Sekunde, (ii) Stunde, (iii) Tag und (iv) Woche.


Wenn sowohl für die maximalen Tokens als auch für die maximalen Prompts Werte eingegeben werden, greift immer dasjenige Limit, das früher erreicht wird.

Es kann pro Deployment auch mehr als ein Nutzungslimit festgelegt werden. So können z.B. unterschiedliche Limits pro Stunde und pro Tag definiert werden.


5.4.2 Nutzungslimits bearbeiten

Klicken Sie dazu auf das Zahnrad neben dem Nutzungslimit. Es wird derselbe Dialog wie beim Anlegen eines Nutzungslimits angezeigt. Dort können Sie die Parameter des Nutzungslimitsverändern. Klicken Sie zum Übernehmen der Änderungen den Button “Speichern”. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.

5.4.3 Löschen von Nutzungslimits

Klicken Sie dazu auf das “Papierkorb”-Icon neben dem Nutzungslimit. Daraufhin wird eine Sicherheitsabfrage angezeigt. Klicken Sie zum endgültigen Entfernen des Nutzungslimits auf den Button “Löschen”.


6. Festlegung von Standardparametern für KI-Modelle

Für alle KI-Modelle können systemweite Standardwerte Einstellungen spezifiziert werden, z.B. ein System Prompt oder Parameter für die Inferenz wie “Temperature” oder “Reasoning Effort”. Diese Standardwerte greifen, wenn modell-spezifischen Einstellungen im Rahmen der Deployments nicht vorgenommen werden.

Die Standardwerte werden im Menüpunkt “Allgemein” in der linken Seitenleiste festgelegt.


Dort können folgende Einstellungen vorgenommen werden:

  1. Temperature: Die Kreativität oder Zufälligkeit der KI-Antworten. Je höher der Wert, des zufälliger die Textgenerative der KI. Geeignete Werte hängen vom konkreten KI-Modell ab.

  2. Top P: Die Variabilität der KI-Antworten. Je höher der Wert, des unterschiedlicher ist die Formulierung der Antworten. Geeignete Werte hängen vom konkreten KI-Modell ab.

  3. Presence Penalty: Wahrscheinlichkeit, mit der ein KI-Modell bereits verwendete Konzepte wiederholt statt neue Ideen zu produzieren. Geeignete Werte hängen vom konkreten KI-Modell ab.

  4. Frequency Penalty: Wahrscheinlichkeit, mit der ein KI-Modell bereits verwendete Begriffe (bzw. Tokens) wiederholt statt neue Formulierungen zu produzieren. Geeignete Werte hängen vom konkreten KI-Modell ab.

  5. System-Prompt: Der System Prompt ist eine Anweisung an das KI-Modell, die nicht sichtbar für den User immer als erster Prompt eines Chats mitgeschickt wird. Sie können hier beliebige Anweisungen an das KI-Modell hinterlegen, um das Antwortverhalten des KI-Modells zu steuern.

7. User Interface anpassen

KI:connect bietet vielfältige Funktion für die Anpassung des User Interfaces (UI). Sie können verschiedene Gestaltungselemente verändern sowie Inhalte anpassen.

7.1 Branding

Sie können eine Vielzahl von Gestaltungselementen anpassen, um die UI von KI:connect an das Corporate Design Ihrer Heimateinrichtung anzupassen.

Klicken Sie dazu auf den Menüpunkt “Theme” in der linken Seitenleiste.


7.1.1 Allgemeine Aspekte der UI

Klicken Sie im angezeigten Dialogfenster auf die Auswahlfläche Allgemein, um grundlegende Aspekte der Frontend-seitigen Web-Oberfläche anzupassen:

  1. Chatbot Name: Der Anzeigename für KI:connect, der Nutzenden Ihrer Heimateinrichtung eingeblendet wird, wenn in Textausgaben auf den Dienst verwiesen wird.

  2. Hintergrundbild Startseite: Die Grundansicht des Dienstes (Menüleiste links, Chatfenster rechts) hat ein Hintergrundbild für das Chatfenster. Wählen Sie hier eines der Motive aus der Drop-Down-Liste aus. Die Farbgebung des Bildes richtet sich nach der Farbeinstellung, die weiter unten beschrieben wird.

  3. Logo Einrichtung: Logo der Heimateinrichtung, das am oberen rechten Rand des Fensters angezeigt wird. Klicken Sie zuerst auf “Datei hochladen”. Im angezeigten Öffnen-Dialog sind Bilddateien im PNG- und SVG-Format auswählbar. Wird kein Logo angegeben, bleibt der entsprechende Bereich in der UI leer.


    Nach dem Auswählen wird die geladene Bilddatei angezeigt. Die ausgewählte Datei kann mit einem Klick auf das “X” Icon wieder entfernt werden.

  4. Logo Chatbot: Logo für den Chatbot, das oben in der Menüleisten am linken Rand angezeigt wird. Der Vorgang zum Hochladen und Löschen einer Bilddatei ist identisch zum Logo der Einhateinrichtung.

    Nach dem Auswählen werden beide geladenen Bilddateien angezeigt. Wird kein Logo angegeben, wird standardmäßig das KI:connect Logo angezeigt.


Klicken Sie zum Übernehmen der Einstellungen auf den Button “Speichern”. Ab jetzt wird das KI:connect Frontend für Nutzende Ihrer Heimateinrichtung mit den neuen Theme Einstellungen angezeigt.

7.1.2 Farben

Klicken Sie im angezeigten Dialogfenster auf die Auswahlfläche Farben, um eine Vielzahl von Farben in der UI einzustellen.


7.1.2.1 Grundfarben

Zunächst können die zwei Grundfarben der UI definiert werden:

  1. Primär Farbe: Die Hintergrundfarbe der linken Seitenleiste sowie verschiedener dekorativer UI-Elemente. Standardwert ist Schwarz (#000000). Geben Sie den gewünschten Farbwert als hex-Farbcode an. Die resultierende Farbe wird zur Kontrolle vor dem hex-Farbcode eingeblendet.

  2. Sekundär Farbe: Farbe für Highlights. Standardwert ist Orange (#F7A806). Geben Sie den gewünschten Farbwert als hex-Farcode an. Die resultierende Farbe wird zur Kontrolle vor dem hex-Farbcode eingeblendet.

Klicken Sie zum Übernehmen der Einstellungen auf den Button “Speichern”. Ab jetzt wird das KI:connect Frontend für Nutzende Ihrer Heimateinrichtung mit den neuen Theme Einstellungen angezeigt.

7.1.2.2 Akzentfarben

Aus den gewählten zwei Grundfarben leitet das System selbständig Akzentfarben ab, die aus einer Veränderung des Helligkeitswertes der Farbe resultieren. Diese Farben werden angezeigt, wenn Sie den Auswahlschieber Eigene Farbabstufungen nutzen deaktivieren.

Möchten Sie eigene Akzentfarben definieren, stellen Sie den Auswahlschieber Eigene Farbabstufungen nutzen auf aktiv.

Sie können nun alle angezeigten Farbakzente individuell ändern. Geben Sie die gewünschten Farbwerte als hex-Farcode an. Die resultierende Farbe wird jeweils zur Kontrolle vor dem hex-Farbcode eingeblendet.

Klicken Sie zum Übernehmen der Einstellungen auf den Button “Speichern”. Ab jetzt wird das KI:connect Frontend für Nutzende Ihrer Heimateinrichtung mit den neuen Theme Einstellungen angezeigt.

7.1.2.3 Weitere Farbelemente

Zusätzlich können Sie die Farben mehrerer UI-Elemente anpassen. Dabei handelt es sich um:

  1. Farbe Roboter: Die Farbe des KI:connect Avatars, wenn er auf einer der UI-Seiten angezeigt wird.

  2. Farbe Logo: Die Farbe des KI:connect Logos, wenn es auf einer der UI-Seiten angezeigt wird.

  3. Farbe Benutzer: Die Farbe des Kreises vor dem Usernamen, der an unteren Rand der Seitenleiste am linken Rand angezeigt wird.

  4. Farbe Chat Blase: Die Farbe der Sprechblasen für die Prompts der Nutzenden. Hinweis: Die Farbe der Sprechblasen der KI-Antwort ist festgelegt.

  5. Farbe Button Hover: Die Farbe von Button-Elementen (z.B. “Abbrechen” oder “Aktualisieren” beim Bearbeiten von Chats), wenn die Maus über dem Button hovert.


Klicken Sie zum Übernehmen der Einstellungen auf den Button “Speichern”. Ab jetzt wird das KI:connect Frontend für Nutzende Ihrer Heimateinrichtung mit den neuen Theme Einstellungen angezeigt.

7.2 Infobanner konfigurieren

Um User über wichtige Neuigkeiten zu informieren, können im User Interface Nachrichten eingeblendet werden, die als “Infobanner” bezeichnet werden. Infobanner werden gut sichtbar oberhalb des Chatbereichs angezeigt. User können ein Infobanner mit einem Klick auf das “×” schließen, so dass diese während der laufenden Browsersession nicht mehr eingeblendet werden.


Um ein Infobanner zu konfigurieren, klicken Sie auf das Menü “Allgemein” in der linken Seitenleiste. Scrollen Sie nun bis zum Ende der Seite. Sie können nun ein Infobanner eingeben, wobei HTML Tags wie <b>, <i>, <a> oder <br> verwendet werden können.

Um das Infobanner sichtbar zu schalen, aktivieren Sie den Schalter Info Banner aktiv. Ist der Schalter deaktiviert, wird kein Hilfebanner angezeigt.


7.3 Anpassung des Hilfemenüs

Das Informations- und Hilfemenü wird über einen Klick auf das “Fragezeichen” Icon am unteren rechten Bildschirmrand geöffnet. Sie können alle Einträge in diesem Menü frei wählen und anpassen. Dies wird nachfolgend beschrieben.


7.3.1 Hinzufügen von Menüenträgen

Klicken Sie auf das Menü “Allgemein” in der linken Seitenleiste. Scrollen Sie dann nach unten bis zum Abschnitt “Hilfe-Menü”. Jedes Element der darin angezeigten Liste entspricht einem Eintrag im Informations- und Hilfemenü.


Um einen neuen Menü-Eintrag hinzuzufügen, klicken Sie auf den Button Hilfe-Menü Eintrag hinzufügen.

Im nun angezeigten Dialog können Sie einen neuen Eintrag für das Menü definieren.


Wählen Sie zunächst ein Icon für den Menü-Eintrag, indem Sie auf die Dropdown-Liste Icon klicken. Es sind folgende Icons verfügbar:

Icon

  

 Bezeichnung
Bestellung genehmigen
Unterschrift
Info
E-Mail
Hilfe
Einstellungen


Wählen Sie dann den Typ des Menü-Eintrags aus, indem Sie im Feld `Typ` eine der Optionen anklicken. Es stehen zwei Optionen zur Auswahl:

  1. URL: Der Eintrag im Informations- und Hilfemenü verweist auf eine andere Internet-Seite. Beim Klick auf den Eintrag wird die hinterlegte URL in einem neuen Browser-Tab angezeigt.

  2. Content-Page: Sie können in KI:connect Webseiten anlegen. Wenn ein Eintrag vom Type Content-Page angeklickt wird, wird die Webseite anstelle des Chat-Fensters direkt im KI:connect Frontend angezeigt.

Tragen Sie nun eine Bezeichnung für den Menü-Eintrag ein. Dies ist der Text, der im ausgeklappten Menü angezeigt wird. Sie können eine englische und eine deutsche Variante hinterlegen.

Neben diesen Standardparametern haben die beiden Typen URL und Content-Page unterschiedliche Parameter. Diese werden nachfolgend erläutert.

7.3.1.1 Parameter für den Typ “URL”

Für den Typ URL muss die Ziel-URL angegeben werden, zu der ein Klick auf den entsprechenden Menü-Eintrag führt. Es können zwei URLs für die deutsche und englischsprachige Version der Ziel-URL eingetragen werden.


Klicken Sie zum Abschluss auf Speichern, um den Menü-Eintrag zu übernehmen. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.

7.3.1.2 Parameter für den Typ “Content-Page”

Für den Typ Content-Page muss die Inhaltsseite ausgewählt werden, die beim Klick auf den Menüeintrag angezeigt werden soll. Diese Inhaltsseiten müssen vorher in KI:connect erstellt werden. Eine ausführliche Erklärung dazu liefert der Abschnitt 7.2.4 Anlegen von Inhaltsseiten für das Hilfe-Menü.

Klicken Sie zum Auswählen einer Inhaltsseite auf die Dropdown-Liste “Inhaltsseiten”. Es werden Ihnen alle Inhaltsseiten angezeigt, die aktuell in KI:connect hinterlegt sind. Wählen Sie eine der verfügbaren Optionen aus.


Klicken Sie zum Abschluss auf Speichern, um den Menü-Eintrag zu übernehmen. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.

7.3.2 Ändern von Menüeinträgen

Klicken Sie beim gewünschten Menü-Eintrag auf das “Stift” Icon. Es wird derselbe Dialog wie beim Hinzufügen eines Menü-Eintrags angezeigt, in dem Sie die Parameter des Eintrags verändern können. Klicken Sie zum Übernehmen der Änderungen auf den Button “Speichern”. Ein Klick auf “Abbrechen” verwirft die Änderungen ohne weitere Nachfrage.

7.3.3 Löschen von Menüeinträgen

Klicken Sie zum Löschen eines Menü-Eintrags auf das “Papierkorb” Icon. Daraufhin wird eine Sicherheitsabfrage angezeigt. Klicken Sie zum endgültigen Entfernen des Menü-Eintrags auf den Button “Löschen”.

7.3.4 Anlegen von Inhaltsseiten für das Hilfe-Menü

Um neue Inhaltsseiten für die Anzeige im Informations- und Hilfemenü anzulegen, wählen Sie den Menüpunkt “Inhaltsseiten” in der linken Seitenleiste.


Klicken Sie auf den Button Neue Inhaltsseite, um eine neue Inhaltsseite zu erstellen.

Geben Sie im Feld Slug den Pfadnamen ein, der in der URL verwendet wird, um die Inhaltsseite zu identifizieren. Wenn Sie z.B. als Slug die Bezeichnung “checklist” verwenden, lautet die URL zur Inhaltsseite:

http://chat.kiconnect.nrw/app/checklist

Wählen Sie nun über den Selektor aus, ob Sie die Version in Deutsch oder Englisch bearbeiten möchten.

Im darunter angezeigten Editor können Sie nun den gewünschten Inhalt bearbeiten. Sie können dabei grundlegende Formatierungen wie Fett- und Kursivdruck sowie Überschriftenebenen verwenden.

Alternativ können Sie die Inhalte im Markdown-Format eingeben. Sobald der Editor eine interpretierbare Markdown-Syntax erkennt – z.B. durch Eingabe von # + Leerzeichen, wird die Markdown-Syntax unmittelbar durch ein formatiertes Element ersetzt.


8. Festlegung von Löschfristen

KI:connect sieht die automatische Löschung von älteren Chats vor. Die Periode bis zur automatischen Löschung eines Chats mit allen Inhaltenkann in Monaten angegeben werden. Um die automatische Löschung zu konfigurieren, wählen Sie den Menüpunkt “Allgemein” in der linken Seitenleiste.

Hier finden Sie das Eintragsfeld Datenaufbewahrungsdauer. Tragen Sie dort das maximale Alter eines Chats in Monaten ein, bevor die die automatische Löschung greifen soll. Ein Wert von 0 (Null) deaktiviert die automatische Löschung.


Hinweis: Das Alter eines Chats richtet sich nach dem Datum der letzten Änderung dieses Chats. Als Änderungen, die zur Rücksetzung des Alters auf Null führen, gelten:

  • Das Hinzufügen eines weiteren Prompts am Ende des Chats
  • Das Editieren bestehender Prompts
  • Das Umbenennen des Chats

Chats, deren Alter bis auf 14 Tage oder weniger an die Datenaufbewahrungsdauer herangerückt ist, werden markiert. Zusätzlich erscheint im Chatverlauf am linken Rand des Fensters ein entsprechender Hinweis.

User haben dann die Möglichkeit, einen Chat zu reaktivieren, so dass sein Alter auf Null zurückgesetzt wird. Wird ein Chat nicht reaktiviert, wird er automatisch gelöscht, sobald sein Alter die volle Datenaufbewahrungsdauer erreicht hat.

9. Reporting

KI:connect ermöglicht detaillierte Reports für die Nutzung der hinterlegten KI-Modelle, getrennt nach Nutzendengruppe.

Sie wählen den Menüpunkt “Reporting” in der linken Seitenleiste. Wenn Sie den Menüpunkt anklicken, wird noch kein Bericht erstellt. Zuerst müssen verschiedene Details des Berichts festgelegt werden. Dies wird nachfolgend beschrieben.


Für die Spezifikation des Berichts sind mehrere Parameter zu setzen:

  1. Abrechnungselement: Die Nutzendengruppe, auf die der Bericht begrenzt sein soll. Es werden alle unter “Nutzergruppen” festgelegten Gruppen als Optionen angeboten.

  2. Deployment: Das KI-Modell, für das der Bericht erstellt werden soll. Es kann unter allen KI-Modelle für die unter Abrechungselement gewählte Nutzendengruppe ausgewählt werden.

  3. Von: Der Start des Betrachtungszeitraums für den Bericht.

  4. Bis: Das Ende des Betrachtungszeitraums für den Bericht. Das gesetzte Datum ist im Betrachtungszeitraum noch enthalten.

  5. Granularität: Das zeitliche Abrechnungsintervall, das im Bericht als kleinste Einheit für den gewählten Betrachtungszeitraum verwendet wird. Es sind folgende Optionen möglich:

    • Täglich: Für den gewählten Betrachtungszeitraum werden die Kosten pro Tag angezeigt. Diese Einstellung eignet sich für Betrachtungszeiträume von mehreren Tagen bis wenigen Wochen, um die Ausgabe nicht zu überfrachten.
    • Wöchentlich: Für den gewählten Betrachtungszeitraum werden die Kosten pro Woche angezeigt. Diese Einstellung eignet sich für Betrachtungszeiträume von mehreren Wochen bis wenigen Monaten.
    • Monatlich: Für den gewählten Betrachtungszeitraum werden die Kosten pro Monat angezeigt. Diese Einstellung wird üblicherweise für Betrachtungszeiträume ab 12 Monaten verwendet.

Klicken Sie nach Festlegen oder o.g. Parameter auf den Button “Bericht generieren”. Nach kurzer Zeit wird der Bericht darunter angezeigt. Für eine Anpassung des Berichts verändern Sie einfach die Parameter und generieren den Bericht erneut.