Agent-Beziehungen ansehen

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

Mit den 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-Governance zu unterstützen.

Sie können Daten für erkannte Agenten und für Agenten ansehen, die in der Agent Registry registriert sind. Die Gemini Enterprise Agent Platform ermittelt Beziehungen anhand aggregierter Trace-Daten.

Beschränkungen

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

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 Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen.

    APIs aktivieren

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

  2. Instrumentieren Sie Ihre KI-Anwendungen mit OpenTelemetry.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Topologiediagrammen benötigen:

  • Diagramme ansehen: Anwendungstopologie-Viewer (roles/apptopology.viewer)
  • Daten registrierter Agenten 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.

Diagramme für ein Projekt ansehen

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

    Zur Seite „Topologie“

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

  3. Klicken Sie im Bereich Abfragen auf eine Abfrage.

  4. Im Bereich 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 ziehen, um die Beziehungen zu visualisieren. Wenn Sie ein Feld mit weiteren Details zu einem Knoten im Diagramm öffnen möchten, klicken Sie auf den Knoten.

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

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

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

Weitere Daten zu Agenten im ausgewählten Projekt finden Sie in den Dashboards in Application Monitoring.

Diagramme für einen registrierten Agenten ansehen

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

    Zur Seite „Agent Registry“

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

  3. Klicken Sie auf dem Tab Agenten auf den Namen des Agenten, den Sie ansehen möchten.

  4. Klicken Sie auf den Tab Topologie.

  5. Klicken Sie im Bereich Abfragen auf eine Abfrage.

  6. Im Bereich 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 ziehen, um die Beziehungen zu visualisieren. Wenn Sie ein Feld mit weiteren Details zu einem Knoten im Diagramm öffnen möchten, klicken Sie auf den Knoten.

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

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

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

Weitere Daten zum ausgewählten Agenten finden Sie in den Dashboards in Application Monitoring.

Nächste Schritte

  • Erkannte Agenten in der Agent Registry registrieren.
  • Benutzerdefinierte Abfragen für agentische Daten und andere Ressourcen in Cloud Hub erstellen