Agent Platform の Managed Agents API は、標準の分離された Linux サンドボックスで動作します。この安全なフルマネージド実行コンテナでは、カスタム エージェントは推論、ワークフローの計画、bash コマンドの実行、ファイルの読み取りや書き込みをすぐに実行できます。
すべてのサンドボックス環境には、次のコアシステムとコントロールが用意されています。
永続ファイル システム: マルチターンのインタラクション全体で、ファイル、エージェント ロジック、実行状態を安全に永続化します。
Bash ターミナル: ターミナル コマンドの実行、カスタム スクリプトの実行、ローカル ファイルの処理を行うための安全な環境を提供します。
ネットワーク分離: デフォルトでは無効になっています。ネットワーク
allowlistを明示的に宣言して、エージェントが公共のインターネット リソースにアクセスしたり、外部ライブラリをダウンロードしたりできるようにします。拡張可能な統合: 標準のウェブ API、Model Context Protocol（MCP）サーバー、Skill Registry のスキルなど、カスタム機能を動的にインポートできます。
サンドボックスの権限とセキュリティ
標準的なエンタープライズ セキュリティ境界を維持するため、リモート サンドボックスは次の権限モデルで動作します。
ネットワーク分離: デフォルトでは、サンドボックスは外部ネットワーク アクセスなしで動作します。環境構成でドメイン許可リストを設定して、接続を明示的に有効にします。許可リストの例については、ネットワーク アクセスを構成するをご覧ください。
最小権限の実行: ネットワーク アクセスが有効になると、コンテナには特権管理者の認証情報や権限がなくなります。デフォルトでは、一般公開されているインターネット ロケーションのみをクエリできます。
Cloud Storage とスキルレジストリのマウントのデータ スコープ設定: Cloud Storage またはスキルレジストリから外部データソースをアタッチすると、エージェント構成で指定された特定のディレクトリまたはスキルにのみアクセスするように設計された、ダウンスコープされた認証トークンが環境に提供されます。サンドボックスにはアンビエント認証情報が含まれておらず、プロジェクト内の他のリポジトリやファイルにアクセスできません。
MCP 認証情報のスコープ設定: バックエンド認証トークンを含む Model Context Protocol（MCP）サーバーのヘッダー構成は、構成で定義された特定の MCP エンドポイントにアクセスする場合にのみ送信されます。
実行とライフサイクル管理
これらの標準パラメータは、サンドボックスの実行とライフサイクルを制御します。
サンドボックス環境: エージェントは、オーケストレーションに Antigravity ハーネスを使用して、フルマネージド サンドボックス環境で実行されます。
サンドボックスの有効期間（TTL）: サンドボックス環境の標準の有効期間（TTL）は 7 日間です。新しいやり取りが発生するたびに、このタイマーが自動的にリセットされ、アクティブなエージェントが引き続き対応できるようになります。
エージェント構成の永続性: バックエンドはエージェント構成を永続的に保存します。構成は、Agents API に明示的な
DELETEリクエストを送信するまで保持されます。エージェントのコラボレーション: インタラクション中に同じ
env_idを指定すると、複数のエージェントが同じ環境を共有します。
プリインストールされているソフトウェア
サンドボックスには、標準の Linux ユーティリティ セットが含まれています。
| カテゴリ | パッケージ / ツール |
|---|---|
| UNIX ツール |
|
| Python 3.11 パッケージ |
|
| Node.js 20 グローバル パッケージ |
|
ネットワーク アクセスが有効になっている場合、エージェントは pip install または npm install を使用して、ランタイムに追加のパッケージをインストールできます。これらのパッケージは環境スナップショットに保持され、同じ env_id を再利用するインタラクションで使用できます。
スキル マウント アーキテクチャ
エージェントの base_environment.sources 内のスキルレジストリなどのソースから外部スキルを構成すると、これらのリソースはサンドボックス ファイル システムに直接アタッチされます。システムは、元のスキルパッケージのディレクトリ構造を維持しながら、指定されたターゲット ディレクトリ内に各スキルを配置します。この構成により、個々のスキルファイルがエージェントによって検出可能になります。
ソース構成の例
次の例では、スキルレジストリから 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 |
ファイルの内容の読み取り、書き込み、削除、ディレクトリの内容の一覧表示を行います。 |
次のステップ
Agent Platform の Managed Agents API の概要
自律エージェントを構築するための構成駆動型の REST ファースト環境である、Agent Platform の Managed Agents API について説明します。