sandbox_download

Anzeigename: Downloads a file from an ALBERT | AI Sandbox Server
Technischer Name: agorum_ai_agents_library_basic_sandbox_download

Was macht das Tool?

Dieses Tool ermöglicht das Herunterladen von Dateien aus einer ALBERT | AI Sandbox Serverumgebung und speichert diese als temporäre Dateien in agorum core. Das Tool greift auf Dateien zu, die in einer Sandbox-Umgebung liegen, und überträgt sie sicher in das agorum core System. Dabei wird die heruntergeladene Datei als temporäres Objekt mit einer neuen UUID gespeichert und kann dann weiterverarbeitet werden.

Hinweis: Beim Erstellen der temporären Datei setzt das Tool automatisch die Metadaten agorum_ai_created_by_ai (Boolean) und agorum_ai_chat_id (String) auf dem neu erstellten Objekt. Damit ist nachvollziehbar, dass das Objekt durch einen KI-Agenten erzeugt wurde und in welchem Chat-Kontext dies passiert ist.

Empfohlener Einsatzzweck

Das Tool ist ideal geeignet für:

Die Übertragung von generierten Dateien aus einer Sandbox-Umgebung in agorum core
Das Sichern von Arbeitsergebnissen aus temporären Sandbox-Umgebungen
Die Integration von Dateien, die in isolierten Umgebungen erstellt oder bearbeitet wurden
Den Transfer von Dokumenten, Bildern oder anderen Dateitypen aus der Sandbox zur weiteren Verarbeitung in agorum core

Funktionsbeschreibung

Parameter	Beschreibung
baseUrl (Pflicht)	Die Basis-URL zum Sandbox-Server, über den auf die Sandbox-Umgebung zugegriffen wird. Beispiel: https://sandbox.example.com Die URL sollte ohne abschließenden Schrägstrich angegeben werden.
sandboxName (Pflicht)	Der eindeutige Name der Sandbox-Umgebung, aus der die Datei heruntergeladen werden soll. Dies ist typischerweise ein von der Sandbox generierter Identifier. Beispiel: sandbox-cIHBcgfwmTHJMioWrcGqFLYF
file (Pflicht)	Der absolute Pfad zur Datei innerhalb der Sandbox-Umgebung, die heruntergeladen werden soll. Es muss der vollständige Pfad inklusive Dateiname und Dateiendung angegeben werden. Beispiele: /tmp/dokument.pdf /home/user/bild.png /var/data/report.xlsx Wichtig: Der Pfad muss absolut sein (beginnt mit /).

Tipps und Tricks

Tipps:

Stellen Sie sicher, dass der angegebene Dateipfad korrekt ist und die Datei tatsächlich in der Sandbox existiert.
Das Tool erstellt automatisch eine temporäre Datei mit einer neuen UUID in agorum core, wobei die ursprüngliche Dateiendung beibehalten wird.
Die heruntergeladene Datei kann anschließend über die zurückgegebene UUID oder den objectLink weiterverarbeitet werden.