agorum core ai KI-Voreinstellungen einrichten

Nach dem Installieren des Plugins können Sie die KI-Voreinstellungen konfigurieren. Öffnen Sie dazu oben rechts in der Kopfleiste  > Administration > Konfiguration > KI-Voreinstellungen. 

Vorüberlegungen

Überlegen Sie, welche KI-Voreinstellungen (Presets) Sie benötigen, bevor Sie mit der Einrichtung beginnen. Dabei können Ihnen folgende Fragen behilflich sein:

• Welche Sprachmodelle wollen Sie anbinden? Wollen Sie die KI in agorum core pro mit einem oder mehreren Sprachmodellen verwenden? Über welche Fähigkeiten müssen die Sprachmodelle verfügen (nur Text-Chat, oder auch Image-Verarbeitung)?
• Wollen Sie Fallbacks von einem Sprachmodell auf ein oder mehrere andere in Ihren KI-Vorsteinstellungen verwenden?
• Wie kann agorum core pro auf die Sprachmodelle zugreifen? In der Regel benötigen Sie für die Einrichtung mindestens den Endpoint (die Zugriffsadresse) und Ihren API-Key.
• Wie wollen Sie die KI in agorum core pro verwenden? Sollen Benutzer die KI über Chats verwenden oder wollen Sie mit der KI Prozesse in agorum core pro automatisieren?
• Welche wiederkehrenden Abfragen werden Ihre Benutzer wahrscheinlich im Chat verwenden? Macht es Sinn, entsprechende Kontextinformationen bereits als Kontext in der KI-Voreinstellung zu hinterlegen? 
• Gibt es verschiedene Benutzergruppen oder Automatisierungsszenarien, die auf unterschiedliche KI-Voreinstellungen zugreifen können müssen? Soll der Zugriff auf die Voreinstellungen auf bestimmte Benutzer eingeschränkt werden?
• Werden die KI-Vorsteinstellungen ausschließlich für Chats und Prozessautomatisierungen mit dem Workflow-Knoten oder der Bibliothek verwendet? Oder dienen sie auch als Grundlage für die Verwendung von Agenten?

KI-Voreinstellungen einrichten

Mit agorum core ai können Sie beliebig viele KI-Voreinstellungen einrichten. Diese Voreinstellungen können einander referenzieren und somit wiederverwendet werden.

Zum Einrichten der KI-Voreinstellungen benötigen Sie ein Konto beim Anbieter des jeweiligen Sprachmodells und den API-Key, um darauf zuzugreifen. Wenn Sie ein Sprachmodell selbst hosten (Ollama) benötigen Sie zusätzlich die Adresse bzw. den Endpunkt, unter dem der Service erreichbar ist. 

Aufeinander aufbauende KI-Voreinstellungen

Sie können in KI-Voreinstellungen andere KI-Voreinstellungen referenzieren und auf diese Weise aufeinander aufbauende KI-Konfigurationen erstellen. 

Sie können dadurch KI-Voreinstellungen etwa wie folgt von einander entkoppeln:

• Modellkonfigurationen: diese KI-Voreinstellungen enthalten die Verbindungsinformationen zum KI-Anbieter und das Sprachmodell
• Benutzerkonfigurationen (fachliche bzw. anwendungsbezogene Voreinstellungen): KI-Voreinstellungen mit einem Basisbefehl, was die KI tun soll, oder weiteren Kontextinformationen 

Zusätzlich können Sie in KI-Voreinstellungen, die andere Voreinstellungen referenzieren, auch Fallback-Konfigurationen angeben.

Das Entkoppeln von Verbindungseinstellungen zu einem oder mehreren KI-Modellen und den fachlichen Einstellungen hat für Sie mehrere Vorteile:

