エージェントの関係を表示する

Gemini Enterprise Agent Platform では、エージェント間の通信やエージェントと MCP サーバー間の通信など、エージェント間の関係を表示できます。

提供されたクエリを使用して、クエリ結果をトポロジグラフまたはテーブルとして確認できます。エージェント間の関係に関する情報は、依存関係を把握し、エージェントのガバナンスをサポートするのに役立ちます。

検出されたエージェントと Agent Registry に登録されているエージェントの両方のデータを表示できます。Gemini Enterprise Agent Platform は、集約されたトレースデータを使用して関係を判断します。

制限事項

  • クエリ結果には、次の条件を満たすコンポーネントのみが含まれます。
    • エージェントの機能タイプ が AGENT に設定され、ADK、Gemini Enterprise、または Cloud Run を使用してデプロイされているか、GKE を使用してデプロイされ、Agent Registry に登録されている必要があります。
    • MCP サーバーの 機能タイプ が MCP に設定されている必要があります。OneMCP、GKE、Cloud Run を使用してデプロイされたサードパーティの MCP サーバーが含まれます。その他の MCP サーバーを含めるには、 Agent Registry に登録する必要があります。
    • ツールやモデルなどの他のコンポーネント、Workspace エージェントは結果に含まれません。
  • MCP サーバーが Agent Registry に登録されると、App Hub によって共有リソースとして分類され、トポロジグラフの他のノードへのエッジは表示されません。この制限は、MCP サーバーが共有リソースとして分類されている場合にのみ適用され、Gemini Enterprise データコネクタや Cloud Run でホストされている MCP サーバーなど、アプリケーション専用のリソースには適用されません。

始める前に

  1. App Hub、アプリトポロジ、オブザーバビリティ、Trace API を有効にします。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。

    API を有効にする

    2. トレース スコープに他のプロジェクトを追加した場合は、それらのプロジェクトでも Observability API を有効にすることをおすすめします。トポロジグラフには、選択したプロジェクトと同じ組織内のトレース スコープ プロジェクトのトレースデータのみが表示されます。

  2. OpenTelemetry を使用して AI アプリケーションを 計測します。

必要なロール

トポロジグラフを表示するために必要な権限を取得するには、プロジェクトに関する次の IAM ロールを付与するよう管理者に依頼してください。

  • グラフを表示する: アプリ トポロジ閲覧者 （roles/apptopology.viewer）
  • 登録済みエージェントのデータを表示する: Agent Registry API 閲覧者 (agentregistry.viewer)

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。

プロジェクトのグラフを表示する

  1. コンソールで、[トポロジ] ページに移動します。 Google Cloud

    [トポロジ] に移動

  2. プロジェクト選択ツールで、エージェントを含むプロジェクトを選択します。

  3. [クエリ] セクションで、クエリをクリックします。

  4. [グラフ] セクションに、選択したクエリの結果が表示されます。

    トポロジマップは完全にインタラクティブです。拡大、縮小、ノードのドラッグを行って、関係を可視化できます。グラフ内のノードに関する詳細情報を提供するパネルを開くには、ノードをクリックします。

  5. クエリ結果をテーブルとして表示するには、[テーブル] をクリックします。

    • テーブルに表示する列を選択するには、 [Column display options] をクリックします。
    • 特定のプロパティでテーブルをフィルタするには、[フィルタ] フィールドでプロパティを選択します。
    • 各列を昇順または降順で並べ替えることもできます。

  6. クエリを絞り込むかカスタマイズするには、選択したクエリを編集し、Cloud Hub で結果をトポロジグラフとして表示します。[Cloud Hub で編集] をクリックします。

選択したプロジェクト内のエージェントに関する追加データを表示するには、 アプリケーション モニタリングのダッシュボードを表示します。

登録済みエージェントのグラフを表示する

  1. コンソールで、[Agent Registry] ページに移動します。 Google Cloud

    [Agent Registry] に移動

  2. プロジェクト選択ツールで、エージェントを含むプロジェクトを選択します。

  3. [エージェント] タブで、表示するエージェントの名前をクリックします。

  4. [トポロジ] タブをクリックします。

  5. [クエリ] セクションで、クエリをクリックします。

  6. [グラフ] セクションに、選択したクエリの結果が表示されます。

    トポロジマップは完全にインタラクティブです。拡大、縮小、ノードのドラッグを行って、関係を可視化できます。グラフ内のノードに関する詳細情報を提供するパネルを開くには、ノードをクリックします。

  7. クエリ結果をテーブルとして表示するには、[テーブル] をクリックします。

    • テーブルに表示する列を選択するには、 [Column display options] をクリックします。
    • 特定のプロパティでテーブルをフィルタするには、[フィルタ] フィールドでプロパティを選択します。
    • 各列を昇順または降順で並べ替えることもできます。

  8. クエリを絞り込むかカスタマイズするには、選択したクエリを編集し、Cloud Hub で結果をトポロジグラフとして表示します。[Cloud Hub で編集] をクリックします。

選択したエージェントに関する追加データを表示するには、 アプリケーション モニタリングのダッシュボードを表示します。

次のステップ