Cómo ver las relaciones entre agentes

Puedes ver las relaciones entre los agentes en Gemini Enterprise Agent Platform, incluida la comunicación entre agentes y la comunicación 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 entre agentes puede ayudarte a comprender las dependencias y respaldar la administración de agentes.

Puedes ver los datos de los agentes descubiertos y de los que están registrados en el Registro de agentes. Agent Platform de Gemini Enterprise determina las relaciones con datos de seguimiento agregados.

Limitaciones

  • Los resultados de la búsqueda solo incluyen los componentes que cumplen con los siguientes criterios:
    • Los agentes deben tener el tipo funcional establecido en AGENT y deben implementarse con el ADK, Gemini Enterprise o Cloud Run, o bien implementarse con GKE y registrarse en el Registro de agentes.
    • Los servidores de MCP deben tener el tipo funcional establecido en MCP. Se incluyen los servidores MCP propios implementados con OneMCP, GKE o Cloud Run. Otros servidores de MCP deben registrarse en el registro de agentes para poder incluirse.
    • Otros componentes, como herramientas y modelos, o los agentes de Workspace no se incluyen en los resultados.
  • Cuando se registra un servidor MCP en Agent Registry, App Hub lo clasifica como un recurso compartido, por lo 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 rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más 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 proyectos del alcance del seguimiento que pertenecen a 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:

  • Ver gráficos: Visualizador de topología de la app (roles/apptopology.viewer)
  • Visualiza los datos del agente registrado: Visualizador de la API de Agent Registry (agentregistry.viewer)

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 a través de roles personalizados o cualquier otro rol predefinido.

Cómo ver los gráficos de un proyecto

  1. En la consola de Google Cloud , ve a la página Topología.

    Ir a Topología

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

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

  4. En la sección Gráfico, se muestran los resultados de la búsqueda seleccionada.

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

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

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

  6. Para definir mejor 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 Supervisión de aplicaciones.

Cómo ver los gráficos de un agente registrado

  1. En la consola de Google Cloud , 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 Agentes, haz clic en el nombre del agente que deseas ver.

  4. Haz clic en la pestaña Topology.

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

  6. En la sección Gráfico, se muestran los resultados de la búsqueda seleccionada.

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

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

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

  8. Para definir mejor 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 Supervisión de aplicaciones.

¿Qué sigue?