금융 계산 및 데이터 과학 워크플로와 같은 많은 에이전트 작업에서는 에이전트가 코드를 생성하고 실행해야 합니다. Agent Engine Code Execution을 사용하면 에이전트가 안전하고 격리된 관리형 샌드박스 환경에서 코드를 실행할 수 있습니다.
코드 실행의 기능은 다음과 같습니다.
샌드박스는 1초 이내에 코드를 생성하고 실행할 수 있습니다.
샌드박스는 전체 요청 또는 응답에 대해 최대 100MB의 파일 입력 및 출력을 지원합니다.
샌드박스는 최대 14일 동안 실행 상태(메모리)를 유지합니다. 이 TTL(수명) 설정은 구성할 수 있습니다.
코드 실행은 Vertex AI Agent Engine 제품군의 일부입니다. 하지만 코드 실행을 사용하기 위해 에이전트를 Vertex AI Agent Engine에 배포할 필요는 없습니다. 에이전트는 로컬을 비롯한 모든 위치에서 실행될 수 있습니다.
코드 실행은 모든 에이전트 프레임워크 및 모든 생성 모델과 호환됩니다.
다음은 코드 실행 샌드박스로 작업할 때의 주요 작업입니다.
샌드박스 만들기: 신뢰할 수 없거나 잠재적으로 유해한 코드를 실행할 수 있는 안전한 격리 공간을 만듭니다. 이 격리는 코드가 시스템의 리소스, 파일 또는 네트워크에 영향을 미치지 못하도록 방지하여 보안 위험을 줄입니다. 샌드박스는 데이터 과학 에이전트, 조정 스크립트 또는 개발 테스트와 같이 코드를 안전하게 실행해야 할 때 중요합니다. 샌드박스는 제한된 파일 시스템을 제공하며 네트워크 액세스가 없습니다.
샌드박스 가져오기: 특정 코드 실행 샌드박스의 구성과 상태를 표시합니다. 현재 상태 (예: 실행 중 또는 중지됨) 및 TTL (수명)과 같은 세부정보를 확인할 수 있습니다. 이렇게 하면 코드를 실행하기 전이나 후에 샌드박스를 추적하고 상태를 확인할 수 있습니다.
샌드박스 나열: 프로젝트의 모든 코드 실행 샌드박스를 나열합니다. 샌드박스 상태 또는 유형과 같은 기준으로 결과를 필터링할 수 있습니다. 이를 통해 프로젝트에서 여러 샌드박스를 확인, 모니터링, 관리할 수 있습니다.
코드 실행: 안전한 실행을 위해 필요한 입력 파일과 함께 코드를 샌드박스로 전송합니다. 대답에는 표준 출력(
stdout), 표준 오류(stderr), 코드가 생성하는 파일 등 결과가 포함됩니다. 샌드박스는 상태를 유지할 수도 있으므로 후속Execute Code호출이 이전 호출을 기반으로 할 수 있습니다. 이는 여러 코드 실행에서 환경이 상태를 유지해야 하는 대화형 세션이나 복잡한 작업에 중요합니다.
지원되는 라이브러리
코드 실행 샌드박스에는 다음 라이브러리가 포함됩니다. 사용자의 고유 라이브러리는 설치할 수 없습니다.
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