zip_objects – Dateien und Ordner als ZIP-Datei packen (ALBERT | AI Tool)

Anzeigename: Packs agorum core files and folders into a ZIP file

Technischer Name: agorum_ai_agents_library_basic_zip_objects

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
Das Tool steht einzeln und in der Toolgruppe zip_tools_group zur Verfügung.

Was macht das Tool?

Das Tool zip_objects packt Dateien und Ordner aus agorum core zu einer ZIP-Datei:

Eine Datei liegt in der ZIP-Datei auf oberster Ebene.
Ein Ordner wird zu einem Verzeichnis gleichen Namens, darunter liegt sein gesamter Inhalt mit Unterordnern. Leere Ordner bleiben erhalten.
Objekte ohne Inhalt, etwa Notizen oder Adressen, werden übersprungen und in der Rückgabe gemeldet.

Die ZIP-Datei wird im angegebenen Zielordner angelegt oder – ohne Zielordner – als temporäre Datei. Der Name ist frei wählbar; ohne Angabe wird eine UUID als Name verwendet.

Empfohlener Einsatzzweck

Verwenden Sie zip_objects, um:

mehrere Dokumente oder einen ganzen Ordner für den Versand oder die Weitergabe zusammenzufassen
Ergebnisse einer KI-Verarbeitung gebündelt als eine Datei bereitzustellen
eine Ordnerstruktur mit ihrem Inhalt als Archiv zu sichern

Funktionsbeschreibung

Die folgende Tabelle beschreibt die Parameter des Tools. Parameter, die mit (nur Konfiguration) gekennzeichnet sind, werden in der Tool-Konfiguration durch den Administrator festgelegt und sind für die KI nicht sichtbar.

Parameter	Beschreibung
ids (Pflicht)	Liste der Dateien und Ordner, die gepackt werden sollen. Angabe jeweils als ID, UUID oder Pfad. Mindestens ein Eintrag. Wird eines der Objekte nicht gefunden, meldet das Tool die fehlenden Angaben und legt nichts an.
name (Optional)	Name der ZIP-Datei. Fehlt die Endung `.zip`, wird sie ergänzt. Standard: eine UUID, z. B. `<uuid>.zip`
targetId (Optional)	Ordner, in dem die ZIP-Datei angelegt wird. Angabe als ID, UUID oder Pfad. Gibt es im Zielordner bereits eine Datei mit diesem Namen, meldet das Tool einen Fehler; die vorhandene Datei wird nicht überschrieben. Standard: – (die ZIP-Datei wird temporär angelegt)
allowedBasePathIds (Optional, nur Konfiguration)	Liste von Basispfaden (ID, UUID oder Pfad). Der Zielordner `targetId` muss unterhalb eines dieser Pfade liegen, sonst meldet das Tool einen Fehler und legt nichts an. Standard: – (keine Einschränkung)
maxEntries (Optional, nur Konfiguration)	Höchstzahl der Objekte (Dateien, Ordner und übersprungene Objekte), die gepackt oder geprüft werden. Standard: `5000`
maxTotalSize (Optional, nur Konfiguration)	Höchstsumme des gepackten Inhalts in Bytes, gezählt anhand der tatsächlich gelesenen Daten. Standard: `1073741824` (1 GB)

Rückgabe

Das Tool gibt ein JSON-Objekt mit folgenden Angaben zurück:

Feld	Beschreibung
uuid, name, objectLink	UUID, Name und Objektlink der ZIP-Datei
temporary	`true`, wenn die ZIP-Datei temporär angelegt wurde
entryCount	Anzahl der Einträge in der ZIP-Datei
contentSize	Summe des gepackten Inhalts in Bytes, vor der Kompression
skipped	Liste der übersprungenen Objekte mit UUID, Name und Grund. Die Liste enthält höchstens 100 Objekte.
skippedTruncated	`true`, wenn mehr als 100 Objekte übersprungen wurden und `skipped` deshalb nur die ersten 100 aufführt

Verhalten im Detail

Umlaute in Dateinamen: Die Namen in der ZIP-Datei werden als UTF-8 geschrieben und als solche gekennzeichnet.
Gleiche Namen: Liegen auf derselben Ebene zwei Einträge mit demselben Namen, erhält der zweite einen Zähler, z. B. bericht (1).pdf. Groß- und Kleinschreibung wird dabei nicht unterschieden, weil die ZIP-Datei meist auf einem Dateisystem entpackt wird, das sie ebenfalls nicht unterscheidet.
Nichts zu packen: Hat keines der Objekte Inhalt, meldet das Tool einen Fehler und legt keine ZIP-Datei an.
Dateinamen: Zeichen, die unter Windows in Dateinamen nicht erlaubt sind, werden durch _ ersetzt.
Schutzgrenzen: Überschreitet der Inhalt maxEntries oder maxTotalSize, bricht das Tool ab und entfernt die bereits angelegte ZIP-Datei wieder. Eine unvollständige ZIP-Datei bleibt nicht zurück.
Die ZIP-Datei wird als von der KI erstellt gekennzeichnet.

Beispiel

Beispiel-Prompts:

Packe alle Dokumente aus dem Ordner Projekt Alpha in eine ZIP-Datei mit dem Namen projekt-alpha.

Erstelle aus den drei angehängten Dateien eine ZIP-Datei.

Tipps und Tricks

Tipp: Soll die KI ZIP-Dateien nur in bestimmten Bereichen ablegen dürfen, schränken Sie die möglichen Zielordner über den Parameter allowedBasePathIds ein.

Zum Entpacken von ZIP-Dateien siehe unzip_object – ZIP-Dateien entpacken (ALBERT | AI Tool).