Agent Platform サンドボックス環境の Managed Agents API

Agent Platform の Managed Agents API は、標準の分離された Linux サンドボックスで動作します。この安全なフルマネージド実行コンテナでは、カスタム エージェントが推論、ワークフローの計画、bash コマンドの実行、ファイルの読み取りと書き込みをすぐに実行できます。

すべてのサンドボックス環境には、次のコアシステムとコントロールが用意されています。

  • 永続的なファイル システム: マルチターンのインタラクションにわたって、ファイル、エージェント ロジック、実行状態を安全に保持します。

  • Bash ターミナル: ターミナル コマンドの実行、カスタム スクリプトの実行、ローカル ファイルの処理を行うための安全な環境を提供します。

  • ネットワーク分離: デフォルトでは無効になっています。ネットワーク allowlist を明示的に宣言して、エージェントが公共のインターネット リソースにアクセスしたり、外部ライブラリをダウンロードしたりできるようにします。

  • 拡張可能な統合: 標準のウェブ API、Model Context Protocol（MCP）サーバー、Skill Registry のスキルなど、カスタム機能を動的にインポートできます。

サンドボックスの権限とセキュリティ

標準のエンタープライズ セキュリティ境界を維持するため、リモート サンドボックスは次の権限モデルで動作します。

実行とライフサイクル管理

次の標準パラメータは、サンドボックスの実行とライフサイクルを管理します。

  • サンドボックス環境: エージェントは、オーケストレーションに Antigravity ハーネスを使用して、フルマネージド サンドボックス環境で実行されます。

  • サンドボックスの有効期間（TTL）: サンドボックス環境の標準の有効期間（TTL）は 7 日です。新しいインタラクションごとにこのタイマーが自動的にリセットされ、アクティブなエージェントが利用可能な状態が維持されます。

  • エージェント構成の永続性: バックエンドはエージェント構成を永続的に保存します。この構成は、Agents API に明示的な DELETE リクエストを送信するまで保持されます。

  • エージェントのコラボレーション: インタラクション中に同じ env_id を指定すると、複数のエージェントが同じ環境を共有します。

プリインストールされているソフトウェア

サンドボックスには、標準の Linux ユーティリティ セットが含まれています。

カテゴリ パッケージ/ツール
UNIX ツール
  • bc
  • curl
  • fd-find
  • gawk
  • gcloud CLI
  • git
  • htop
  • iproute2
  • jq
  • lsof
  • procps
  • ripgrep
  • rsync
  • tree
  • unzip
  • wget
  • which
Python 3.11 パッケージ
  • ast-grep-cli
  • beautifulsoup4
  • google-genai
  • numpy
  • pandas
  • pyyaml
  • requests
Node.js 20 グローバル パッケージ
  • create-next-app
  • create-vite
  • typescript

ネットワーク アクセスが有効になっている場合、エージェントは実行時に pip install または npm install を使用して追加のパッケージをインストールできます。これらのパッケージは環境スナップショットに保持され、同じ env_id を再利用するインタラクションで使用できます。

スキルのマウント アーキテクチャ

エージェントの base_environment.sources 内の Skill Registry などのソースから外部スキルを構成すると、これらのリソースはサンドボックス ファイル システムに直接アタッチされます。システムは、元のスキル パッケージ ディレクトリ構造を維持しながら、指定されたターゲット ディレクトリに各スキルを配置します。この構成により、個々のスキルファイルがエージェントによって検出可能になります。

ソース構成の例

次の例では、Skill Registry から 3 つのスキルをアタッチします。

"sources": [
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/pdf-skill",
    "target": "/.agent/skills/"
  },
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/finance-skill",
    "target": "/.agent/skills/"
  },
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/git-skill",
    "target": "/.agent/other-skills/"
  }
]

マウント後のサンドボックス ファイル システムの構造

サンドボックス環境がプロビジョニングされると、ファイルはコンテナ内に次のようにマウントされ、構造化されます。

/ (root)
└── .agent/
    ├── skills/                    <-- Mount Target for pdf-skill & finance-skill
    │   ├── pdf-skill/             <-- Preserved skill directory
    │   │   ├── SKILL.md
    │   │   └── scripts/
    │   └── finance-skill/         <-- Preserved skill directory
    │       ├── SKILL.md
    │       └── scripts/
    └── other-skills/              <-- Mount Target for git-skill
        └── git-skill/             <-- Preserved skill directory
            ├── SKILL.md
            └── scripts/

サンドボックスの組み込みツール

マネージド環境で実行する場合、エージェントはいくつかのデフォルト ツールにアクセスできます。

ツール名 説明
bash サンドボックス ターミナルでシェル コマンドを実行し、出力を返します。
file_system ファイルのコンテンツの読み取り、書き込み、削除、ディレクトリのコンテンツの一覧表示を行います。 ディレクトリのコンテンツの一覧表示を行います。

次のステップ

概要

自律エージェントを構築するための構成駆動型の REST ファースト環境である Agent Platform の Managed Agents API について説明します。

ガイド

REST API を使用してエージェントを作成、更新、一覧表示、取得、削除する方法について説明します。

ガイド

実行時にエージェントを操作し、セッションの状態を管理し、構成を動的にオーバーライドする方法について説明します。