• Sie können ggf. den Anbieter wechseln, ohne die KI-Voreinstellung mit den Benutzereinstellungen inhaltlich ändern zu müssen.
• Sie können für den Fall, dass der Hauptanbieter nicht verfügbar sein sollte, eine oder mehrere Fallback-Verbindungen hinterlegen. Auf diese Weise können Sie die Verfügbarkeit der KI in Ihren Prozessen zusätzlich absichern.
• Wenn Sie die Namen der KI-Vorsteinstellungen entsprechend gestalten, sehen Benutzer im KI-Chat, wenn Sie mehrere Voreinstellungen anbieten, immer nur den fachlichen Verwendungszweck.

Die folgende Darstellung zeigt eine mögliche Konfiguration aufeinander aufbauender KI-Voreinstellungen.

In diesem Beispiel wird jeweils eine Konfiguration für jedes verwendete Sprachmodell eingerichtet. Diese KI-Voreinstellungen enthalten im Wesentlichen die Verbindungseinstellungen für die Integration des KI-Modells. Die Modellkonfigurationen werden in diesem Beispiel nicht direkt von Benutzern verwendet.

Für die Verwendung durch Benutzer und für andere Verwendungszwecke in agorum core pro werden KI-Voreinstellungen eingerichtet, die die Modelleinstellungen referenzieren. In diesen Benutzerkonfigurationen werden Modellkonfigurationen referenziert, entweder direkt oder als Fallback, und zusätzlich bei Bedarf Kontexteinstellungen vorgenommen.

Modellkonfigurationen einrichten

Gehen Sie wie folgt vor, um die Verbindung zu einem Sprachmodell in agorum core ai einzurichten:

1. Finden Sie den API-Key in Ihren Kontoeinstellungen des Sprachmodells, das Sie verwenden wollen. 
2. Öffnen Sie  > Administration > Konfiguration > KI-Voreinstellungen.
   
   Ergebnis: Das Fenster KI-Voreinstellungen einrichten öffnet sich.
3. Klicken Sie auf die Schaltfläche (Plus), um eine neue Konfiguration zu erstellen.
   
   Ergebnis: Das Fenster Anlage einer neuen KI-Voreinstellung öffnet sich.
4. Geben Sie den Namen ein, den Sie der KI-Voreinstellung geben wollen, und optional ein Konfigurationsprojekt und klicken Sie Speichern.
   
   Ergebnis: Die neue Konfiguration wird in der Liste der Konfigurationen angezeigt.
5. Klicken Sie auf Bearbeiten.
   
   Ergebnis: Das Fenster KI-Voreinstellung einrichten öffnet sich.
6. Wählen Sie im Bereich KI-Modell-Einstellungen das Sprachmodell aus, das Sie verwenden wollen. Für eine Übersicht über die verfügbaren Modelle siehe Übersicht über die Standardmodelle in agorum core ai.
   
   Ergebnis: Die Einstellungen des Modells (Basis-Einstellungen und Erweiterte Einstellungen) öffnen sich.

    

   

   KI-Modell-Einstellungen
7. Geben Sie den API-Key ein. Diesen finden Sie in Ihren Kontoeinstellungen beim Anbieter des jeweiligen Sprachmodells. 
8. Klicken Sie auf das Symbol  (Herunterladen) neben der Auswahl des KI-Modells, um die verfügbaren Elemente des Anbieters zu laden.
   
   Ergebnis: Die Liste der KI-Modelle enthält eine Liste der auswählbaren Modelle.
9. Wählen Sie das Sprachmodell, das Sie verwenden wollen, in der Liste KI-Modell aus.
10. Klicken Sie auf Verbindung mit dem KI-Modell testen.
    
    Ergebnis:
    • Die Verbindung zum KI-Modell wird hergestellt und die Fähigkeiten des Sprachmodells überprüft. Eine Zusammenfassung der Fähigkeiten wird angezeigt.
    • Wenn die Verbindung nicht hergestellt werden kann, sehen Sie eine Fehlermeldung. Prüfen Sie ggf. die Verbindungseinstellungen in Erweiterte Einstellungen und den angegebenen API-Key.
11. Schließen Sie das Fenster mit der Zusammenfassung der KI-Fähigkeiten.
12. Wählen Sie die Benutzergruppe aus, die Zugriff auf diese KI-Voreinstellung haben soll. 
13. Speichern Sie die KI-Voreinstellung.
    
    Ergebnis: Sie haben die Verbindung zu einem KI-Modell eingerichtet.
