agorum core ai tools einrichten

Die KI-Tools bieten vielfältige Anwendungsmöglichkeiten, die von Aktionen in agorum core pro bis zu einer Websuche reichen. In dieser Dokumentation erfahren Sie, wie Sie die KI-Tools für die Verwendung in agorum core pro einrichten.

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

Sie können hier:

• die mitgelieferten KI-Tools bei Bedarf konfigurieren
• Toolgruppen erstellen
• neue KI-Tools einrichten

Diese Dokumentation enthält Informationen zum Einrichten der mitgelieferten KI-Tools und zum Erstellen von Toolgruppen. Für das Einrichten neuer KI-Tools müssen Sie zunächst das Tool mit JavaScript selbst schreiben oder einen MCP-Server einrichten, um andere Tools anzubinden. Die Konfiguration selbst erstellter Tools ist daher in der entsprechenden Dokumentation beschrieben, siehe  agorum core ai tools entwickeln,

Mitgelieferte KI-Tools einrichten

Nachdem Sie sich einen Überblick über die mitgelieferten KI-Tools verschafft haben, ist es wichtig, dass Sie die Tools, die Sie verwenden möchten, bei Bedarf für die Verwendung einrichten.

KI-Tools, die keine weiteren Einstellungen haben, können Sie auch direkt verwenden. Es gibt aber KI-Tools, die die Eingabe eines API-Key erfordern. Diese müssen Sie auf jeden Fall einrichten. Außerdem kann es auch sinnvoll sein, die Parameter der Tools zu überprüfen und ggf. Voreinstellungen vorzunehmen. Parameter mit fester Definition werden nicht an die KI weitergegeben. 

1. Öffnen Sie  > Administration > Konfiguration > KI-Tools.
   
   Ergebnis: Das Fenster Tool einrichten öffnet sich.
2. Klicken Sie auf die Schaltfläche (Plus), um eine neue Konfiguration zu erstellen.
   
   Ergebnis: Das Fenster Neues Tool anlegen öffnet sich.
3. Wählen Sie die Voreinstellung aus, deren Einstellungen Sie bearbeiten wollen. Beispiel: Creates a new agorum core document (agorum_ai_agents_library_basic_create_document)
4. Klicken Sie auf Bearbeiten.
5. Überprüfen Sie die Einstellungen. In diesem Fall könnten Sie etwa festlegen wollen, dass mit dem Tool immer nur txt-Dokumente erstellt werden. 
6. Speichern Sie die Änderungen.
7. Klicken Sie auf Validieren/Testen und testen Sie die geänderte Konfiguration mit Testeinstellungen.
   
   Ergebnis: Das Fenster Tool validieren und ausführen öffnet sich.
8. Jetzt haben Sie zwei Möglichkeiten:
   
   • Validieren: Testet, ob das Tool mit den angegebenen Parametern ausgeführt werden kann. Sie erhalten ggf. eine Fehlermeldung, falls nicht alle erforderlichen Parameter ausgefüllt sind oder die Angaben nicht verwendet werden können.
   • Ausführen: Das Tool wird mit den angegebenen Parametern ausgeführt. Das Fenster Rückgabe des Tools öffnet sich und enthält die zurückgegebenen JSON-Daten.
9. Schließen Sie nach erfolgreichem Testen die KI-Tools-Konfiguration.
10. Jetzt können Sie das mitgelieferte Tool in Ihren KI-Voreinstellungen verwenden, siehe KI-Voreinstellungen einrichten.

Toolgruppen erstellen

Sie können Toolgruppen erstellen, um sich die Auswahl von Tools zu erleichtern. Eine Toolgruppe fasst einfach mehrere Referenzen auf andere Tools zusammen, um diese nicht einzeln angeben zu müssen, sondern in einer KI-Voreinstellung die Toolgruppe einzutragen, um alle darin gebündelten Tools auf einmal anzugeben.

Gehen Sie wie folgt vor, um eine Toolgruppe zu erstellen: 

1. Öffnen Sie  > Administration > Konfiguration > KI-Tools.
   
   Ergebnis: Das Fenster Tool einrichten öffnet sich.
2. Klicken Sie auf die Schaltfläche (Plus), um eine neue Konfiguration zu erstellen.
   
   Ergebnis: Das Fenster Neues Tool anlegen öffnet sich.
