Agent Platform の Managed Agents API を使用すると、1 回の API 呼び出しで管理された自律型エージェントを構築できます。Antigravity ハーネスを搭載した各エージェントは、推論、計画、エージェント スキルの使用、コードの実行、ウェブの検索、ファイルの読み取りと書き込みを行うサンドボックス環境で実行されます。
システム アーキテクチャ
Agent Platform の Managed Agents API は、次の 2 つの主要なインターフェースを活用します。
| API | 説明 |
|---|---|
| Agents API | エージェントを管理するためのコントロール プレーン 。これを使用して、構成からエージェントを作成し、外部データソースのマウントやネットワーク許可リストの定義など、実行環境を構成します。システムは、これらの構成をエージェントの サンドボックス実行環境に適用します。外部データソースとツールを接続するには認証が必要です。制限については、セキュリティとベスト プラクティスをご覧ください。 |
| Interactions API | これはデータ プレーンであり、実行時にデプロイされたエージェントと通信して操作するための主要な インターフェースとして機能します。Agents API を使用して作成されたエージェントに接続します。 |
セキュリティを強化するため、各エージェントは独立したサンドボックス環境で動作します。 Cloud Storage などの外部ソースを使用して環境をカスタマイズすると、これらのファイルがコンテナのファイル システムに直接ロードされ、エージェントは結果を Cloud Storage に書き戻すことができます。詳細については、 Agent Platform サンドボックス環境のリファレンスにある 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
独立したサンドボックス コンテナ、権限、プリインストールされたパッケージ/ツールについて説明します。