14. Optional: Aktivieren Sie die KI-Voreinstellung über die Checkbox Diese Voreinstellung ist aktiv und kann genutzt werden und geben Sie Einstellungen für die Sichtbarkeit im Benutzer-Chat an, siehe Allgemeine Konfigurationsoptionen.

    Tipp: Sie können Modellkonfigurationen direkt für die Auswahl im Benutzer-Chat verfügbar machen. In diesem Fall gibt es aber kein Fallback, wenn das entsprechende Modell nicht verfügbar ist. Überlegen Sie daher, ob die Verwendung von Benutzerkonfigurationen sinnvoll wäre, siehe Benutzerkonfigurationen einrichten.

15. Optional: Überprüfen Sie die Erweiterten Einstellungen. 

Benutzerkonfiguration/Konfiguration mit Referenzen auf andere Konfigurationen einrichten

Sie können in einer KI-Voreinstellung auf eine andere KI-Voreinstellung referenzieren und weitere KI-Voreinstellungen als Fallback-Referenzen hinterlegen. Auf diese Weise können Sie fachliche (bzw. anwendungsbezogene) und reine Konfigurationen der Schnittstellenverbindung zum Sprachmodell voneinander trennen, siehe Aufeinander aufbauende Einstellungen.

Gehen Sie wie folgt vor, um eine KI-Voreinstellung mit einer Referenz auf eine andere KI-Voreinstellung einzurichten:

1. Öffnen Sie  > Administration > Konfiguration > KI-Voreinstellungen.
   
   Ergebnis: Das Fenster KI-Voreinstellungen einrichten öffnet sich.
2. Klicken Sie auf die Schaltfläche (Plus), um eine neue Konfiguration zu erstellen.
   
   Ergebnis: Das Fenster Anlage einer neuen KI-Voreinstellung öffnet sich.
3. Geben Sie den Namen ein, den Sie der KI-Voreinstellung geben wollen, und klicken Sie Speichern.
   
   Ergebnis: Die neue Konfiguration wird in der Liste der Konfigurationen angezeigt.
4. Klicken Sie auf Bearbeiten.
   
   Ergebnis: Das Fenster KI-Voreinstellung einrichten öffnet sich.
5. Markieren Sie die Checkbox Diese Voreinstellung referenziert auf eine andere Voreinstellung.
   
   Ergebnis: Die Einstellungen zum Angeben der Referenz und von Fallback-Referenzen öffnen sich.

    

   

   Einstellungen für Referenzen auf andere KI-Voreinstellungen
6. Wählen Sie in der Auswahlliste Referenz auf eine Voreinstellung die KI-Voreinstellung aus, die Sie referenzieren wollen.
7. Optional: Geben Sie im Bereich Fallback-Referenzen weitere KI-Voreinstellungen an. Verwenden Sie dazu die Schaltfläche Referenz hinzufügen. Diese Fallback-Referenzen werden verwendet, falls das als Hauptreferenz festgelegte Modell nicht verfügbar sein sollte.
8. Wählen Sie die Benutzergruppe aus, die Zugriff auf diese KI-Voreinstellung haben soll. 
9. Speichern Sie die KI-Voreinstellung.
   
   Ergebnis: Sie haben eine neue KI-Voreinstellung mit einer Referenz auf eine andere KI-Voreinstellung eingerichtet.
10. Optional: Aktivieren Sie die KI-Voreinstellung über die Checkbox Diese Voreinstellung ist aktiv und kann genutzt werden und geben Sie Einstellungen für die Sichtbarkeit im Benutzer-Chat an, siehe Allgemeine Konfigurationsoptionen.
11. Optional: Überprüfen Sie die Erweiterten Einstellungen. 

Allgemeine Konfigurationsoptionen

Sie können in den KI-Voreinstellungen für die konfigurierten Modelle folgende Einstellungen angeben, die die Verwendbarkeit und Sichtbarkeit der konfigurierten Voreinstellung im Benutzer-Chat beeinflussen:

