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 に書き戻すことができます。詳細については、エージェント プラットフォームのサンドボックス環境のマネージド エージェント 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
分離されたサンドボックス コンテナ、権限、プリインストールされたパッケージ / ツールについて説明します。