Agent Platform の Managed Agents API は、標準の分離された Linux サンドボックスで動作します。この安全なフルマネージド実行コンテナでは、カスタム エージェントはすぐに推論、ワークフローの計画、bash コマンドの実行、ファイルの読み取りや書き込みを行うことができます。
すべてのサンドボックス環境には、次のコアシステムと制御が用意されています。
永続ファイル システム: マルチターンのインタラクション全体で、ファイル、エージェント ロジック、実行状態を安全に保持します。
Bash ターミナル: ターミナル コマンドの実行、カスタム スクリプトの実行、ローカル ファイルの処理のための安全な環境を提供します。
ネットワーク分離: デフォルトで無効になっています。ネットワーク
allowlistを明示的に宣言して、エージェントが公共のインターネット リソースにアクセスしたり、外部ライブラリをダウンロードしたりできるようにすることができます。拡張可能な統合: 標準のウェブ API、Model Context Protocol（MCP）サーバー、スキルレジストリのスキルなど、カスタム機能を動的にインポートできます。
サンドボックスの権限とセキュリティ
標準のエンタープライズ セキュリティ境界を維持するため、リモート サンドボックスは次の権限モデルで動作します。
ネットワーク分離: デフォルトでは、サンドボックスは外部ネットワーク アクセスなしで動作します。環境構成でドメイン許可リストを設定して、接続を明示的に有効にします。許可リストの例については、ネットワーク アクセスを構成するをご覧ください。
最小権限の実行: ネットワーク アクセスが有効になると、コンテナには特権管理者の認証情報または権限がなくなります。デフォルトでは、一般公開されているインターネット ロケーションのみをクエリできます。
Cloud Storage と Skill Registry マウントのデータ スコーピング: Google Cloud Storage または Skill Registry から外部データソースを接続すると、エージェント構成で指定された特定のディレクトリまたはスキルにのみアクセスするように設計されたダウン スコープの認証トークンが環境に提供されます。サンドボックスにはアンビエント認証情報が含まれておらず、プロジェクト内の他のリポジトリやファイルにアクセスできません。
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 について学習します。