Die agorum.ai.agents.library.basic Tools-Bibliothek kennenlernen

Zusammen mit agorum core ai agents erhalten sie eine Gruppe von KI-Tools. Viele dieser Tools sind für die Verwendung in agorum core pro gedacht, andere bieten allgemein interessante Funktionen, etwa zur Bildbearbeitung.

Damit Sie sich stets einen aktuellen Überblick über die verfügbaren KI-Tools verschaffen können, gibt es ein KI-Tool tool_descriptions, das dazu dient, eine Liste aller Tools mit Beschreibungen zu erstellen. Diese Funktionalität erleichtert Entwicklern den Überblick über die implementierten Tools und deren Einsatzmöglichkeiten. Die Tools-Bibliothek wird laufend erweitert. Nach einem Update können Sie sich mithilfe dieses Utility-Tools jederzeit einen Überblick über die verfügbaren KI-Tools verschaffen.

Das Tool tool_descriptions verwenden

Voraussetzung: Sie haben die Plugins agorum core ai und agorum core ai agents installiert und Sie haben bereits eine KI-Voreinstellung eingerichtet, um die Verbindung zum KI-Anbieter Ihrer Wahl herzustellen.

1. Erstellen Sie eine neue KI-Voreinstellung über   > Administration > Konfiguration > KI-Voreinstellungen. Beispiel:
   
   • Name: toolsquery
   • Konfigurationsprojekt: agorum.doc.test
2. Richten Sie die KI-Voreinstellung als Einstellung ein, die aktiv im Chat genutzt werden kann und auf eine andere Voreinstellung referenziert, über die die Verbindung zum KI-Anbieter hergestellt wird.
3. Klicken Sie im Bereich Tools auf die Schaltfläche Tool hinzufügen.
4. Geben Sie im Auswahlfeld für das Tool "tool descriptions" ein und wählen Sie das vorgeschlagene Tool Returns the description of all available ai tools (agorum_ai_agents_library_basic_tool_descriptions) aus. 
5. Klappen Sie die Erweiterten Einstellungen auf.
6. Geben Sie im Feld Kontext etwa folgenden Text ein:

   Recherche in den vorhanden Tools über dein Tool. Lies am besten immer alle aus und beantworte dann die Frage
   
   Allgemeine Daten:
   Aktuelles Datum: ${currentDate:dd.MM.yyyy HH:mm:ssXXX}
   Mein Loginname: ${userName}
   Mein Name: ${userFullName}
   meine Sprache: ${userLanguageCode}  - Antworte mir immer in meiner Sprache
   
   Erstelle nach einer Antwort einen Spruch in einen 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.

7. Ergänzen Sie optional im Feld Willkommensnachricht in ALBERTs Chat einen Text, über den der Benutzer direkt weiß, welche Funktionen der Chat bietet. Beispiel:

   # 👋 Willkommen in ALBERTs agorum core tools - Chat!
   
   **Schön, dass du da bist!**  
   Hier kannst du Fragen rund um die agorum core ai - Tools stellen oder gezielt nach Informationen recherchieren. Ob du Details zu Funktionen suchst, Hilfe bei der Anwendung brauchst oder einfach wissen willst, was alles möglich ist – ich unterstütze dich gerne!
   
   ---
   
   > **Tipp:**  
   > Formuliere deine Suchanfrage möglichst konkret, z. B.:  
   > *"Mit welchen Tools kann ich die Dokumentation durchsuchen?"* oder  
   > *"Gibt es Tools für eine Suche im Internet?"*
   
   Viel Spaß beim Entdecken – leg direkt los! 🚀

8. Speichern Sie die KI-Voreinstellung.
9. Öffnen Sie ALBERTs Chat und wählen Sie die neu erstellte Voreinstellung für den Chat aus: Chat: agorum_doc_test_toolsquery.
10. Jetzt können Sie mithilfe des Tools Informationen über die KI-Tools abfragen. Beispiele: 

    Erstelle eine vollständige Liste aller verfügbaren Tools

    Erstelle eine Beschreibung des Tools web_search_searchapi und der verfügbaren Parameter
    

 

 

Tool-Kategorien

Die Tools-Bibliothek enthält momentan Tools, die grob in folgende Kategorien unterteilt werden können:

Kategorie	Beschreibung
agorum core	Die agorum core Tools umfassen eine breite Palette von Funktionen zur Verwaltung und Organisation von Objekten in agorum core. Diese Tools erleichtern die Strukturierung und Verwaltung von Dokumenten, wie das Erstellen, Verschieben, Verlinken und Löschen von Dateien und Ordnern. Darüber hinaus bieten sie Funktionen für das Workflow-Management, die E-Mail-Verwaltung, Adressbuchdienste und die Ausführung facettierter Suchvorgänge.
image	Die Image-Tools sind spezialisiert auf die Verarbeitung und Manipulation von Bilddaten innerhalb von agorum core. Sie ermöglichen das Erstellen von Bildvorschauen und das Verlinken von Bildern. Mit der Integration von OpenAI können diese Tools Bilder auf Basis von Textbeschreibungen erzeugen oder bestehende Bilder modifizieren
knowledge	Die Knowledge-Tools sind darauf ausgelegt, Wissensressourcen innerhalb von agorum core zu organisieren, abzurufen und anzuzeigen. Sie bieten Strukturen zur Verwaltung von Wissensdokumenten und -bäumen, geben umfassende Übersichten und Schnellzugriffe auf spezifisches Wissen
utils	Die Utils-Tools bieten eine vielfältige Sammlung allgemeiner Funktionen, die in verschiedenen Kontexten nützlich sind. Sie ermöglichen grundlegende Operationen wie das Generieren von UUIDs, das Abrufen des aktuellen Datums und der aktuellen Uhrzeit und das Durchführen von Datums- und Zeitoperationen.
web	Die Web-Tools fokussieren sich auf Interaktionen mit dem Internet, einschließlich der Durchsuchung von Webseiten und der Durchführung von Suchvorgängen. Sie ermöglichen es Benutzern, Inhalte aus Webquellen zu crawlen und abzurufen, sei es als Rohinhalt, als Markdown-strukturierter Text oder als Liste von URLs. Mit der Integration von Websuch-APIs können sie umfassende Informationen aus dem Internet effizient durchsuchen und abrufen.

