agorum_ai_agents_library_basic_url_download_binary_file

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: Downloads the binary file from a URL

Was macht das Tool?

Dieses Tool lädt eine Datei von einer angegebenen externen URL herunter und speichert sie als Dateiobjekt in agorum core. Nach erfolgreichem Download liefert das Tool die UUID, den Namen und den Objektlink der gespeicherten Datei zurück.

Empfohlener Einsatzzweck

Dieses Tool ist besonders geeignet, wenn Sie automatisiert Dateien aus dem Internet (z. B. Bilder, PDFs oder andere Dokumente) herunterladen und direkt im agorum core ablegen möchten – beispielsweise zur Archivierung, Dokumentation oder Weiterverarbeitung im System.

Funktionsbeschreibung

Parameter	Beschreibung
url (Pflicht)	Die externe URL der Datei, die heruntergeladen werden soll. Beispiel: https://www.example.com/image.png
basename (optional)	Der optionale Basisname der heruntergeladenen Datei (ohne Dateiendung). Standardwert: `downloadedfile`.
targetId (optional)	Die ID (Pfad, UUID oder ID) des agorum core Zielordners, in den die Datei gespeichert werden soll. Falls dies nicht gesetzt ist, wird eine temporäre Datei erstellt.
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

Lade die Datei von https://www.agorum.com/files/downloads/agorum-core-optimal-betreiben.pdf herunter und speichere sie in meinen Ablageordner.
Tool: agorum_ai_agents_library_basic_url_download_binary_file
Parameter:
url: https://www.agorum.com/files/downloads/agorum-core-optimal-betreiben.pdf
targetId: /Home/roi/MyFiles/Toolstest
basename: agorum-core-optimal-betreiben

Tipps und Tricks

Wenn kein basename angegeben wird, wählt das Tool automatisch einen Standardnamen (downloadedfile).
Wird kein targetId gesetzt, erfolgt der Download in ein temporäres Verzeichnis, von wo aus Sie die Datei nachträglich verschieben können.
Vergewissern Sie sich, dass die angegebene URL öffentlich erreichbar und gültig ist. Geschützte, gesperrte oder passwortgeschützte Downloads werden nicht unterstützt.
Unterstützt alle Dateitypen, die agorum core als Dateiobjekt speichern kann.

Tipp: Setzen Sie möglichst einen eindeutigen basename, um die Downloads identifizieren zu können. Prüfen Sie bei Fehlern die Korrektheit der URL und die Schreibrechte im Zielordner.