agorum_ai_agents_library_basic_get_object_metadata

Anzeigename: Gets the metadata of an agorum core object

Was macht das Tool?

Dieses Tool liest die Metadaten eines agorum core Objekts aus. Als Input wird die ID, der Pfad oder die UUID eines Objekts übergeben, optional mit einer Liste bestimmter Metadatennamen.
Es liefert als Ergebnis ein JSON-Objekt mit der UUID, dem Namen, allen Pfaden und den Metadaten des Objekts. Die Metadaten werden als Key-Value-Paare im JSON zurückgegeben. Zusätzlich wird ein Link auf das Objekt bereitgestellt.

Empfohlener Einsatzzweck

Das Tool ist geeignet, um gezielt und strukturiert Metadaten einzelner Dokumente, Ordner, Benutzer, Gruppen oder beliebiger Objekte in agorum core zu ermitteln. Es ist besonders hilfreich bei Analysen, Auswertungen, für Automatisierungen, Metadatenpflege, Migrationen oder beim Entwickeln von Logiken, die auf Metadatenbasis agieren sollen. Ebenso kann es zur Fehleranalyse („Was steckt in diesem Objekt?“) oder für individuelle Reports eingesetzt werden.

Funktionsbeschreibung

Parameter	Beschreibung
id (Pflicht)	Die ID, UUID oder der Pfad des agorum core Objekts. Gibt das gewünschte Zielobjekt zum Auslesen an.
metadataFields (Optional)	Eine Liste spezifischer Metadaten-Felder, die eingelesen werden sollen. Standard: ['~', '~~'] (liest alle geerbten und nicht geerbten Metadaten). Beispiele: ['identifier', 'area'] liest nur diese Felder ['/^ag_/'] liest alle Felder, die mit „ag_“ beginnen [ ] liest alle Felder [' '] liest KEINE Felder.

Tipps und Tricks

Wenn keine metadataFields angegeben werden, werden alle Metadaten (vererbte und nicht vererbte) zurückgegeben.
Mit gezielten metadataFields kann die Performance verbessert und die Antwortmenge reduziert werden.