agorum_ai_agents_library_basic_split_pdf

Anzeigename: Split PDF

Was macht das Tool?

Das Tool teilt PDF-Dokumente in separate Dateien auf, basierend auf einer festgelegten Anzahl von Seiten pro Teildokument. Die zu teilenden PDF-Dokumente können entweder direkt als Array übergeben oder über eine Suchabfrage gefunden werden. Die aufgeteilten Dokumente werden in einem Zielordner gespeichert und mit einem konfigurierbaren Namenspräfix versehen. Optional können die Originaldokumente nach der Aufteilung in den Papierkorb verschoben werden.

Empfohlener Einsatzzweck

Das Tool eignet sich besonders für folgende Szenarien:

• Aufteilung von mehrseitigen gescannten Dokumenten in einzelne Seiten
• Zerlegung großer PDF-Dokumente in handhabbare Einzeldokumente
• Automatisierte Dokumentenverarbeitung, bei der jede Seite separat bearbeitet werden muss
• Batch-Verarbeitung von PDF-Dokumenten mit einheitlicher Seitenanzahl pro Ausgabedatei
• Vorbereitung von Dokumenten für nachfolgende Workflows oder Verteilungsprozesse

Funktionsbeschreibung

Parameter	Beschreibung
documents (Pflicht, wenn query nicht angegeben ist)	Array von agorum core PDF-Objekt-IDs, die aufgeteilt werden sollen. Es muss entweder dieser Parameter oder der Parameter query angegeben werden. Beispiele für gültige Werte: UUID: "416fb740-f0fc-11ef-bcc0-02420a0a0009" ID: "12345" Pfad: "/agorum/dokumente/rechnung.pdf"
query (Pflicht, wenn documents nicht angegeben ist)	Suchabfrage zum Auffinden von PDF-Dokumenten. Es muss entweder dieser Parameter oder der Parameter documents angegeben werden. Beispiele: "nameextension:pdf inpath:${ID:/agorum/dokumente}" "${PATH} inpath:9999 classname:fileobject nameextension:pdf"
sort (optional)	Array von Sortierkriterien für die Suchergebnisse bei Verwendung des query-Parameters. Beispiele: ["name asc"] - Sortierung nach Name aufsteigend ["lastmodifydate desc"] - Sortierung nach letztem Änderungsdatum absteigend ["createdate asc", "name asc"] - Mehrere Sortierkriterien Standard: ["lastmodifydate desc"]
targetFolder (Pflicht)	Der Zielordner, in dem die aufgeteilten Dokumente gespeichert werden. Kann als ID, UUID oder Pfad angegeben werden. Beispiele: UUID: "416fb740-f0fc-11ef-bcc0-02420a0a0009" ID: "9999" Pfad: "/agorum/dokumente/aufgeteilt"
documentNamePrefix (Pflicht)	Präfix für die Namen der generierten Dokumente. Die finalen Dokumentnamen werden nach folgendem Schema gebildet: präfix_00001.pdf, präfix_00002.pdf usw. Das Präfix muss zwischen 1 und 200 Zeichen lang sein. Beispiele: "Rechnung" → Rechnung_00001.pdf, Rechnung_00002.pdf usw. "Scan_2025" → Scan_2025_00001.pdf, Scan_2025_00002.pdf usw.
splitEach (optional)	Anzahl der Seiten pro aufgeteiltem Dokument. Bestimmt, wie viele Seiten des Original-PDFs in jedes neue Teildokument aufgenommen werden. Der Wert muss zwischen 1 und 10.000 liegen. Beispiele: 1 - Jede Seite wird ein separates Dokument 2 - Jeweils 2 Seiten werden zu einem Dokument zusammengefasst 5 - Jeweils 5 Seiten werden zu einem Dokument zusammengefasst Standard: 1 (jede Seite wird ein eigenes Dokument)
deleteOriginal (optional)	Bestimmt, ob die Originaldokumente nach der Aufteilung in den Papierkorb verschoben werden sollen. true: Die Originaldokumente werden nach erfolgreicher Aufteilung in den Papierkorb verschoben. false: Die Originaldokumente bleiben erhalten Standard: false
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

Teile bitte alle PDF-Dokumente im Ordner /agorum/dokumente/eingang auf. 
Jede Seite soll ein eigenes Dokument werden. 
Speichere die aufgeteilten Dokumente im Ordner /agorum/dokumente/aufgeteilt 
und verwende als Namenspräfix "Split_2025". 
Die Originaldokumente sollen gelöscht werden.
  

Tipps und Tricks