agorum_ai_agents_library_basic_create_document

Anzeigename: Creates a new agorum core document

Was macht das Tool?

Das Tool erstellt ein neues Dokument (agorum core Objekt) in einem angegebenen Zielordner innerhalb von agorum core. Es ermöglicht das gezielte Anlegen von Dateien durch Übergabe von Name, Dateiendung sowie dem gewünschten Zielordner. Optional kann das Überschreiben von existierenden Dateien gesteuert werden.
Das Tool gibt nach erfolgreicher Ausführung die UUID, den Namen und einen Direktlink zum erstellten Dokument zurück.

Hinweis: Beim Erstellen des Dokuments 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 automatisiert oder manuell neue Dokumente in agorum core anzulegen. Es eignet sich auch für Integrationen, bei denen aus externen Systemen heraus Dokumente erzeugt werden sollen.

Funktionsbeschreibung

Parameter	Beschreibung
basename (Pflicht)	Der Basisname (ohne Dateierweiterung) des zu erstellenden agorum core Dokuments. Folgende Zeichen sind nicht erlaubt: `\ / : ? " < > \| \n \r *` Der Name darf nicht mit einem Punkt enden.
nameExtension (Pflicht)	Dateiendung (z. B. `txt`, `js`). Folgende Zeichen sind nicht erlaubt: `\ / : ? " < > \| \n \r *` Die Dateiendung darf nicht mit einem Punkt enden.
targetId (Pflicht)	Objekt-ID (Pfad, numerische ID oder UUID) des Zielordners, in dem das Dokument erstellt werden soll. Das Ziel muss ein Ordner (`folderobject)` sein, andernfalls liefert das Tool einen Fehler.
overwrite (Optional)	Steuert, ob eine bestehende Datei mit gleichem Namen überschrieben werden darf. true: Existiert die Datei bereits, wird sie wiederverwendet bzw. überschrieben (kein Fehler). false: Existiert die Datei bereits, bricht das Tool mit Fehler ab. Standard: `false`
allowedBasePathIds (Optional)	Einschränkung, in welchen Basis-Pfaden geschrieben/angelegt werden darf (Write-Restriction). Wenn gesetzt, prüft das Tool zusätzlich, ob `targetId` innerhalb der erlaubten Basis-Pfade liegt. Andernfalls wird ein Fehler zurückgegeben.

Beispiel-Prompt

Lege im Ordner /agorum/roi/Files/Doku1 bitte ein Dokument mit dem Namen "Protokoll" und der Endung "txt" an. Wenn es schon existiert, darf es überschrieben werden.

Tipps und Tricks

Tipp: Wenn Sie Duplikate verhindern wollen, lassen Sie overwrite auf dem Standardwert (false). So erhalten Sie im Konfliktfall bewusst einen Fehler und können einen eindeutigen Dateinamen vergeben.