agorum_ai_agents_library_basic_copy_file

Anzeigename: Copies an agorum core file object

Was macht das Tool?

Dieses Tool kopiert eine Datei (ein agorum core Objekt) innerhalb von agorum core. Dabei wird eine neue Datei erstellt, die auf Wunsch auch einen neuen Namen erhalten kann. Die Dateiendung wird dabei automatisch von der Quelldatei übernommen, sofern kein neuer Name mit Endung angegeben wird. Über allowedBasePathIds kann der Kopiervorgang auf freigegebene Basispfade eingeschränkt werden (Write-Restriction).

Hinweis: Beim Erstellen der Kopie 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, um bestehende Dateien zu duplizieren, etwa als Vorlage für neue Dokumente, zur Archivierung oder zur Weiterverarbeitung in anderen Ordnern. Es ist besonders nützlich, wenn eine Datei mehrfach benötigt wird, ohne die Originaldatei zu verändern.

Funktionsbeschreibung

Parameter	Beschreibung
id (Pflicht)	ID (Pfad, numerische ID oder UUID) des agorum core Objekts, das kopiert werden soll (Quellobjekt).
targetId (Pflicht)	ID (Pfad, numerische ID oder UUID) des Zielordners, in den die Datei kopiert werden soll.
baseName (Optional)	Neuer Name für die kopierte Datei ohne Dateiendung. Wird kein Name angegeben, erhält die Kopie den Namen der Originaldatei.
allowedBasePathIds (Optional)	Einschränkung, in welche Basispfade geschrieben werden darf (Write-Restriction). Wird der Parameter gesetzt, prüft das Tool, ob der Zielordner (`targetId`) in einem erlaubten Basispfad liegt. Andernfalls wird mit einer Fehlermeldung abgebrochen.

Tipps und Tricks

Tipp: Beachten Sie, dass ausreichende Rechte für das Quell- und Zielobjekt erforderlich sind, sonst schlägt der Kopiervorgang fehl.