Codeausführung in Vertex AI Agent Engine

Viele Agentenaufgaben wie Finanzberechnungen und Data-Science-Workflows erfordern, dass ein Agent Code generiert und ausführt. Mit der Codeausführung der Agent Engine 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 (Arbeitsspeicher) bis zu 14 Tage lang bei. Diese Einstellung für die Gültigkeitsdauer (Time-to-Live, TTL) ist konfigurierbar.

Die Codeausführung ist Teil der Vertex AI Agent Engine-Suite. Sie müssen Ihren Agenten jedoch nicht in der Vertex AI Agent Engine 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 Codeausführungs-Sandbox:

  • 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 Codeausführungs-Sandbox 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 Codeausführungs-Sandboxes 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 Dateien, die vom Code generiert werden. Die Sandbox kann auch einen Status beibehalten, sodass nachfolgende Execute Code Aufrufe auf vorherigen Aufrufen aufbauen können. Dies ist entscheidend für interaktive Sitzungen oder komplexe Aufgaben, bei denen der Status der Umgebung über mehrere Codeausführungen hinweg beibehalten werden muss.

Unterstützte Bibliotheken

Die Codeausführungs-Sandbox 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