Code Sandbox

Die Code Sandbox ermöglicht die sichere Ausführung von Python- und JavaScript-Code in einer isolierten Umgebung. Der Assistent kann hochgeladene Dateien verarbeiten, Skripte ausführen und Ergebnisse als Dateien zurückgeben.

Zweck

Die Sandbox bietet eine sichere Laufzeitumgebung für Code-Ausführung ohne Zugriff auf Produktionssysteme. Sie eignet sich für:

• Verarbeitung und Analyse von Office-Dateien (Excel, Word, PowerPoint, PDF)
• Ausführung von Datenanalyse-Skripten mit Python (pandas, numpy, matplotlib)
• Transformation und Konvertierung von Dateiformaten
• Berechnungen und statistische Auswertungen
• Erstellung von Visualisierungen und Diagrammen

Wann nutzen

Geeignet für:

• Analyse von CSV-, Excel- oder JSON-Daten
• Datenbereinigung und -transformation
• Statistische Berechnungen
• Generierung von Berichten als Office-Dokumente
• Batch-Verarbeitung mehrerer Dateien

Nicht geeignet für:

• Dauerhafte Datenspeicherung (Dateien werden nach Session-Ende gelöscht)
• Zugriff auf externe APIs oder Webservices
• Datenbankverbindungen
• Lang laufende Prozesse

Voraussetzungen

1. Das Sandbox-Tool muss im Assistenten aktiviert sein
2. Hochgeladene Dateien stehen über die Dokumentenliste zur Verfügung
3. Python oder JavaScript als Laufzeitumgebung wird automatisch gewählt

Einrichtung

1. Navigiere zu Assistenten in der Seitenleiste
2. Wähle einen bestehenden Assistenten oder erstelle einen neuen
3. Öffne den Tab Tools
4. Aktiviere Code Sandbox in der Tool-Liste
5. Speichere die Änderungen
6. Lade Dateien im Chat hoch, um sie zu verarbeiten

Verfügbare Funktionen

Session-Verwaltung

• sandbox-create-session: Erstellt eine neue Session (JavaScript oder Python)

Dateioperationen

• sandbox-write-file: Schreibt Dateien in den Workspace
• sandbox-upload-file: Lädt Dateien aus dem Chat in die Sandbox
• sandbox-download-file: Exportiert Dateien aus der Sandbox
• sandbox-list-files: Zeigt alle Dateien im Workspace

Code-Ausführung

• sandbox-execute-command: Führt Shell-Befehle aus

Python-Pakete

Die Python-Umgebung enthält vorinstallierte Pakete:

• Datenanalyse: pandas, numpy, scipy
• Visualisierung: matplotlib, seaborn, plotly, altair
• Office-Dateien: openpyxl, python-docx, python-pptx, PyPDF2
• Web/HTTP: requests, httpx, beautifulsoup4
• Utilities: pillow, lxml, PyYAML

Häufige Fehler

Dateipfade

Alle Dateien müssen im /workspace-Verzeichnis liegen. Zugriff auf andere Verzeichnisse ist nicht möglich.

Timeout

Befehle haben ein Zeitlimit von 30 Sekunden. Aufwendige Berechnungen sollten in kleinere Schritte aufgeteilt werden.

Netzwerkzugriff

Die Sandbox hat keinen Zugriff auf externe Netzwerke. HTTP-Anfragen an externe Server schlagen fehl.

Berechtigungen und Einschränkungen

Praxisbeispiel

Prompt:

Analysiere die hochgeladene CSV-Datei "verkaufsdaten.csv" und erstelle eine
Zusammenfassung mit: Gesamtumsatz, Top-3-Produkte nach Verkaufszahl, und
monatliche Umsatzentwicklung als Excel-Datei.

Erwartetes Ergebnis: Der Assistent:

1. Lädt die CSV-Datei in die Sandbox
2. Analysiert die Daten mit pandas
3. Berechnet die angeforderten Statistiken
4. Erstellt eine Excel-Datei mit Zusammenfassung und Diagrammen
5. Stellt die Excel-Datei zum Download bereit