agorum_ai_agents_library_basic_create_path

Anzeigename: Creates a path in agorum core

Was macht das Tool?

Dieses Tool erstellt einen neuen Pfad (Ordnerstruktur) im agorum core System. Es ermöglicht das Anlegen von verschachtelten Ordnern in einem definierten Zielordner. Die Pfadangabe erfolgt durch eine Liste von einzelnen Pfadsegmenten, die nacheinander erstellt werden, sofern sie noch nicht existieren.
Der Vorgang gibt die UUID, den Namen und den Link zum neu erzeugten letzten Pfadsegment zurück.

Hinweis: Beim Erstellen des neuen Pfads setzt das Tool automatisch die Metadaten agorum_ai_created_by_ai (Boolean) und agorum_ai_chat_id (String) auf dem neu erstellten Objekt. Damit ist nachvollziehbar, dass das Objekt durch einen KI-Agenten erzeugt wurde und in welchem Chat-Kontext dies passiert ist.

Empfohlener Einsatzzweck

Das Tool eignet sich, wenn mehrere Ordner oder eine ganze Pfadstruktur in einem Schritt angelegt werden sollen. Es ist besonders hilfreich bei der automatisierten Ablage und der Neuerstellung von Datenstrukturen.

Funktionsbeschreibung

Parameter	Beschreibung
pathArray (Pflicht)	Ein Array von Pfadsegmenten, die die zu erstellende Ordnerstruktur beschreiben. Jedes Segment ist ein Ordnername. Nicht erlaubte Zeichen: `\ / : ? " < > \| \n \r * .` (am Ende kein Punkt).
targetId (Pflicht)	Die ID, UUID oder der Pfad des Zielordners, unter dem die neue Struktur angelegt werden soll. Unterstützt werden IDs, UUIDs oder spezielle Platzhalter wie `home:` `user:` `acl:` `group:`.
allowedBasePathIds (Optional)	Optionaler Schreibschutz-Parameter zur Einschränkung, wo geschrieben werden darf. Ist der Parameter gesetzt, prüft das Tool, ob `targetId` innerhalb der erlaubten Basispfade liegt. Andernfalls wird mit einer Fehlermeldung abgebrochen.

Tipps und Tricks

Tipp: Sie können beliebig viele Ebenen verschachteln, indem Sie mehrere Segmente im pathArray angeben. Die Funktion prüft automatisch, ob ein Segment (Ordner) schon existiert, und legt nur fehlende Segmente (Ordner) neu an.