agorum_ai_agents_library_basic_format_convert_object

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: Converts a document into a different format

Was macht das Tool?

Dieses Tool konvertiert ein agorum core Objekt (z. B. ein Dokument) in ein anderes Format, wie PDF oder TXT. Dabei kann das Zielverzeichnis flexibel gewählt werden. Die Konvertierung erstellt eine neue Datei im gewünschten Format und legt sie im angegebenen Zielordner oder Unterverzeichnis ab. Falls die Zielstruktur noch nicht existiert, wird sie automatisch angelegt.

Empfohlener Einsatzzweck

Das Tool eignet sich ideal, um Dokumente automatisiert in andere Formate zu überführen, beispielsweise für die Archivierung, Weitergabe oder Bearbeitung in anderen Anwendungen. Besonders nützlich ist es, wenn regelmäßig viele Dateien in ein Standardformat (z. B. PDF) konvertiert werden sollen.

Funktionsbeschreibung

Parameter	Beschreibung
object (Pflicht)	Die ID (Pfad, UUID oder ID) des agorum core Objekts, das konvertiert werden soll.
data.format (Pflicht)	Zielformat, in das konvertiert werden soll. Mögliche Werte: `pdf`, `txt`.
data.target (Optional, Pflicht wenn `subdirectory` nicht absolut ist)	Zielordner als agorum core Objekt (Pfad, UUID oder ID). Wird ignoriert, wenn `subdirectory` absolut ist.
data.subdirectory (Optional)	Unterordner, in dem die konvertierte Datei abgelegt werden soll. Ist der Pfad absolut (beginnt mit `/`), wird `data.target` ignoriert. Ist er relativ, wird er an `data.target` angehängt. Die Ordnerstruktur wird bei Bedarf automatisch erstellt.
data.name (Optional)	Name der konvertierten Datei (inkl. Dateiendung). Wird kein Name angegeben, wird der Quellname mit neuer Endung verwendet.
data.description (Optional)	Beschreibung für die konvertierte Datei. Wird keine Beschreibung angegeben, wird die Beschreibung des Quellobjekts übernommen.
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.

Beispiel-Prompt

Konvertiere das Dokument mit der UUID f2327a60-7142-11f0-a6ad-02420a0a000e nach PDF und lege das Ergebnis im Ordner /Home/roi/MyFiles/Toolstest ab.

Tool: agorum_ai_agents_library_basic_format_convert_object
Parameter:

    object: f2327a60-7142-11f0-a6ad-02420a0a000e
    data:
    format: pdf
    target: /Home/roi/MyFiles/Toolstest

Tipps und Tricks

Tipp: Wenn Sie ein Unterverzeichnis angeben, das noch nicht existiert, wird dieses automatisch angelegt. So können Sie flexibel neue Ablagestrukturen schaffen, ohne diese vorher manuell anlegen zu müssen.

Hinweis: Das Tool unterstützt aktuell die Formate PDF und TXT. Weitere Formate können in zukünftigen Versionen ergänzt werden.