Gemini Enterprise Agent Platform で、エージェント間の通信やエージェントと MCP サーバー間の通信など、エージェント間の関係を表示できます。
提供されたクエリを使用して、クエリ結果をトポロジグラフまたはテーブルとして確認できます。エージェントの関係に関する情報は、依存関係を理解し、エージェント ガバナンスをサポートするのに役立ちます。
検出されたエージェントと Agent Registry に登録されているエージェントの両方のデータを表示できます。Gemini Enterprise Agent Platform は、集約されたトレースデータを使用して関係を特定します。
制限事項
- クエリ結果には、次の条件を満たすコンポーネントのみが含まれます。
- エージェントの機能タイプは
AGENTに設定し、ADK、Gemini Enterprise、Cloud Run を使用してデプロイするか、GKE を使用してデプロイし、エージェント レジストリに登録する必要があります。 - MCP サーバーの機能タイプは
MCPに設定されている必要があります。OneMCP、GKE、Cloud Run を使用してデプロイされたファーストパーティ MCP サーバーが含まれます。他の MCP サーバーを含めるには、Agent Registry に登録する必要があります。 - ツールやモデルなどの他のコンポーネントや Workspace エージェントは、結果に含まれません。
- エージェントの機能タイプは
- MCP サーバーが Agent Registry に登録されると、App Hub によって共有リソースとして分類され、トポロジ グラフに他のノードへのエッジが表示されなくなります。この制限は、MCP サーバーが共有リソースとして分類されている場合にのみ適用されます。Gemini Enterprise データコネクタや Cloud Run でホストされている MCP サーバーなどのアプリケーション専用リソースには適用されません。
始める前に
App Hub、アプリトポロジ、オブザーバビリティ、Trace の各 API を有効にします。
API を有効にするために必要なロール
API を有効にするには、
serviceusage.services.enable権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法をご覧ください。- OpenTelemetry を使用して AI アプリケーションを計測します。
トレース スコープに他のプロジェクトを追加した場合は、それらのプロジェクトでも Observability API を有効にすることをおすすめします。トポロジグラフには、選択したプロジェクトと同じ組織内のトレース スコープ プロジェクトのトレースデータのみが表示されます。
必要なロール
トポロジグラフを表示するために必要な権限を取得するには、プロジェクトに関する次の IAM ロールを付与するよう管理者に依頼してください。
-
グラフを表示する: アプリ トポロジ閲覧者 （
roles/apptopology.viewer） -
登録済みエージェントのデータを表示する: Agent Registry API 閲覧者（
agentregistry.viewer）
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
プロジェクトのグラフを表示する
Google Cloud コンソールで、[トポロジ] ページに移動します。
プロジェクト選択ツールで、エージェントを含むプロジェクトを選択します。
[クエリ] セクションで、クエリをクリックします。
[グラフ] セクションに、選択したクエリの結果が表示されます。
トポロジグラフは完全にインタラクティブです。ノードをズームイン、ズームアウト、ドラッグして、関係を可視化できます。グラフ内のノードに関する詳細情報を提供するパネルを開くには、ノードをクリックします。
クエリ結果をテーブルとして表示するには、[テーブル] をクリックします。
- テーブルに表示する列を選択するには、[列表示オプション] をクリックします。
- 特定のプロパティでテーブルをフィルタするには、[フィルタ] フィールドでプロパティを選択します。
- 各列を昇順または降順で並べ替えることもできます。
クエリを絞り込むかカスタマイズするには、選択したクエリを編集し、Cloud Hub で結果をトポロジグラフとして表示します。[Cloud Hub で編集] をクリックします。
選択したプロジェクトのエージェントに関する追加のデータを表示するには、アプリケーション モニタリングのダッシュボードを表示します。
登録済みエージェントのグラフを表示する
Google Cloud コンソールで、[エージェント レジストリ] ページに移動します。
プロジェクト選択ツールで、エージェントを含むプロジェクトを選択します。
[エージェント] タブで、表示するエージェントの名前をクリックします。
[トポロジ] タブをクリックします。
[クエリ] セクションで、クエリをクリックします。
[グラフ] セクションに、選択したクエリの結果が表示されます。
トポロジグラフは完全にインタラクティブです。ノードをズームイン、ズームアウト、ドラッグして、関係を可視化できます。グラフ内のノードに関する詳細情報を提供するパネルを開くには、ノードをクリックします。
クエリ結果をテーブルとして表示するには、[テーブル] をクリックします。
- テーブルに表示する列を選択するには、[列表示オプション] をクリックします。
- 特定のプロパティでテーブルをフィルタするには、[フィルタ] フィールドでプロパティを選択します。
- 各列を昇順または降順で並べ替えることもできます。
クエリを絞り込むかカスタマイズするには、選択したクエリを編集し、Cloud Hub で結果をトポロジグラフとして表示します。[Cloud Hub で編集] をクリックします。
選択したエージェントに関する追加データを表示するには、アプリケーション モニタリングでダッシュボードを表示します。
次のステップ
- Agent Registry で検出されたエージェントを登録します。
- Cloud Hub で、エージェント データやその他のリソースのカスタムクエリを作成します。