agorum_ai_agents_library_basic_merge_pdf

Anzeigename: Merge PDF

Was macht das Tool?

Dieses Tool führt mehrere PDF-Dokumente zu neuen kombinierten PDF-Dateien zusammen. Jedes innere Array im documents-Parameter repräsentiert PDFs, die zu einem einzigen Dokument zusammengeführt werden sollen. Die ursprünglichen Dokumente können optional in den Papierkorb verschoben werden.

Empfohlener Einsatzzweck

Das Tool ist ideal für folgende Anwendungsfälle:

Zusammenführung mehrerer PDF-Dateien zu einem oder mehreren kombinierten Dokumenten
Batch-Verarbeitung: Mehrere PDF-Zusammenführungen in einem Durchgang
Aufräumen nach der Zusammenführung durch automatisches Löschen der Originaldateien
Strukturierte Ablage zusammengeführter PDFs mit automatischer oder individueller Benennung

Funktionsbeschreibung

Parameter	Beschreibung
documents (Pflicht)	Ein Array von Arrays mit agorum core PDF-Objekten. Jedes innere Array repräsentiert ein Ziel-PDF-Dokument, das aus der Zusammenführung seiner PDFs erstellt wird. Jedes innere Array muss mindestens ein PDF-Dokument enthalten. Format: ID (path) von agorum core PDF-Objekten als Pfad, UUID oder ID.
targetFolderId (Pflicht)	Die ID (Pfad) des Zielordners, in dem die zusammengeführten PDF-Dokumente gespeichert werden sollen. Format: ID (path) eines agorum core Ordner-Objekts als Pfad, UUID oder ID.
baseName (Optional)	Basisname für die zusammengeführten PDF-Dokumente. Der Name wird um einen 5-stelligen Zähler erweitert (z. B. baseName_00001.pdf, baseName_00002.pdf). Wird nur verwendet, wenn `documentNames` nicht angegeben ist. Länge: 1-200 Zeichen
documentNames (Optional)	Ein Array mit Namen für die zusammengeführten PDF-Dokumente (ohne .pdf-Erweiterung). Wenn angegeben, wird `baseName` ignoriert. Die Länge muss mit der Länge des `documents`-Arrays übereinstimmen. Jeder Name: 1-200 Zeichen
deleteOriginals (Optional)	Boolean-Wert, der bestimmt, ob die Original-PDF-Dokumente nach der Zusammenführung gelöscht werden sollen. true: Die Original-Dokumente werden in den Papierkorb verschoben false: Die Originale bleiben unverändert Standard: `false`
maxMergesPerTransaction (Optional)	Maximale Anzahl von Zusammenführungsoperationen pro Transaktion. Nach dieser Anzahl wird die aktuelle Transaktion committed und eine neue gestartet. Bereich: 1-20 Standard: `5`

Beispiel-Prompt

Führe folgende PDF-Dokumente zusammen:
- Erstelle eine PDF aus den Dateien im Ordner /agorum/roi/Files/Rechnungen/2024/Q1
- Speichere das Ergebnis im Ordner /agorum/roi/Files/Zusammenfassungen
- Nenne das zusammengeführte Dokument "Rechnungen_Q1_2024"
- Lösche die Originaldateien nach der Zusammenführung

Tipps und Tricks

Tipps:

Bei sehr vielen Zusammenführungen empfiehlt es sich, den Parameter maxMergesPerTransaction anzupassen, um die Transaktionsgröße zu optimieren.
Wenn Sie individuelle Namen für jedes zusammengeführte Dokument benötigen, verwenden Sie documentNames statt baseName.
Die Reihenfolge der PDFs im inneren Array bestimmt die Reihenfolge im zusammengeführten Dokument.
Stellen Sie sicher, dass alle angegebenen Dokumente tatsächlich PDF-Dateien sind – andere Dateitypen führen zu einem Fehler.
Das Tool gibt ein Array mit UUIDs der neu erstellten, zusammengeführten Dokumente zurück.