• Wenn Sie eine KI-Voreinstellung verwenden wollen, müssen Sie sie aktivieren.
• Sie haben nach dem Aktivieren einer Voreinstellung verschiedene Möglichkeiten, diese KI-Voreinstellung für die Benutzung im Chat-Fenster einzustellen.
  • Zunächst müssen Sie die Verwendung im Benutzer-Chat über die entsprechende Checkbox freigeben.
  • Zusätzlich können Sie eine KI-Voreinstellung als Standard für Benutzer-Chats angeben. 
  • Bei Bedarf können Sie außerdem die KI-Voreinstellungen für die Anzeige im Benutzer-Chat gruppieren.

 

 

Einstellung	Beschreibung
Diese Voreinstellung ist aktiv und kann genutzt werden.	Sie müssen eine Voreinstellung aktivieren, um sie in einem Benutzer-Chat, für eine Automatisierung oder als Referenz für eine andere KI-Voreinstellung verwenden zu können. Inaktive Konfigurationen sind nicht produktiv einsetzbar.
Diese Voreinstellung kann in ALBERTs Chat genutzt werden.	Wenn Sie die Einstellung aktivieren, ist diese Voreinstellung unter dem angegebenen Namen im Benutzer-Chat verfügbar.
Diese Voreinstellung ist in ALBERTS Chat des Benutzers als Standard ausgewählt.	Wenn Sie diese Einstellung aktivieren, ist diese Voreinstellung die Standardauswahl im Benutzer-Chat (für die ausgewählte Benutzergruppe). Die Voreinstellung wird für den Benutzer in der Liste der Chat-Optionen mit blauem Chat-Symbol angezeigt: Standard-Voreinstellung mit blauem Chat-Symbol im Benutzer-Chat
Diese Voreinstellung referenziert auf eine andere Voreinstellung.	Aktivieren Sie diese Einstellung, wenn die KI-Voreinstellung nicht direkt ein Sprachmodell anbindet, sondern auf eine andere KI-Voreinstellung verweist und diese um zusätzliche Einstellungen ergänzt.  Für weitere Informationen siehe Auf einander aufbauende KI-Voreinstellungen.
Gruppierung	Wenn Sie Benutzern im Chat viele Voreinstellungen zur Auswahl anbieten, kann es hilfreich sein, die Voreinstellungen zu gruppieren.   Anzeige der Gruppierungen in der Modellauswahl im Benutzer-Chat Geben Sie dazu einen nicht bereits verwendeten Gruppennamen in das Auswahlfeld ein. Bereits verwendete Namen werden zur Auswahl angezeigt. Wird ein Gruppenname von keiner Voreinstellung genutzt, wird er auch nicht mehr angezeigt.

Erweiterte Einstellungen

In den Erweiterten Einstellungen können Sie Detaileinstellungen festlegen. Alle Einstellungen sind optional. Die ersten drei Einstellungen, die sich auf die Verbindung zu einem Sprachmodell beziehen, sind nur verfügbar, wenn Sie eine Verbindung einrichten und nicht eine andere Voreinstellung referenzieren.

