agorum_ai_agents_library_basic_write_metadata

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: Sets metadata to an agorum core object

Was macht das Tool?

Dieses Tool setzt Metadaten auf ein agorum core Objekt. Es ermöglicht das gezielte Hinzufügen oder Aktualisieren von Metadatenfeldern für beliebige Objekte (z. B. Dateien, Ordner, Benutzer) im agorum core System. Die Metadaten werden als JSON-Objekt übergeben und direkt auf das Zielobjekt geschrieben. Die eigentlichen Inhalte bleiben davon unberührt.

Empfohlener Einsatzzweck

Dieses Tool ist überall dort sinnvoll, wo automatisiert oder per Workflow Metadaten an agorum core Objekten ergänzt, geändert oder neu gesetzt werden sollen. Es eignet sich insbesondere für Automatisierungen, die eine nachträgliche Verschlagwortung, Kategorisierung oder Statusaktualisierung von Objekten in agorum core erfordern.

Funktionsbeschreibung

Parameter	Beschreibung
id (Pflicht)	Objekt-ID des agorum core Objekts, auf das die Metadaten geschrieben werden sollen.
data (Pflicht)	Ein JSON-Objekt mit den zu setzenden Metadaten. Beispiel: { "metadatum1": Wert1, "metadatum2": Wert2 } Die Schlüssel entsprechen den Metadaten-Namen, die Werte den zu setzenden Inhalten.
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

Tipps:

Achten Sie darauf, dass die Metadaten-Namen exakt den im System definierten Feldern entsprechen (Kleinschreibung beachten!). Nicht vorhandene oder falsch geschriebene Metadaten werden ignoriert oder führen zu Fehlern.
Das Tool überschreibt bestehende Werte der angegebenen Metadaten. Nicht angegebene Metadaten bleiben unverändert.