agorum_ai_agents_library_basic_call_preset

Anzeigename: Call Preset

Hinweise:

Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Wie Sie die KI-Tools in Ihren KI-Voreinstellungen verwenden, erfahren Sie hier: ALBERT | AI agents tools einrichten

Was macht das Tool?

Dieses Tool ruft eine KI mit einem vordefinierten Preset auf. Dabei wird ein Text als Aufgabe an die KI übergeben. Optional können agorum core Objekte als Anhänge (per UUID) mitgegeben werden. Das Tool führt den Sub-Chat inkl. Tool-Calls aus und gibt das Ergebnis zurück.

Empfohlener Einsatzzweck

Das Tool eignet sich für alle Szenarien, in denen vordefinierte KI-Voreinstellungen (Presets) wiederverwendet oder verschachtelt werden sollen, z. B. zur Automatisierung von Arbeitsabläufen oder zur spezialisierten Textanalyse/-generierung/-bearbeitung.

Verschachtelung von KI-Aufrufen (Sub-Agenten): Ein Agent kann einen spezialisierten Agenten über ein Preset aufrufen
Delegierung an spezialisierte Presets (z. B. Solr-Query-Erstellung, Textanalyse, Dokumentenverarbeitung)
Verarbeitung von agorum core Objekten durch die KI über Anhänge (UUIDs)
Automatisierung komplexer Workflows, in denen mehrere KI-Spezialisten zusammenarbeiten

Funktionsbeschreibung

Parameter	Beschreibung
preset (Pflicht)	Der Name des Presets, das festlegt, welche KI aufgerufen wird und wie sie konfiguriert ist.
text (Pflicht)	Die eigentliche Aufgabenbeschreibung, die an die KI übergeben wird.
context (Optional)	Zusätzlicher Kontext, der der KI bei der Verarbeitung zur Verfügung gestellt wird.
attachments (Optional)	Liste von UUIDs (agorum core Objekte), die als Anhänge an die KI übergeben werden. Format: Array von UUID-Strings Beispiel: ["uuid1", "uuid2", "uuid3"]

Rückgabewerte

Feld	Beschreibung
aiResult	Das Textergebnis der aufgerufenen KI.
aiResultError	Enthält eine Fehlermeldung, falls die KI/der Sub-Chat einen Fehler gemeldet hat (sonst leer bzw. `null`).
controllFileUUID (nur bei Debug)	UUID der erzeugten Debug-/Log-Datei (wird nur zurückgegeben, wenn Debug aktiv ist).

Debug/Logs

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.

Sub-Chats erhalten eine eigene chat_id. Die Parent-Information wird als INFO-Eintrag in der initialen Sub-Chat-Historie mitgegeben.

Tipps und Tricks

Tipps:

Stellen Sie sicher, dass das ausgewählte Preset zum Anwendungsfall passt (z. B. Modell, Systemprompt, Tool-Rechte).
Wenn das aufgerufene Preset selbst Tool-Calls unterstützt, werden diese im Sub-Chat automatisch ausgeführt.
Nutzen Sie attachments, um der KI Dokumente/Objekte aus agorum core mitzugeben.
Tokens und Tool-Aufrufe des Sub-Agenten werden in der Statistik des übergeordneten Agenten mit erfasst (Gesamtverbrauch in Multi-Agenten-Szenarien).