agorum_ai_agents_library_basic_object_attachments

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

Anzeigename: Object Attachments Functions

Was macht das Tool?

Dieses Tool dient zur Verwaltung von Anhängen (Attachments) an agorum core Objekten. Es unterstützt das Hinzufügen, Entfernen, Auflisten und Prüfen von Anhängen. Je nach gewählter Operation gibt das Tool ein entsprechendes JSON-Ergebnis zurück.

Empfohlener Einsatzzweck

Das Tool eignet sich, wenn Attachments von agorum core Objekten kontrolliert verwaltet oder ausgewertet werden sollen. Typische Anwendungsfälle sind:

Entfernen von Attachments
Abfrage, welche Objekte an ein bestimmtes Objekt gehängt wurden
Check, ob ein Objekt Attachments besitzt

Funktionsbeschreibung

Parameter	Beschreibung
operation (Pflicht)	Die gewünschte Operation. Erlaubte Werte: setAttachments: Fügt einem Objekt einen oder mehrere Anhänge hinzu (Duplikate werden ignoriert). removeAttachments: Entfernt einen oder mehrere Anhänge von einem Objekt. getAttachments: Listet alle Anhänge eines Objekts auf. hasAttachments: Prüft, ob das Objekt eigene oder vererbte Anhänge besitzt. getAllAttachedTo: Listet alle Objekte auf, an die dieses Objekt angehängt ist.
object (Pflicht)	ID (Pfad, ID oder UUID) des agorum core Objekts, auf das sich die Operation bezieht.
attachments (Pflicht oder optional)	Array von agorum core Objekten (ID, Pfad oder UUID), die angehängt oder entfernt werden sollen. Pflicht bei `setAttachments` und `removeAttachments`, optional bei anderen Operationen.
allowedBasePathIds (optional)	Optionaler Sicherheitsparameter für schreibende KI-Tools: Liste/Definition erlaubter Basispfade (IDs), in denen Schreiboperationen ausgeführt werden dürfen. Wenn gesetzt, wird vor dem Schreiben geprüft, ob das Zielobjekt innerhalb dieser erlaubten Pfade liegt.

Tipps und Tricks

Hinweise:

Das Tool prüft automatisch, ob die angegebenen Objekte existieren. Fehlerhafte oder nicht existierende IDs/Pfade führen zu einer Fehlermeldung.
Das Tool prüft automatisch auf Duplikate: Ein Objekt wird nicht mehrfach als Attachment an ein Objekt angefügt.