agorum_ai_agents_library_basic_object_attachments

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.

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.