Einstellung	Beschreibung
URL	Angabe der URL, über die die Verbindung zum Sprachmodell hergestellt wird. Geben Sie hier ggf. eine vom Standard abweichende Basis-URL an. Diese Basis-URL wird für Chat-Aufrufe und Modell-Aufrufe um die entsprechenden Angabe vervollständigt. (Diese Einstellung ist nur verfügbar, wenn Sie keine Referenz auf eine andere KI-Voreinstellung bearbeiten.)
Chat-Pfad	Angabe des Pfads, um den die URL für den Chat-Aufruf vervollständigt wird. (Diese Einstellung ist nur verfügbar, wenn Sie keine Referenz auf eine andere KI-Voreinstellung bearbeiten.)
Modell-Pfad	Angabe des Pfads, um den die URL für den Modell-Aufruf vervollständigt wird. (Diese Einstellung ist nur verfügbar, wenn Sie keine Referenz auf eine andere KI-Voreinstellung bearbeiten.)
Timeout in MS	Definiert in Millisekunden, nach welcher Zeit die API die Verbindung zum Service abbricht, wenn das System keine Verbindung zum Service herstellen kann. Die Standardeinstellung ist 60000 Millisekunden (60 Sekunden).
Max Tokens	Definiert die maximale Anzahl an Token, die in der Chatvervollständigung erzeugt werden. Die Gesamtlänge der eingegebenen und generierten Token ist durch die Kontextlänge des Modells begrenzt.
Temperatur	Definiert die Sampling-Temperatur (Wert zwischen 0 und 2). Werte über 0,7 machen die Ausgabe zufälliger, während Werte unter 0,5 sie gezielter und deterministischer machen: 0: Fast keine Zufälligkeit. Die vorhersehbarste Antwort wird gewählt. Der Text ist sehr präzise, manchmal monoton. 0,2 - 0,5: Wenig Kreativität. Der Text bleibt meist nah an den wahrscheinlichsten Fortsetzungen. 0,7 - 1,0: Mehr Vielfalt und Kreativität. Der Text kann abwechslungsreicher und origineller werden. > 1,0: Sehr hohe Zufälligkeit. Der Text kann nicht sinnvolle oder zusammenhanglose Ausgaben enthalten. Wenn Sie keinen Wert angeben, gilt der Standardwert des jeweiligen Modells.
Top-p	Definiert das Nukleus-Sampling (Wert zwischen 0 und 1), das festlegt, wie viele wahrscheinlichsten Wörter zur Vergügung stehen (die zusammen mindestens p% der Gesamtwahrscheinlichkeit ausmachen): 0: Extrem eingeschränkt. Das Modell wird extrem eingeschränkt und berücksichtigt nur das wahrscheinlichste nächste Wort (kaum Vielfalt). Nahe 0 (z. B. 0,1 oder 0,2): Sehr konservativ. Das Modell nutzt nur die allerwahrscheinlichsten Fortsetzungen. 0,8 - 0,95: Typischer Bereich. Hier liegt in der Praxis oft der Standardwert, weil Texte so meist sinnvoll, aber auch kreativ sind. 1: Zufällig. Es werden (fast) alle möglichen Fortsetzungen berücksichtigt. Das Ergebnis wird sehr zufällig und weniger kontrolliert. Wenn Sie keinen Wert angeben, gilt der Standardwert des jeweiligen Modells.
History-Limit	Erlaubt die Beschränkung der maximalen Anzahl an Nachrichten in der Historie.
Kontext	Über den Kontext können Sie Texte, Befehle und Anweisungen mitgeben, die die KI immer beachten soll. Auf diese Weise können Sie Terminologievorgaben machen oder eine Tonalität vorschreiben. Im Kontext können Sie folgende Variablen verwenden: ${currentDate:dd.MM.yyyy} für das aktuelle Datum. ${userFullName} für den vollständigen Namen (Vorname und Nachname) des aktuellen Benutzers. ${userName} für den Benutzernamen des aktuellen Benutzers. ${userLanguageCode} für die eingestellte Sprache des aktuellen Benutzers.
Willkommensnachricht in ALBERTs Chat	Sie können optional einen Text in Markdown-Format angeben. Dieser Text wird Benutzern angezeigt, wenn Sie einen neuen Chat mit der entsprechenden KI-Voreinstellung starten. Sie können darüber Benutzern zusätzliche Informationen geben, wie der Chat verwendet wird oder für welche besonderen Einsatzzwecke er dient. Siehe Beispiel für eine Willkommensnachricht.  In der Willkommensnachricht können Sie folgende Variablen verwenden: ${currentDate:dd.MM.yyyy} für das aktuelle Datum. ${userFullName} für den vollständigen Namen (Vorname und Nachname) des aktuellen Benutzers. ${userName} für den Benutzernamen des aktuellen Benutzers. ${userLanguageCode} für die eingestellte Sprache des aktuellen Benutzers.
Historie simulieren	Wenn Sie auch das Plugin agourm core ai agents verwenden, haben Sie optional die Möglichkeit, eine Chat-Historie zu simulieren, um dem Chat zusätzliche Informationen zur Verfügung zu stellen oder bestimmte Verhaltensweisen vorzuschlagen. Ein Beispiel wäre, dem Chat über Historien-Einträge beizubringen, bei fehlenden Informationen zusätzlich immer noch Ergebnisse mit bestimmten Suchwörtern zu suchen. Siehe Beispiel für eine simulierte Historie.

