Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI Agents > ALBERT| AI KI-Tools-Dokumentationen


agorum_ai_agents_library_basic_call_preset

Anzeigename: Call Preset

Was macht das Tool?

Dieses Tool ermöglicht es, eine KI mit einem vordefinierten Preset aufzurufen. Es übergibt einen Text als Aufgabe an die KI und optional können agorum core Objekte als Anhänge (über ihre UUIDs) mitgegeben werden. Das Tool führt einen KI-Chat mit Tool-Calls durch und gibt das Ergebnis zurück.

Empfohlener Einsatzzweck

Das Tool eignet sich besonders für alle Szenarien, in denen vordefinierte KI-Vorlagen (Presets) verwendet werden sollen, um Arbeitsabläufe zu automatisieren oder spezifische Textanalysen, -generierungen oder -bearbeitungen mit einer KI durchzuführen.

Das Tool eignet sich hervorragend für:

Mit dem Tool können Sie mehrere KI-Aufrufe verketten oder bereits konfigurierte KI-Voreinstellungen in komplexen Szenarien wiederverwenden.

Funktionsbeschreibung

Parameter Beschreibung
preset
(Pflicht)
Das Preset (KI-Voreinstellung), mit dem festgelegt wird, welche KI genutzt wird. Dieses Preset definiert das Verhalten und die Konfiguration der aufgerufenen KI. Ohne dieses Preset kann keine KI-Funktion ausgeführt werden.
text
(Pflicht)
Der Text, der die Aufgabe für die KI beschreibt. Dies ist die Hauptanweisung, die an die KI übergeben wird.
context
(Optional)
Der Kontext, der von der KI verwendet wird. Dieser Parameter ermöglicht es, zusätzliche Kontextinformationen bereitzustellen, die die KI bei der Verarbeitung berücksichtigen soll.
attachments
(Optional)
Eine Liste von UUIDs von agorum core Objekten, die als Anhänge übergeben werden. Die KI kann auf diese Objekte zugreifen und sie in ihre Verarbeitung einbeziehen.

Format: Array von UUID-Strings
Beispiel: ["uuid1", "uuid2", "uuid3"]
disableDebug
(Optional)
Steuert, ob Debug-Informationen erstellt werden:
  • true: Debug ist ausgeschaltet, es werden keine Debug-Dateien erstellt
  • false: Debug ist eingeschaltet, es werden Debug-Dateien mit den Parametern und Ergebnissen erstellt
Standard: false (Debug ist standardmäßig aktiv)

 

Das Tool erstellt standardmäßig Debug-Dateien mit Datumsstruktur unter:

home:MyFiles/ai/logs/agorum_ai_agents_library_basic_call_preset/ 

Diese enthalten die übergebenen Parameter und das KI-Ergebnis im JSON-Format und sind hilfreich für die Fehlersuche.

Das Tool gibt zwei Felder zurück: aiResult (das Textergebnis der KI) und aiResultError (eventuelle Fehlermeldungen). Wenn Debug aktiviert ist, wird zusätzlich controllFileUUID mit der UUID der Log-Datei zurückgegeben.

Tipps und Tricks

Tipps:

  • Die KI-Voreinstellung (Preset) stellt die Verbindung zum verwendeten Sprachmodell her. Stellen Sie sicher, dass das richtige Sprachmodell für Ihren Anwendungsfall gewählt ist.
  • Wenn das aufgerufene Preset selbst Tool-Calls unterstützt, werden diese automatisch ausgeführt.
  • Anhänge können genutzt werden, um der KI zusätzliche Informationen oder Dokumente bereitzustellen.