Execução de código do Vertex AI Agent Engine

Muitas tarefas do agente, como cálculos financeiros e fluxos de trabalho de ciência de dados, exigem que um agente gere e execute código. Com a execução de código do Agent Engine, seu agente pode executar código em um ambiente de sandbox seguro, isolado e gerenciado.

Os recursos de execução de código incluem:

  • Os sandboxes podem ser criados e executar código em menos de um segundo.

  • Os ambientes de simulação aceitam entrada e saída de arquivos de até 100 MB para toda a solicitação ou resposta.

  • Os sandbox mantêm o estado de execução (memória) por até 14 dias. Essa configuração de time to live (TTL) é configurável.

A execução de código faz parte do pacote do Vertex AI Agent Engine. No entanto, não é necessário implantar o agente no Vertex AI Agent Engine para usar a execução de código. Seu agente pode ser executado em qualquer lugar, até mesmo localmente.

A execução de código funciona com qualquer framework de agente e modelo generativo.

Estas são as principais operações para trabalhar com uma sandbox de execução de código:

  • Criar sandbox: cria um espaço seguro e isolado para executar códigos não confiáveis ou potencialmente prejudiciais. Esse isolamento reduz os riscos de segurança, impedindo que o código toque nos recursos, arquivos ou rede do sistema. Um sandbox é essencial quando você precisa executar código com segurança, como para agentes de ciência de dados, scripts de orquestração ou durante testes de desenvolvimento. A sandbox oferece um sistema de arquivos limitado e não tem acesso à rede.

  • Receber sandbox: mostra a configuração e o status de um sandbox de execução de código específico. É possível verificar detalhes como o estado atual (por exemplo, em execução ou parado) e time to live (TTL). Assim, é possível rastrear seus sandboxes e verificar o status deles antes ou depois de executar o código.

  • Listar sandboxes: lista todas as sandboxes de execução de código no seu projeto. Você pode filtrar os resultados por critérios como status ou tipo de sandbox. Isso ajuda a verificar, monitorar e gerenciar muitas caixas de simulação no seu projeto.

  • Executar código: envia seu código e os arquivos de entrada necessários para o sandbox para execução segura. A resposta inclui os resultados, como saída padrão (stdout), erro padrão (stderr) e todos os arquivos gerados pelo código. A sandbox também pode manter o estado, o que permite que as chamadas Execute Code subsequentes sejam criadas com base em chamadas anteriores. Isso é crucial para sessões interativas ou tarefas complexas que precisam que o ambiente mantenha o estado em várias execuções de código.

Bibliotecas permitidas

O sandbox de execução de código inclui as seguintes bibliotecas. Não é possível instalar suas próprias bibliotecas.

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

A seguir