Cómo ver las relaciones entre agentes

Puedes ver las relaciones de los agentes en Gemini Enterprise Agent Platform, incluida la comunicación entre agentes y entre agentes y servidores de MCP.

Con las consultas proporcionadas, puedes explorar los resultados de la consulta como un gráfico de topología o como una tabla. La información sobre las relaciones de los agentes puede ayudarte a comprender las dependencias y respaldar la administración de los agentes.

Puedes ver los datos de los agentes descubiertos y de los agentes registrados en Agent Registry. Gemini Enterprise Agent Platform determina las relaciones con datos de seguimiento agregados.

Limitaciones

  • Los resultados de la consulta solo incluyen componentes que cumplen con los siguientes criterios:
    • Los agentes deben tener el tipo funcional establecido en AGENT y deben implementarse con ADK, Gemini Enterprise o Cloud Run, o bien implementarse con GKE y registrarse en Agent Registry.
    • Los servidores de MCP deben tener el tipo funcional establecido en MCP. Se incluyen los servidores de MCP de origen implementados con OneMCP, GKE o Cloud Run. Los otros servidores de MCP deben registrarse en Agent Registry para que se incluyan.
    • Otros componentes, como herramientas y modelos, o los agentes de Workspace no se incluyen en los resultados.
  • Cuando un servidor de MCP se registra en Agent Registry, App Hub lo clasifica como un recurso compartido, que no mostrará bordes a otros nodos en el gráfico de topología. Esta limitación solo se aplica si el servidor de MCP se clasifica como un recurso compartido y no se aplica a los recursos exclusivos de la aplicación, como los conectores de datos de Gemini Enterprise o los servidores de MCP alojados en Cloud Run.

Antes de comenzar

  1. Habilita las APIs de App Hub, App Topology, Observability y Trace.

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

    Habilitar las API

    2. Si agregaste otros proyectos a tu alcance de seguimiento, te recomendamos que también habilites la API de Observability para esos proyectos. El gráfico de topología solo muestra datos de seguimiento de los proyectos de alcance de seguimiento que están en la misma organización que el proyecto seleccionado.

  2. Instrumenta tus aplicaciones de IA con OpenTelemetry.

Roles obligatorios

Para obtener los permisos que necesitas para ver los gráficos de topología, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Cómo ver gráficos de un proyecto

  1. En la Google Cloud consola, ve a la página Topology.

    Ir a Topology

  2. En el selector de proyectos, selecciona el proyecto que contiene tus agentes.

  3. En la sección Queries, haz clic en una consulta.

  4. En la sección Graph , se muestran los resultados de la consulta seleccionada.

    El gráfico de topología es completamente interactivo. Puedes acercar y alejar la imagen, y arrastrar los nodos para ayudarte a visualizar las relaciones. Para abrir un panel que proporcione detalles adicionales sobre un nodo en el gráfico, haz clic en el nodo.

  5. Para ver los resultados de la consulta como una tabla, haz clic en Table.

    • Para seleccionar las columnas que muestra la tabla, haz clic en Opciones de visualización de columnas
    • Para filtrar la tabla por propiedades específicas, selecciona las propiedades en el campo Filter.
    • También puedes ordenar cada columna de forma ascendente o descendente.

  6. Para refinar o personalizar tu consulta, puedes editar la consulta seleccionada y ver los resultados como un gráfico de topología en Cloud Hub. Haz clic en Editar en Cloud Hub.

Para ver datos adicionales sobre los agentes en el proyecto seleccionado, consulta los paneles en Application Monitoring.

Cómo ver gráficos de un agente registrado

  1. En la Google Cloud consola, ve a la página Agent Registry.

    Ir a Agent Registry

  2. En el selector de proyectos, selecciona el proyecto que contiene tus agentes.

  3. En la pestaña Agents, haz clic en el nombre del agente que deseas ver.

  4. Haz clic en la pestaña Topology.

  5. En la sección Queries, haz clic en una consulta.

  6. En la sección Graph , se muestran los resultados de la consulta seleccionada.

    El gráfico de topología es completamente interactivo. Puedes acercar y alejar la imagen, y arrastrar los nodos para ayudarte a visualizar las relaciones. Para abrir un panel que proporcione detalles adicionales sobre un nodo en el gráfico, haz clic en el nodo.

  7. Para ver los resultados de la consulta como una tabla, haz clic en Table.

    • Para seleccionar las columnas que muestra la tabla, haz clic en Opciones de visualización de columnas
    • Para filtrar la tabla por propiedades específicas, selecciona las propiedades en el campo Filter.
    • También puedes ordenar cada columna de forma ascendente o descendente.

  8. Para refinar o personalizar tu consulta, puedes editar la consulta seleccionada y ver los resultados como un gráfico de topología en Cloud Hub. Haz clic en Editar en Cloud Hub.

Para ver datos adicionales sobre el agente seleccionado, consulta los paneles en Application Monitoring.

¿Qué sigue?