Code Interpreter (Python)

Mit dem Code Interpreter führt Ihr KI-Agent Python-Code in einer sicheren Sandbox aus. Damit geht er weit über reine Textantworten hinaus: Er rechnet zuverlässig, analysiert Daten, erstellt Diagramme und liefert fertige Dateien wie PowerPoint-Präsentationen, Excel-Tabellen oder PDFs. Auch hochgeladene Dateien kann er direkt bearbeiten und umwandeln.

Die Faustregel ist einfach: Soll Ihr Agent mit Dateien oder Daten arbeiten, aktivieren Sie den Code Interpreter. Ob er dafür rechnet, ein Diagramm zeichnet oder ein Word-, Excel-, PowerPoint- oder PDF-Dokument baut, entscheidet das Modell anhand Ihrer Aufgabe selbst.

Was der Code Interpreter kann

• Berechnungen und Datenanalyse: Statistiken, Aggregationen und Auswertungen werden per Code berechnet statt vom Sprachmodell geschätzt. Das macht Ergebnisse nachvollziehbar und präzise.
• Diagramme erstellen: Aus Rohdaten entstehen Balken-, Linien- oder Tortendiagramme, zum Beispiel für Management-Reports.
• Dateien erstellen: Der Agent generiert PowerPoint- (PPTX), Excel- (XLSX) und PDF-Dateien direkt im Chat.
• Hochgeladene Dateien bearbeiten: CSV-Dateien bereinigen, Tabellen umformatieren, Inhalte in andere Formate umwandeln.

Der Code läuft in einer isolierten Sandbox ohne Zugriff auf Ihre Systeme. Erzeugte Dateien stellt der Agent im Chat als Download bereit. In der Werkzeugliste heißt das Werkzeug Code Interpreter (Slug code-interpreter-split). Ältere Agenten können noch eine der früheren Einzelvarianten tragen, Code Interpreter (nur Analyse) (Slug code-interpreter) oder Code Interpreter (nur Dokumente) (Slug code-interpreter-specialists). Sie laufen weiter, lassen sich aber nicht mehr neu auswählen; wählen Sie stattdessen den Code Interpreter, die alte Variante wird dabei automatisch abgewählt.

Code Interpreter aktivieren (Schritt für Schritt)

1. Öffnen Sie Agenten und klicken Sie beim gewünschten Agenten auf Bearbeiten.
2. Wechseln Sie zum Tab Tools und klicken Sie auf Werkzeug hinzufügen.
3. Suchen Sie im Modal Werkzeuge auswählen über das Feld Werkzeuge durchsuchen... nach Code Interpreter und aktivieren Sie das Werkzeug.
4. Klicken Sie auf Auswahl übernehmen und anschließend auf Speichern.

Eine Übersicht aller Werkzeuge finden Sie in der Funktionsmatrix.

Wichtige Einschränkung: nur OpenAI-Modelle

Der Code Interpreter funktioniert ausschließlich mit OpenAI- bzw. Azure-OpenAI-Modellen. Ist am Agenten ein Claude- oder Qwen-Modell eingestellt, wird das Werkzeug zur Laufzeit automatisch aus der Anfrage entfernt und steht im Chat nicht zur Verfügung. Im Werkzeug-Dialog des Agenten-Builders und im Chat-Werkzeugauswahl-Dialog erkennen Sie das an der Kennzeichnung Azure OpenAI (Tooltip: "Nur verfügbar mit Azure OpenAI Modellen"). Wurde das Werkzeug bereits ausgewählt und das Modell des Agenten anschließend auf Claude oder Qwen umgestellt, bleibt die Auswahl erhalten — Sie erhalten stattdessen einen Warnhinweis auf der Werkzeug-Karte, bis Sie entweder wieder ein OpenAI-Modell wählen oder das Werkzeug entfernen.

Möchten Sie den Code Interpreter nutzen, wählen Sie im Tab Allgemein unter LLM Modell ein OpenAI-Modell. Hinweise zur Modellwahl gibt der Artikel Agenten konfigurieren.

Beispiel-Prompts

Zusammenspiel mit dem Datei-Upload

Damit Nutzer:innen dem Agenten Dateien zur Verarbeitung geben können, aktivieren Sie im Tab Dateien die Option Datei-Upload erlauben. Der Code Interpreter kann die hochgeladenen Dateien dann analysieren, bearbeiten und in neue Formate überführen. Welche Formate und Größen möglich sind, beschreibt der Artikel Datei-Upload & Formate.

Tipp: Beschreiben Sie das gewünschte Ergebnis so konkret wie möglich: Dateiformat, Struktur (z.B. Anzahl der Folien oder Spalten) und Inhalt. Je präziser die Vorgabe, desto seltener müssen Sie nachbessern.