エージェントは、金融計算やデータ サイエンス ワークフローなど、多くの場合、コードを生成して実行する必要があります。Agent Engine Code Execution を使用すると、エージェントは隔離された安全なマネージド サンドボックス環境でコードを実行できます。
Code Execution の機能は次のとおりです。
サンドボックスは 1 秒未満で作成してコードを実行できます。
サンドボックスは、リクエストまたはレスポンス全体で最大 100 MB のファイル入出力をサポートしています。
サンドボックスは、実行状態（メモリ）を最大 14 日間維持します。この有効期間（TTL）の設定は構成可能です。
Code Execution は Vertex AI Agent Engine スイートの一部です。 ただし、Code Execution を使用するために、エージェントを Vertex AI Agent Engine にデプロイする必要はありません。エージェントは、ローカルを含む任意の場所で実行できます。
Code Execution は、任意のエージェント フレームワークと任意の生成モデルで動作します。
Code Execution サンドボックスを操作するための主なオペレーションは次のとおりです。
サンドボックスを作成: 信頼できないコードや有害な可能性のあるコードを 実行するための安全な隔離スペースを作成します。この隔離により、コードがシステムのリソース、ファイル、ネットワークにアクセスするのを防ぎ、セキュリティ リスクを軽減できます。サンドボックスは、データ サイエンス エージェント、オーケストレーション スクリプト、開発テストなど、コードを安全に実行する必要がある場合に不可欠です。サンドボックスでは、ファイル システムが制限され、ネットワーク アクセスはできません。
サンドボックスを取得: 特定の Code Execution サンドボックスの構成とステータスを表示します。現在の状態（実行中、停止など）や有効期間（TTL）などの詳細を確認できます。これにより、サンドボックスを追跡し、コードの実行前後にステータスを確認できます。
サンドボックスを一覧表示: プロジェクト内のすべての Code Execution サンドボックスを一覧表示します。サンドボックスのステータスやタイプなどの条件で結果をフィルタできます。 これにより、プロジェクト内の多くのサンドボックスの確認、モニタリング、管理が容易になります。
コードを実行: 必要な入力ファイルとともにコードを サンドボックスに送信して安全に実行します。レスポンスには、標準出力（
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