Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI Agents > ALBERT| AI KI-Tools-Dokumentationen


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:

Funktionsbeschreibung

Parameter Beschreibung
documents
(Optional)
Array von agorum core PDF-Objekten (als ID, UUID oder Pfad), 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
(Optional)
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

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

Tipps:

  • Entweder documents oder query muss angegeben werden.
  • Der Parameter splitEach ist besonders nützlich, wenn Sie etwa doppelseitig gescannte Dokumente in Doppelseiten-PDFs aufteilen möchten (Wert: 2).
  • Testen Sie die Aufteilung zunächst mit deleteOriginal: false, bevor Sie die Originaldokumente automatisch löschen lassen.
  • Die generierten Dateinamen sind automatisch nummeriert und führende Nullen sorgen für eine korrekte alphabetische Sortierung auch bei großen Dokumentmengen.
  • Das Tool gibt ein Array mit den UUIDs aller erstellten Teildokumente zurück, was eine Weiterverarbeitung ermöglicht.