Tools im Fokus

Im Folgenden werden einige ausgewählte Tools vorgestellt.

 

Tool	Kategorie	Beschreibung
agorum_ai_agents_library_basic_search_in_agorum_core	agorum core	Ermöglicht die Suche nach Objekten in agorum core und gibt die Ergebnisse als UUIDs zurück.
agorum_ai_agents_library_basic_write_note	agorum core	Erstellt eine Notiz, die an ein agorum core Objekt angehängt wird. Diese Funktion ist nützlich, um Informationen, Erinnerungen oder Anmerkungen zu einem bestimmten Dokument zu speichern.
agorum_ai_agents_library_basic_create_mail	agorum core	Erstellt einen neuen E-Mail-Entwurf in agorum core. Ermöglicht die Erstellung neuer E-Mails zur internen oder externen Kommunikation.
agorum_ai_agents_library_basic_create_document	agorum core	Erstellt ein neues Dokument in agorum core und gibt die UUID, den Namen und den Objektlink des erstellten Objekts zurück.
agorum_ai_agents_library_basic_write_content	agorum core	Schreibt den bereitgestellten Inhalt in ein vorhandenes agorum core Dokument. Es bietet unterschiedliche Schreibarten, wie Aktualisieren, Anhängen oder Voranstellen des Inhalts.
agorum_ai_agents_library_basic_get_object_metadata	agorum core	Dieses Tool wird verwendet, um die Metadaten eines agorum core Objekts abzurufen. Es gibt ein JSON-Objekt zurück, das die UUID des Objekts, seinen Namen, seine Pfade und die zugehörigen Metadaten enthält.
agorum_ai_agents_library_basic_documentation_tree	agorum core	Stellt die Dokumentation von agorum core als Markdown-Indexbaum dar. Dieser Baum ermöglicht es, schnell relevante Dokumentationen zu finden, indem er eine strukturelle Übersicht aller verfügbaren Dokumente bietet.
agorum_ai_agents_library_basic_documentation_document	agorum core	Ruft ein einzelnes Dokument aus der agorum core Dokumentation basierend auf der UUID ab. Diese Funktion stellt Informationen oder Anleitungen bereit, um Nutzern bei spezifischen Aufgaben oder Fragen zu helfen.
agorum_ai_agents_library_basic_tool_descriptions	utils	Gibt die Beschreibung aller verfügbaren KI-Tools zurück. Diese Funktion ist nützlich, um schnell eine Übersicht über die verfügbaren Funktionalitäten zu erhalten. Siehe Das Tool tool_descriptions verwenden.
agorum_ai_agents_library_basic_create_image_openai	image	Dieses Tool ermöglicht die Erstellung eines Bildes basierend auf einem textbasierten Prompt unter Verwendung von OpenAI-Technologien. Das generierte Bild wird in agorum core gespeichert und es werden Informationen wie die UUID des Bildes, ein Objektlink und ein Bildlink zurückgegeben. Diese Links können genutzt werden, um das Bild direkt anzuzeigen oder darauf zuzugreifen.
agorum_ai_agents_library_basic_web_crawl	web	Dieses Tool durchsucht eine Website und gibt den Inhalt als Markdown-strukturierte Daten zurück. Es bietet eine strukturierte Formatierung, ideal für die Anzeige und einfache Verarbeitung von Webinhalten.
agorum_ai_agents_library_basic_web_search_searchapi	web	Führt eine Websuche durch und gibt die Ergebnisse als JSON zurück. Diese Suchfunktion unterstützt verschiedene Suchmaschinen und Sprachen zur Durchführung umfassender Suchvorgänge im Web. Ein API-Key von searchapi.io ist erforderlich.

Tools kennenlernen und testen

Sie können die ausgelieferten Tools in der Tools-Konfiguration auch direkt mit Beispieldaten testen. Auf diese Weise können Sie die einzelnen Tools auch kennenlernen und überprüfen, ob Sie für Ihren jeweiligen Einsatzzweck infrage kommen.

1. Öffnen Sie  > Administration > Konfiguration > KI-Tools.
2. Wählen Sie das Tool, das Sie näher kennenlernen und testen möchten, in der Auswahlliste aus. Geben Sie dazu einen Bestandteil des Namens ein. 
3. Klicken Sie Bearbeiten.
   
   Ergebnis: Das Fenster Tools einrichten öffnet sich.
4. Klicken Sie auf die Schaltfläche Validieren/Testen.
   
   Ergebnis: Das Fenster Tool validieren und ausführen öffnet sich.
5. Die Liste der aufgeführten Parameter ist abhängig davon, welche Parameter für das jeweilige KI-Tool zur Verfügung stehen. Tragen Sie ggf. Informationen für alle Pflichtparameter ein.
6. 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.