Vertex AI Agent Engine Code Execution

Molte attività degli agent, come i calcoli finanziari e i flussi di lavoro di data science, richiedono che un agente generi ed esegua codice. L'esecuzione di codice di Agent Engine consente all'agente di eseguire codice in un ambiente sandbox sicuro, isolato e gestito.

Le funzionalità di esecuzione del codice includono:

  • Le sandbox possono essere create ed eseguire codice in meno di un secondo.

  • Le sandbox supportano l'input e l'output di file fino a 100 MB per l'intera richiesta o risposta.

  • Le sandbox mantengono il loro stato di esecuzione (memoria) per un massimo di 14 giorni. Questa impostazione durata (TTL) è configurabile.

L'esecuzione del codice fa parte della suite Vertex AI Agent Engine. Tuttavia, non è necessario eseguire il deployment dell'agente in Vertex AI Agent Engine per utilizzare l'esecuzione del codice. L'agente può essere eseguito ovunque, anche localmente.

L'esecuzione del codice funziona con qualsiasi framework di agent e qualsiasi modello generativo.

Di seguito sono riportate le principali operazioni per lavorare con una sandbox di esecuzione del codice:

  • Crea sandbox: crea uno spazio sicuro e isolato per eseguire codice non attendibile o potenzialmente dannoso. Questo isolamento riduce i rischi per la sicurezza impedendo al codice di toccare le risorse, i file o la rete del sistema. Una sandbox è fondamentale quando devi eseguire codice in modo sicuro, ad esempio per gli agent di data science, gli script di orchestrazione o durante i test di sviluppo. La sandbox offre un file system limitato e nessun accesso alla rete.

  • Ottieni sandbox: mostra la configurazione e lo stato di una sandbox di esecuzione del codice specifica. Puoi controllare dettagli come lo stato attuale (ad esempio, in esecuzione o arrestato) e durata (TTL). In questo modo puoi monitorare le sandbox e verificarne lo stato prima o dopo l'esecuzione del codice.

  • Elenca sandbox: elenca tutte le sandbox di esecuzione del codice nel tuo progetto. Puoi filtrare i risultati in base a criteri come lo stato o il tipo di sandbox. In questo modo puoi controllare, monitorare e gestire molte sandbox nel tuo progetto.

  • Esegui codice: invia il codice insieme a tutti i file di input richiesti alla sandbox per l'esecuzione sicura. La risposta include i risultati, come l'output standard (stdout), l'errore standard (stderr) e tutti i file generati dal codice. La sandbox può anche mantenere lo stato, il che consente alle chiamate successive Execute Code di basarsi sulle chiamate precedenti. Questo è fondamentale per le sessioni interattive o le attività complesse che richiedono che l'ambiente mantenga lo stato in più esecuzioni di codice.

Librerie supportate

La sandbox di esecuzione del codice include le seguenti librerie. Non puoi installare le tue librerie.

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

Passaggi successivi