3. Geben Sie den Namen ein, den Sie dem neuen KI-Tool geben wollen. Der Name darf nur aus Kleinbuchstaben und Zahlen bestehen. Geben Sie optional ein Konfigurationsprojekt an und klicken Sie Speichern.
4. Wählen Sie in der Auswahlliste Tool-Type den Eintrag Toolgroup aus.
   
   Ergebnis: Der Bereich zum Angeben der Tools öffnet sich.
5. Fügen Sie die relevanten Tools zur Toolgruppe hinzu, siehe Tools in KI-Tools verwenden.
6. Markieren Sie die Checkbox Tool ist aktiv und kann genutzt werden.
7. Speichern Sie das neue Tool bzw. die Toolgruppe.
   
   Ergebnis: Sie haben eine neue Toolgruppe erstellt, die Sie anstelle einzelner Tools in KI-Voreinstellungen verwenden können.

Tools in KI-Tools verwenden

Sie können KI-Tools in Ihren KI-Tool-Einstellungen referenzieren, um Toolgruppen zu erstellen.

 

Generelle Vorgehensweise

Sie können ein KI-Tool wie folgt zu einer Toolgruppe 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.

 

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.

 

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	Sie können direkt die Tool-Konfiguration öffnen, um die Einrichtung des jeweiligen Tools zu überprüfen.
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.

Chat für die agorum core Dokumentation einrichten (Praxisbeispiel)

Die Tools-Bibliothek enthält zwei Tools zur Abfrage der agorum core Dokumentation. Mit dem einen Tool kann die gesamte Dokumentationsstruktur ermittelt werden, das zweite Tool dient zum Abrufen des Inhalts einer bestimmten Dokumentation. 

In diesem Beispiel erfahren Sie, wie Sie diese Tools einrichten und eine KI-Voreinstellung für den ALBERT Chat erstellen, damit Ihre Anwender mit der agorum core Dokumentation chatten und direkt Fragen zur Verwendung stellen können.

1. Lernen Sie die beiden KI-Tools für die Dokumentation kennen.
   
   • agorum_ai_agents_library_basic_documentation_tree: Dieses Tool ruft den Dokumentationsbaum auf, also Informationen über die Struktur der Dokumentation. Das Tool hat keine Parameter. Sie müssen also in den KI-Tools keine Einstellungen vornehmen.
   • agorum_ai_agents_library_basic_documentation_document: Dieses Tool liest den Inhalt eines bestimmten Dokumentationsobjekts anhand von dessen UUID. Der Parameter UUID soll leer bleiben, damit er im Chat-Verlauf gefüllt werden kann. Sie müssen dieses KI-Tool also ebenfalls nicht in den KI-Tools einrichten.
2. Legen Sie eine KI-Voreinstellung an, die die Verbindung zwischen agorum core und einem KI-Sprachmodell herstellt. Für den Chat mit der Dokumentation empfehlen wir aktuell (Stand Juni 2025) Azure OpenAI oder OpenAI mit dem Sprachmodell gpt-4.1. Für Informationen zum Einrichten der KI-Voreinstellung siehe Modellkonfigurationen einrichten.
3. Erstellen Sie eine neue KI-Voreinstellung für den Dokumentations-Chat. Öffnen Sie dazu  > Administration > Konfiguration > KI-Voreinstellungen.
   
   Ergebnis: Das Fenster KI-Voreinstellungen einrichten öffnet sich.
4. Klicken Sie auf die Schaltfläche (Plus), um eine neue Konfiguration zu erstellen.
   
   Ergebnis: Das Fenster Anlage einer neuen KI-Voreinstellung öffnet sich.
5. Geben Sie den Namen agorum_documentation ein und optional das Konfigurationsprojekt, in dem Sie Ihre KI-Tools und KI-Voreinstellungen, verwalten wollen. Klicken Sie Speichern.

    

   

   Name für die neue KI-Voreinstellung festlegen

    

   
   Ergebnis: Die neue Konfiguration wird in der Liste der Konfigurationen angezeigt
6. Klicken Sie auf Bearbeiten.
   
   Ergebnis: Das Fenster KI-Voreinstellung einrichten öffnet sich.
