View agent relationships

You can view agent relationships in Gemini Enterprise Agent Platform, including communication between agents and communication between agents and MCP servers.

Using provided queries, you can explore the query results as a topology graph or as a table. Information about agent relationships can help you to understand dependencies and support agent governance.

You can view data for both discovered agents and agents that are registered with Agent Registry. Gemini Enterprise Agent Platform determines relationships using aggregated trace data.

Limitations

  • Query results only include components that meet the following criteria:
    • Agents must have functional type set to AGENT and be deployed using ADK, Gemini Enterprise, or Cloud Run; or be deployed using GKE and registered with Agent Registry.
    • MCP servers must have functional type set to MCP. First-party MCP servers deployed using OneMCP, GKE, or Cloud Run are included. Other MCP servers must be registered with Agent Registry to be included.
    • Other components, such as tools and models, or Workspace Agents aren't included in results.
  • When an MCP server is registered to Agent Registry, it is classified as a shared resource by App Hub which won't show edges to other nodes in the topology graph. This limitation only applies if the MCP server is classified as a shared resource and doesn't apply to application-exclusive resources, such as Gemini Enterprise data connectors or MCP servers hosted on Cloud Run.

Before you begin

  1. Enable the App Hub, App Topology, Observability, and Trace APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    2. If you've added other projects to your trace scope, then we recommend you also enable the Observability API for those projects. The topology graph only shows trace data from trace scope projects that are in the same organization as the selected project.

  2. Instrument your AI applications with OpenTelemetry.

Required roles

To get the permissions that you need to view topology graphs, ask your administrator to grant you the following IAM roles on the project:

  • View graphs: App Topology Viewer (roles/apptopology.viewer)
  • View registered agent data: Agent Registry API Viewer (agentregistry.viewer)

For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

View graphs for a project

  1. In the Google Cloud console, go to the Topology page.

    Go to Topology

  2. In the project picker, select the project that contains your agents.

  3. In the Queries section, click a query.

  4. The Graph section displays the results for the selected query.

    The topology graph is fully interactive. You can zoom in and out and drag nodes around to help you visualize the relationships. To open a panel that provides additional details about a node in the graph, click the node.

  5. To view the query results as a table, click Table.

    • To select the columns that the table displays, click Column display options
    • To filter the table for specific properties, select the properties in the Filter field.
    • You can also sort each column in ascending or descending order.

  6. To refine or customize your query, you can edit the selected query and view results as a topology graph in Cloud Hub. Click Edit in Cloud Hub.

To view additional data about agents in the selected project, view the dashboards in Application Monitoring.

View graphs for a registered agent

  1. In the Google Cloud console, go to the Agent Registry page.

    Go to Agent Registry

  2. In the project picker, select the project that contains your agents.

  3. On the Agents tab, click the name of the agent that you want to view.

  4. Click the Topology tab.

  5. In the Queries section, click a query.

  6. The Graph section displays the results for the selected query.

    The topology graph is fully interactive. You can zoom in and out and drag nodes around to help you visualize the relationships. To open a panel that provides additional details about a node in the graph, click the node.

  7. To view the query results as a table, click Table.

    • To select the columns that the table displays, click Column display options
    • To filter the table for specific properties, select the properties in the Filter field.
    • You can also sort each column in ascending or descending order.

  8. To refine or customize your query, you can edit the selected query and view results as a topology graph in Cloud Hub. Click Edit in Cloud Hub.

To view additional data about the selected agent, view the dashboards in Application Monitoring.

What's next