Beispiel für eine Willkommensnachricht

Das folgende Beispiel zeigt einen Text für eine Willkommensnachricht in Markdown-Format:

# 🌟 Willkommen zur Einführung in KI-Chats! 🤖

KI-Chats sind faszinierende Technologien, die es ermöglichen, natürliche Gespräche mit Maschinen zu führen. Hier eine kurze Übersicht, wie sie funktionieren:

1. **Eingabe verstehen**: 
   - Der Benutzer gibt eine Nachricht ein, die von der KI in Textform analysiert wird.
   
2. **Verarbeitung der Eingabe**:
   - Die KI verwendet **Natural Language Processing (NLP)**, um die eingefügte Information zu interpretieren.
   
3. **Antwort generieren**:
   - Mithilfe von Algorithmen und maschinellem Lernen wird eine passende Antwort erstellt.
   
4. **Antwort ausliefern**:
   - Die generierte Antwort wird dem Benutzer in natürlicher Sprache zurückgegeben.

Für weiterführende Informationen zur Dokumentation von agorum core, besuchen Sie die [offizielle Website der agorum core Dokumentation](https://www.agorum.com/wissen/dokumentation). 📚✨

Wir hoffen, Sie genießen den Austausch mit KI-Chats! 🚀

 

Diese Beispiel-Willkommensnachricht wird Benutzern im Chat wie folgt angezeigt:

Beispiel für eine simulierte Historie

 

Tools in KI-Voreinstellungen verwenden

Sie können KI-Tools in Ihren KI-Voreinstellungen verwenden, wenn Sie das Plugin agorum core ai agents installiert und lizenziert haben. Mithilfe von Agenten und Tools können Sie etwa Operationen in agorum core ausführen, Suchen im Web durchführen oder Bildverarbeitungsfunktionen nutzen.

 

Generelle Vorgehensweise

Sie können ein KI-Tool wie folgt zu einer KI-Voreinstellung hinzufügen:

1. Klicken Sie auf die Schaltfläche Tool hinzufügen.
2. Wählen Sie das gewünschte KI-Tool in der Auswahlliste aus oder suchen Sie das Tool über die Lupe.
3. Speichern Sie Ihre Änderungen.
4. Testen Sie die KI-Voreinstellung mit dem hinzugefügten Tool. Sie können Informationen zur Verwendung des Tools im Kontext hinterlegen oder das Tool direkt im Chat verwenden.

 

Tools über KI hinzufügen

Die Liste der verfügbaren Tools ist lang. Sie können sich daher auch die Tools für Ihren Anwendungsfall von der KI vorschlagen lassen:

1. Klicken Sie auf die Schaltfläche Tools über KI hinzufügen.
   
   Ergebnis: Das Fenster zum Auswählen der Tools über die KI öffnet sich.
2. Geben Sie im Feld KI Prompt ein, wofür Sie Tools suchen. Beispiel:

   Ich möchte Bilder bearbeiten und erstellen können sowie mir Informationen über Bildmetadaten ausgeben lassen

3. Klicken Sie auf Ausführen.
   
   Ergebnis: Die KI ermittelt die relevanten Tools für den angegebenen Verwendungszweck und ergänzt die Tools in der Tools-Liste.
4. Überprüfen Sie die hinzugefügten Tools und ändern Sie die Liste bei Bedarf.
5. Speichern Sie die Änderungen.
6. Testen Sie die KI-Voreinstellung mit den hinzugefügten Tools. Sie können Informationen zur Verwendung der Tools im Kontext hinterlegen oder die Tools direkt im Chat verwenden.

 

Bearbeiten der Tools in der Tools-Liste

Zum Bearbeiten der einzelnen Einträge in der Tools-Liste können Sie folgende Schaltflächen verwenden:

 

Schaltfläche	Beschreibung
Lupe, Tool suchen und übernehmen	Anstatt ein Tool in der Auswahlliste auszuwählen, können Sie die Suche öffnen und alle relevanten Tools gezielt über Keywords suchen. Bitte beachten Sie dabei, dass Tools Entwicklerwerkzeuge sind und daher nur englische Namen und Beschreibungen haben. Geben Sie zum Suchen einen englischen Begriff ein, etwa image, um alle Tools für die Bildverarbeitung angezeigt zu bekommen.
Parameter des Tools überladen	Diese Funktion ist abhängig vom jeweiligen KI-Tool. Wenn das ausgewählte KI-Tool Konfigurationsparameter hat, können Sie die Standardeinstellungen für die Verwendung im KI-Chat überschreiben. Außerdem können Sie die geänderten Einstellungen validieren.
Tool-Konfiguration bearbeiten	Wenn Sie die entsprechende Berechtigung haben, können Sie direkt die Tool-Konfiguration öffnen, um die Einrichtung des jeweiligen Tools zu überprüfen. Für weitere Informationen siehe agorum core ai tools einrichten.
Tool deaktivieren/reaktivieren	Wenn Sie ein Tool deaktiviert haben, wird das Symbol rot angezeigt. Sie können das Tool durch einen Klick auf das rot eingefärbte Symbol wieder aktivieren. Vergessen Sie nicht, die Aufträge für die KI zu überarbeiten, wenn Sie Tools deaktivieren.
Tool aus der Tools-Liste löschen	Das entsprechende Tools wird beim Klicken auf dieses Symbol sofort aus der Tools-Liste im Workflow-Knoten gelöscht. Um es wieder hinzuzufügen, müssen Sie es erneut hinzufügen.

KI-Voreinstellungen verwalten

KI-Voreinstellungen suchen

Wenn Sie viele KI-Voreinstellungen verwalten, kann es mühsam werden, die richtige Einstellung in der Auswahlliste zu finden. Sie können daher KI-Voreinstellungen auch gezielt durchsuchen:

1. Öffnen Sie die KI-Voreinstellungen über  > Administration > Konfiguration > KI-Voreinstellungen.
2. Klicken Sie auf die Lupe neben der Auswahlliste.
   
   Ergebnis: Die Liste der KI-Voreinstellungen wird im Suchfenster geöffnet.
3. Verwenden Sie einen Suchbegriff, um die gewünschte KI-Voreinstellung zu finden.
4. Doppelklicken Sie auf einen Treffer, um den entsprechenden Eintrag auszuwählen.
   
   Ergebnis: Sie können mit der Bearbeitung der betreffenden KI-Voreinstellung fortfahren.

KI-Voreinstellungen ändern

Wenn sich Ihre Verbindungsinformationen geändert haben oder andere Einstellungen ändern wollen, gehen Sie wie folgt vor:

1. Öffnen Sie die gewünschte KI-Voreinstellung, indem Sie  > Administration > Konfiguration > KI-Voreinstellungen öffnen, die Voreinstellung in der Auswahlliste wählen und Bearbeiten klicken.
2. Ändern Sie bei Bedarf die vorhandenen Einstellungen (siehe Allgemeine Einstellungen und Erweiterte Einstellungen).
3. Speichern Sie die geänderte Konfiguration.
4. Testen Sie ggf. die Verbindung durch Klicken auf Verbindung mit dem KI-Modell testen.
   
   Ergebnis: Sie haben die KI-Voreinstellung geändert.

KI-Voreinstellung duplizieren

1. Öffnen Sie die KI-Voreinstellungen über   > Administration > Konfiguration > KI-Voreinstellungen.
2. Wählen Sie in der Auswahlliste die KI-Voreinstellung aus, die Sie duplizieren wollen.
3. Klicken Sie auf das Symbol (Konfiguration duplizieren) neben der Auswahlliste.
   
   Ergebnis: Das Fenster Klonen einer vorhandenen KI-Voreinstellung öffnet sich.
4. Geben Sie den Namen der neuen KI-Voreinstellung an und ggf. ein Konfigurationsprojekt an. Das Verwenden eines Konfigurationsprojekts hat den Vorteil, dass die KI-Voreinstellungen bequem in andere Systeme überführt werden können.
   
   Ergebnis: Die duplizierte KI-Voreinstellung öffnet sich im Fenster KI-Voreinstellung einrichten. Sie können bei Bedarf weitere Änderungen vornehmen.

KI-Voreinstellung löschen

1. Öffnen Sie die gewünschte KI-Voreinstellung, indem Sie  > Administration > Konfiguration > KI-Voreinstellungen öffnen, die Konfiguration in der Auswahlliste wählen und Bearbeiten klicken.
2. Klicken Sie Voreinstellung löschen.
3. Bestätigen Sie die Frage, ob Sie die angegebene Konfiguration löschen wollen, mit Ja.
   
   Ergebnis: Sie haben die Konfiguration für die KI-Voreinstellung gelöscht.

Aktualisieren der Einstellungen nach einer Migration von agorum core ai llm

Wenn Sie zuvor das Vorgängerplugin agorum core ai llm installiert hatten, werden bei der Installation von agorum core ai die bereits vorhandenen Konfigurationen automatisch in agorum core ai überführt. Sie müssen die Konfigurationen jedoch überprüfen und testen, um sie mit agorum core ai zu verwenden.

1. Öffnen Sie  > Administration > Konfiguration > KI-Voreinstellungen.
   
   Ergebnis: Das Fenster KI-Voreinstellungen einrichten öffnet sich.
2. Wählen Sie die migrierte Konfiguration, die Sie anpassen möchten, in der Auswahlliste aus und klicken Sie Bearbeiten. Sie erkennen die migrierten Konfigurationen daran, dass der Name mit 'migrated-' beginnt.
3. Überprüfen Sie die Einstellungen, insbesondere auch die Pfade in den Erweiterten Einstellungen.
4. Testen Sie die Verbindung über Verbindung mit dem KI-Modell testen.
5. Optional: Ändern Sie bei Bedarf den Namen.
6. Aktivieren Sie die Voreinstellung, indem Sie die entsprechende Einstellung markieren.
7. Speichern Sie Ihre Änderungen.

Vorlagen veröffentlichen

Benutzer können allgemein veröffentlichte Vorlagen nur benutzen, aber im Allgemeinen nicht bearbeiten oder löschen.

Zusätzlich können Benutzer eigene Vorlagen erstellen und ihre eigenen Vorlagen bearbeiten, überschreiben oder löschen. 

Das System legt die von Benutzern erstellten Vorlagen in das Verzeichnis Home des jeweiligen Benutzers und dort in den Unterordner MyAdmin/agorum.ai/templates.

Sie können diese Vorlagen veröffentlichen, damit auch andere Benutzer sie sehen und in Chats verwenden können:

1. Erstellen entweder Sie oder ein Benutzer die Vorlage, siehe Eine Vorlage erstellen.
   
   Ergebnis: Das System legt die Vorlage im Verzeichnis Home des jeweiligen Benutzers ab.
2. Verschieben Sie die Vorlage aus dem Verzeichnis Home in ein öffentliches Verzeichnis (etwa unterhalb von Dateien/…). 

   Tipp: Sie können einen eigenen Ordner für die Verwaltung aller veröffentlichten Templates festlegen.

3. Optional: Sie können die Vorlage mit einer ACL versehen.
   
   • Die Benutzer, die durch die ACL Leserecht besitzen, können die Vorlagen sehen und wählen.
   • Die Benutzer, die durch die ACL Schreibrecht besitzen, können die Vorlagen bearbeiten.