Agent Platform の Managed Agents API を使用すると、単一の API 呼び出しでマネージド自律型エージェントを構築できます。Antigravity ハーネスを搭載した各エージェントは、推論、計画、エージェント スキルの使用、コードの実行、ウェブ検索、ファイルの読み取りと書き込みを行うサンドボックス環境で実行されます。
システム アーキテクチャ
Agent Platform の Managed Agents API は、次の 2 つの主要なインターフェースを活用します。
| API | 説明 |
|---|---|
| Agents API | エージェントを管理するためのコントロール プレーン。これを使用して、構成からエージェントを作成し、外部データソースのマウントやネットワーク許可リストの定義など、実行環境を構成します。システムは、これらの構成をエージェントのサンドボックス実行環境に適用します。外部データソースとツールを接続するには認証が必要です。制限事項については、セキュリティとベスト プラクティスをご覧ください。 |
| Interactions API | これは、ランタイムにデプロイされたエージェントと通信してやり取りするための主要なインターフェースとして機能するデータプレーンです。これは、エージェント API を使用して作成されたエージェントに接続します。 |
セキュリティを強化するため、各エージェントは分離されたサンドボックス環境で動作します。Cloud Storage などの外部ソースを使用して環境をカスタマイズすると、システムはこれらのファイルをオンデマンドでコンテナのファイル システムに直接読み込み、エージェントは結果を Cloud Storage に書き戻すことができます。詳細については、エージェント プラットフォームのサンドボックス環境のリファレンスの Managed Agents API をご覧ください。
セキュリティとベスト プラクティス
デフォルトでは、すべてのエージェントは外部システム、ネットワーク、認証情報にアクセスできないサンドボックス環境でアクションを実行します。エージェントは、独自のサンドボックス内のファイル、パッケージ、データのみを操作できます。
つまり、エージェントはネットワーク呼び出しを行ったり、データベースにアクセスしたり、本番環境インフラストラクチャにアクセスしたりすることはできません。
サンドボックス以外の接続は、デベロッパーが明示的に構成する必要があります。詳細については、ネットワーク アクセスを構成するをご覧ください。
ネットワーク アクセス
ユースケースで必要な場合にのみ有効にし、アクセス範囲をできるだけ狭く設定します。
環境のネットワーク アクセスを有効にすると、エージェントは外部 API にアクセスし、パブリック リポジトリのクローンを作成して、パッケージをダウンロードできます。ネットワーク アクセスを有効にする前に、次の点を考慮してください。
- 機密性の高いエンドポイントを公開しないようにします。リスクを確認し、エージェントのアクティビティをモニタリングする準備ができていない限り、エージェントを内部サービス、管理パネル、データベースに向けないでください。
- エージェントの対応を確認します。ネットワーク アクセスが有効になっている場合は、エージェントのインタラクション（特に初期開発中）をモニタリングして、意図したリソースにのみアクセスしていることを確認します。
認証情報のベスト プラクティス
ワークフローで、エージェントが MCP サーバーなどの外部サービスで認証を行う必要がある場合は、これらの認証情報のプロビジョニングとスコープ設定を行う必要があります。リスクを軽減するためのガイドラインは次のとおりです。
- 最小権限の認証情報を使用します。エージェントに必要な権限のみを持つサービス アカウントまたは API キーを作成します。広範なアクセス権または管理者権限を持つ認証情報を渡さないようにします。
- 有効期間の短いトークンを優先します。可能な場合は、有効期間の長い API キーではなく、有効期限が切れる時間制限付きの認証情報またはトークンを使用します。
- エージェントが使用することに抵抗がある認証情報は、決して渡さないでください。エージェントは、割り当てられたタスクを完了するために、アクセス権のある任意の認証情報を使用できます。付与するアクセス権の範囲全体を把握している認証情報のみを指定してください。
- 認証情報を定期的にローテーションする。エージェントと共有する認証情報は、他のプログラマティック認証情報と同様に扱い、定期的にローテーションします。
外部ツールと API の接続
Agents API は、エージェントの機能を拡張するために、外部ツールや API（MCP サーバーなど）の接続をサポートしています。その場合:
- ツールソースを慎重に評価します。信頼できる提供元のツールのみを接続してください。悪意のあるツールや不適切なツールを使用すると、データが漏洩したり、意図しない動作が発生したりする可能性があります。
- ツール権限のスコープを設定します。ユースケースに必要な最小限の権限でツールを構成します。ツールが読み取り専用モードをサポートしている場合は、書き込みアクセスが必要な場合を除き、そのモードを使用します。
- まず単独でテストします。ツールを本番環境のデータソースに接続する前に、サンプルデータまたは合成データに対してテストし、エージェントが想定どおりに使用することを確認します。
人間による監視
エージェントは、高度な自律性で推論、計画、複数ステップのワークフローの実行を行うことができます。これは強力な機能ですが、適切な監督（特にデータを変更するタスクや外部システムとやり取りするタスク）を適用する必要があることも意味します。
生成されたコード、データ変換、構成変更などの重要な出力は、デプロイする前に必ず確認してください。
サポートとフィードバック
Agent Platform の Managed Agents API に関するサポートとフィードバックについては、公開ディスカッション グループ（managed-agents-in-agent-platform@google.com）にメールでお問い合わせください。
次のステップ
Agent Platform サンドボックス環境の Managed Agents API
分離されたサンドボックス コンテナ、権限、プリインストールされたパッケージ/ツールについて学習します。