Agent-Beziehungen ansehen

Sie können Agentenbeziehungen in der Gemini Enterprise Agent Platform ansehen, einschließlich der Kommunikation zwischen Agenten und der Kommunikation zwischen Agenten und MCP-Servern.

Mithilfe der bereitgestellten Abfragen können Sie die Abfrageergebnisse als Topologiediagramm oder als Tabelle ansehen. Informationen zu Agent-Beziehungen können Ihnen helfen, Abhängigkeiten zu verstehen und die Agent-Verwaltung zu unterstützen.

Sie können Daten sowohl für erkannte als auch für in der Agent Registry registrierte Agenten aufrufen. Die Gemini Enterprise Agent Platform ermittelt Beziehungen anhand aggregierter Tracedaten.

Beschränkungen

  • Die Abfrageergebnisse enthalten nur Komponenten, die die folgenden Kriterien erfüllen:
    • Für Agenten muss der Funktionstyp auf AGENT festgelegt sein. Sie müssen mit dem ADK, Gemini Enterprise oder Cloud Run bereitgestellt werden oder mit GKE bereitgestellt und bei der Agent Registry registriert sein.
    • Für MCP-Server muss der Funktionstyp auf MCP festgelegt sein. Eigene MCP-Server, die mit OneMCP, GKE oder Cloud Run bereitgestellt werden, sind enthalten. Andere MCP-Server müssen bei der Agent Registry registriert sein, damit sie berücksichtigt werden.
    • Andere Komponenten wie Tools und Modelle oder Workspace-Agents sind nicht in den Ergebnissen enthalten.
  • Wenn ein MCP-Server in der Agenten-Registry registriert ist, wird er von App Hub als freigegebene Ressource klassifiziert. Im Topologiegraphen werden keine Verbindungen zu anderen Knoten angezeigt. Diese Einschränkung gilt nur, wenn der MCP-Server als freigegebene Ressource klassifiziert wird. Sie gilt nicht für anwendungsexklusive Ressourcen wie Gemini Enterprise-Datenconnectors oder auf Cloud Run gehostete MCP-Server.

Hinweis

  1. Aktivieren Sie die App Hub API, die Anwendungstopologie API, die Observability API und die Trace API.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen

    APIs aktivieren

    2. Wenn Sie Ihrem Trace-Umfang andere Projekte hinzugefügt haben, empfehlen wir, die Observability API auch für diese Projekte zu aktivieren. Im Topologie-Diagramm werden nur Tracedaten aus Projekten im Tracebereich angezeigt, die sich in derselben Organisation wie das ausgewählte Projekt befinden.

  2. KI-Anwendungen mit OpenTelemetry instrumentieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Aufrufen von Topologiediagrammen haben:

  • Diagramme ansehen: App Topology Viewer (roles/apptopology.viewer)
  • Registrierte Agent-Daten ansehen: Agent Registry API Viewer (agentregistry.viewer)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Grafiken für ein Projekt ansehen

  1. Rufen Sie in der Google Cloud Console die Seite „Topologie“ auf.

    Zur Topologie

  2. Wählen Sie in der Projektauswahl das Projekt aus, das Ihre Agents enthält.

  3. Klicken Sie im Bereich Abfragen auf eine Abfrage.

  4. Im Abschnitt Diagramm werden die Ergebnisse für die ausgewählte Abfrage angezeigt.

    Das Topologiediagramm ist vollständig interaktiv. Sie können heran- und herauszoomen und Knoten verschieben, um die Beziehungen besser zu visualisieren. Wenn Sie ein Feld öffnen möchten, in dem zusätzliche Details zu einem Knoten im Diagramm angezeigt werden, klicken Sie auf den Knoten.

  5. Wenn Sie die Abfrageergebnisse als Tabelle ansehen möchten, klicken Sie auf Tabelle.

    • Klicken Sie auf Spaltenanzeigeoptionen , um die in der Tabelle angezeigten Spalten auszuwählen.
    • Wenn Sie die Tabelle nach bestimmten Attributen filtern möchten, wählen Sie die Attribute im Feld Filter aus.
    • Sie können jede Spalte auch in auf- oder absteigender Reihenfolge sortieren.

  6. Wenn Sie die Abfrage verfeinern oder anpassen möchten, können Sie die ausgewählte Abfrage bearbeiten und die Ergebnisse als Topologiegrafik in Cloud Hub ansehen. Klicken Sie dazu auf In Cloud Hub bearbeiten.

Wenn Sie zusätzliche Daten zu Agents im ausgewählten Projekt aufrufen möchten, sehen Sie sich die Dashboards unter Application Monitoring an.

Diagramme für einen registrierten Agent ansehen

  1. Rufen Sie in der Google Cloud Console die Seite „Agent Registry“ auf.

    Zur Agent Registry

  2. Wählen Sie in der Projektauswahl das Projekt aus, das Ihre Agents enthält.

  3. Klicken Sie auf dem Tab Agents auf den Namen des Agents, den Sie aufrufen möchten.

  4. Klicken Sie auf den Tab Topologie.

  5. Klicken Sie im Bereich Abfragen auf eine Abfrage.

  6. Im Abschnitt Diagramm werden die Ergebnisse für die ausgewählte Abfrage angezeigt.

    Das Topologiediagramm ist vollständig interaktiv. Sie können heran- und herauszoomen und Knoten verschieben, um die Beziehungen besser zu visualisieren. Wenn Sie ein Feld öffnen möchten, in dem zusätzliche Details zu einem Knoten im Diagramm angezeigt werden, klicken Sie auf den Knoten.

  7. Wenn Sie die Abfrageergebnisse als Tabelle ansehen möchten, klicken Sie auf Tabelle.

    • Klicken Sie auf Spaltenanzeigeoptionen , um die in der Tabelle angezeigten Spalten auszuwählen.
    • Wenn Sie die Tabelle nach bestimmten Attributen filtern möchten, wählen Sie die Attribute im Feld Filter aus.
    • Sie können jede Spalte auch in auf- oder absteigender Reihenfolge sortieren.

  8. Wenn Sie die Abfrage verfeinern oder anpassen möchten, können Sie die ausgewählte Abfrage bearbeiten und die Ergebnisse als Topologiegrafik in Cloud Hub ansehen. Klicken Sie dazu auf In Cloud Hub bearbeiten.

Wenn Sie zusätzliche Daten zum ausgewählten Agent aufrufen möchten, sehen Sie sich die Dashboards in Application Monitoring an.

Nächste Schritte