7. Markieren Sie die Checkboxen Diese Voreinstellung ist aktiv und kann genutzt werden, Diese Voreinstellung kann in ALBERTs Chat genutzt werden und Diese Voreinstellung referenziert auf eine andere Voreinstellung.
8. Wählen Sie in der Auswahlliste Referenz auf eine Voreinstellung die KI-Voreinstellung aus, die Sie referenzieren wollen, am besten eine Voreinstellung, die Azure OpenAI oder OpenAI mit dem Sprachmodell gpt-4.1 anbindet.
9. Klappen Sie die Erweiterten Einstellungen auf.
10. Kopieren Sie den Text aus dem Kontextbeispiel für den Dokumentations-Chat in das Feld Kontext. Den Text im letzten Abschnitt können Sie 
11. Kopieren Sie den Text aus dem Beispiel für eine Willkommensnachricht in das Feld Willkommensnachricht in ALBERTs Chat.
12. Klicken Sie im Bereich Tools auf die Schaltfläche Tool hinzufügen und fügen Sie die beiden Dokumentationstools hinzu. Für die Vorgehensweise siehe Tools in KI-Voreinstellungen verwenden.
    
    • agorum_ai_agents_library_basic_documentation_tree
    • agorum_ai_agents_library_basic_documentation_document
13. Speichern Sie die KI-Voreinstellung.
    
    Ergebnis: Sie haben eine neue KI-Voreinstellung für den Dokumentations-Chat angelegt und können diese jetzt in ALBERTs Chat verwenden.

 

 

Kontextbeispiel für den Dokumentations-Chat

Du bist eine KI, die hilfreich Fragen beantwortet und dazu IMMER die Dokumentation von agorum core nutzt.

Erfinde NICHTS!
Nutze kein eigenes Wissen!
Rufe die Tools für die Dokumentation auf!
In dieser Konversation geht es ausschließlich um Themen, rund um agorum core. NUTZE immer die Dokumentations-Tools.

Jede Antwort soll eine Fundstelle/Zitat aus der offiziellen Doku enthalten.
Prüfe immer die Doku und verlinke die Quelle mithilfe der Dokumentations-Tools!

Jede Antwort MUSS auf einem aktuellen Doku-Tool-Aufruf basieren. Keine Erklärung, kein Beispiel, keine Handlung ohne vorherigen Doku-Tool-Aufruf!
Gib einen Link immer als anklickbaren Link aus.

Allgemeines:
Heute ist der ${currentDate:dd.MM.yyyy HH:mm:ssXXX}
Mein Name lautet: ${userFullName}
Mein Loginusername lautet: ${userName}
Mein Sprachcode ist ${userLanguageCode} - bitte Antworte immer in dieser Sprache
Bei Datumsberechnungen berücksichtige die Zeitzone

Nach einer Antwort erstelle einen Spruch in einem neuen Absatz:
Mit **ALBERT** chattest du, bist immer schlau im Nu! [hier noch ein tolles Emoticon, das passt]
Variiere den Paarreim, je nach Kontext. Soll immer fetzig klingen.

Beispiel für eine Willkommensnachricht in ALBERTs-Chat

# Willkommen zu ALBERTs agorum core Dokumentations-Chat! 👋

**Hallo und herzlich willkommen!** 

In diesem Chat können Sie Hilfe und Informationen rund um die agorum core Dokumentation erhalten. **agorum core** ist eine leistungsstarke Plattform zur effizienten Verwaltung von Daten und Dokumenten.

> **Tipp**: Wenn Sie eine bestimmte Funktion suchen, können Sie einfach nach Schlagworten fragen! Zum Beispiel: "Wie richte ich Benutzerrechte ein?"

### Unsere Hauptthemen:
- **Installation und Konfiguration**: Erfahren Sie, wie Sie agorum core auf Ihrer Plattform einrichten.
- **Benutzerhandbuch**: Finden Sie heraus, wie Sie tägliche Aufgaben und Herausforderungen meistern.
- **Entwicklerhandbuch**: Tauchen Sie ein in die Entwicklung spezieller Anwendungen und Module.

Fühlen Sie sich frei, nach allem zu fragen, was Sie interessiert. Viel Spaß beim Stöbern in der Dokumentation! 😊

Beispiel für die Anzeige und Verwendung des konfigurierten Chats