Codeausführung

Viele Agentenaufgaben, wie Finanzberechnungen und Data-Science-Workflows, erfordern, dass ein Agent Code generiert und ausführt. Mit der Codeausführung kann Ihr Agent Code in einer sicheren, isolierten und verwalteten Sandbox-Umgebung ausführen.

Zu den Funktionen der Codeausführung gehören:

  • Sandboxes können in weniger als einer Sekunde erstellt und Code ausgeführt werden.

  • Sandboxes unterstützen die Datei-Ein- und -Ausgabe von bis zu 100 MB für die gesamte Anfrage oder Antwort.

  • Sandboxes behalten ihren Ausführungsstatus (Speicher) bis zu 14 Tage lang bei. Diese Gültigkeitsdauer (Time-to-Live, TTL) kann konfiguriert werden.

Sie müssen Ihren Agenten nicht in der Agent Platform bereitstellen, um die Codeausführung zu verwenden. Ihr Agent kann überall ausgeführt werden, auch lokal.

Die Codeausführung funktioniert mit jedem Agenten-Framework und jedem generativen Modell.

Hier sind die wichtigsten Vorgänge für die Arbeit mit einer Sandbox für die Codeausführung:

  • Sandbox erstellen: Erstellt einen sicheren, isolierten Bereich, in dem nicht vertrauenswürdiger oder potenziell schädlicher Code ausgeführt werden kann. Durch diese Isolation werden Sicherheitsrisiken verringert, da der Code nicht auf die Ressourcen, Dateien oder das Netzwerk Ihres Systems zugreifen kann. Eine Sandbox ist unerlässlich, wenn Sie Code sicher ausführen müssen, z. B. für Data-Science-Agenten, Orchestrierungsskripts oder während Entwicklungstests. Die Sandbox bietet ein eingeschränktes Dateisystem und keinen Netzwerkzugriff.

  • Sandbox abrufen: Zeigt die Konfiguration und den Status einer bestimmten Sandbox für die Codeausführung an. Sie können Details wie den aktuellen Status (z. B. „Wird ausgeführt“ oder „Angehalten“) und die Gültigkeitsdauer (TTL) prüfen. So können Sie Ihre Sandboxes verfolgen und ihren Status vor oder nach der Ausführung von Code prüfen.

  • Sandboxes auflisten: Listet alle Sandboxes für die Codeausführung in Ihrem Projekt auf. Sie können die Ergebnisse nach Kriterien wie Sandbox-Status oder -Typ filtern. So können Sie viele Sandboxes in Ihrem Projekt prüfen, überwachen und verwalten.

  • Code ausführen: Sendet Ihren Code zusammen mit allen erforderlichen Eingabedateien zur sicheren Ausführung an die Sandbox. Die Antwort enthält die Ergebnisse, z. B. die Standardausgabe (stdout), die Standardfehlerausgabe (stderr) und alle vom Code generierten Dateien. Die Sandbox kann auch einen Status beibehalten, sodass nachfolgende Execute Code Aufrufe auf vorherigen Aufrufen aufbauen können. Dies ist für interaktive Sitzungen oder komplexe Aufgaben unerlässlich, bei denen der Status der Umgebung über mehrere Codeausführungen hinweg beibehalten werden muss.

Unterstützte Bibliotheken

Die Sandbox für die Codeausführung enthält die folgenden Bibliotheken. Sie können keine eigenen Bibliotheken installieren.

attrs==25.3.0
chess==1.11.2
contourpy==1.3.1
fpdf==1.7.2
geopandas==1.0.1
imageio==2.37.0
jinja2==3.1.6
joblib==1.4.2
jsonschema==4.23.0
jsonschema-specifications==2024.10.1
lxml==5.3.1
matplotlib==3.10.1
mpmath==1.3.0
numpy==2.1.3
opencv-python==4.11.0.86
openpyxl==3.1.5
ortools==9.14.6206
packaging==24.0
pandas==2.2.3
pillow==11.1.0
plotly==6.1.2
protobuf==6.31.1
PyPDF2==3.0.1
pylatex==1.4.2
pyparsing==3.2.1
python-dateutil==2.9.0.post0
python-docx==1.1.2
python-pptx==1.0.2
reportlab==4.3.1
scikit-learn==1.6.1
scipy==1.15.2
seaborn==0.13.2
six==1.17.0
striprtf==0.0.28
sympy==1.13.3
tabulate==0.9.0
tensorflow==2.20.0
toolz==1.0.0
xlrd==2.0.1
XlsxWriter==3.2.0

Nächste Schritte