Afficher les relations entre les agents

Vous pouvez afficher les relations entre les agents dans Gemini Enterprise Agent Platform, y compris les communications entre les agents et les communications entre les agents et les serveurs MCP.

À l'aide des requêtes fournies, vous pouvez explorer les résultats des requêtes sous forme de graphique de topologie ou de tableau. Les informations sur les relations entre les agents peuvent vous aider à comprendre les dépendances et à gérer les agents.

Vous pouvez afficher les données des agents découverts et de ceux enregistrés dans Agent Registry. Gemini Enterprise Agent Platform détermine les relations à l'aide de données de trace agrégées.

Limites

  • Les résultats de la requête n'incluent que les composants qui répondent aux critères suivants :
    • Les agents doivent avoir le type fonctionnel défini sur AGENT et être déployés à l'aide de l'ADK, de Gemini Enterprise ou de Cloud Run. Ils peuvent également être déployés à l'aide de GKE et enregistrés auprès du registre d'agents.
    • Les serveurs MCP doivent avoir le type fonctionnel défini sur MCP. Les serveurs MCP first party déployés à l'aide de OneMCP, GKE ou Cloud Run sont inclus. Les autres serveurs MCP doivent être enregistrés auprès d'Agent Registry pour être inclus.
    • Les autres composants, tels que les outils et les modèles, ou les agents Workspace, ne sont pas inclus dans les résultats.
  • Lorsqu'un serveur MCP est enregistré dans Agent Registry, il est classé comme ressource partagée par App Hub, qui n'affiche pas d'arêtes vers d'autres nœuds dans le graphique de topologie. Cette limite ne s'applique que si le serveur MCP est classé comme ressource partagée. Elle ne s'applique pas aux ressources exclusives aux applications, telles que les connecteurs de données Gemini Enterprise ou les serveurs MCP hébergés sur Cloud Run.

Avant de commencer

  1. Activez les API App Hub, App Topology, Observability et Trace.

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

    Activer les API

    2. Si vous avez ajouté d'autres projets à votre champ d'application des traces, nous vous recommandons d'activer également l'API Observability pour ces projets. Le graphique de topologie n'affiche que les données de trace des projets du champ d'application de trace qui appartiennent à la même organisation que le projet sélectionné.

  2. Instrumentez vos applications d'IA avec OpenTelemetry.

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les graphiques de topologie, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

  • Afficher les graphiques : Lecteur de topologie d'application (roles/apptopology.viewer)
  • Afficher les données des agents enregistrés : Lecteur de l'API Agent Registry (agentregistry.viewer)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher les graphiques d'un projet

  1. Dans la console Google Cloud , accédez à la page "Topologie".

    Accéder à la topologie

  2. Dans le sélecteur de projet, sélectionnez le projet contenant vos agents.

  3. Dans la section Requêtes, cliquez sur une requête.

  4. La section Graphique affiche les résultats de la requête sélectionnée.

    Le graphique de topologie est entièrement interactif. Vous pouvez faire un zoom avant ou arrière, et faire glisser les nœuds pour visualiser les relations. Pour ouvrir un panneau contenant des informations supplémentaires sur un nœud du graphique, cliquez dessus.

  5. Pour afficher les résultats de la requête sous forme de tableau, cliquez sur Table.

    • Pour sélectionner les colonnes à afficher dans le tableau, cliquez sur Options d'affichage des colonnes .
    • Pour filtrer le tableau en fonction de propriétés spécifiques, sélectionnez-les dans le champ Filtre.
    • Vous pouvez également trier chaque colonne par ordre croissant ou décroissant.

  6. Pour affiner ou personnaliser votre requête, vous pouvez la modifier et afficher les résultats sous forme de graphique de topologie dans Cloud Hub. Cliquez sur Modifier dans Cloud Hub.

Pour afficher des données supplémentaires sur les agents du projet sélectionné, consultez les tableaux de bord dans Surveillance des applications.

Afficher les graphiques d'un agent enregistré

  1. Dans la console Google Cloud , accédez à la page "Registre d'agents".

    Accéder au registre d'agents

  2. Dans le sélecteur de projet, sélectionnez le projet contenant vos agents.

  3. Dans l'onglet Agents, cliquez sur le nom de l'agent que vous souhaitez afficher.

  4. Cliquez sur l'onglet Topology (Topologie).

  5. Dans la section Requêtes, cliquez sur une requête.

  6. La section Graphique affiche les résultats de la requête sélectionnée.

    Le graphique de topologie est entièrement interactif. Vous pouvez faire un zoom avant ou arrière, et faire glisser les nœuds pour visualiser les relations. Pour ouvrir un panneau contenant des informations supplémentaires sur un nœud du graphique, cliquez dessus.

  7. Pour afficher les résultats de la requête sous forme de tableau, cliquez sur Table.

    • Pour sélectionner les colonnes à afficher dans le tableau, cliquez sur Options d'affichage des colonnes .
    • Pour filtrer le tableau en fonction de propriétés spécifiques, sélectionnez-les dans le champ Filtre.
    • Vous pouvez également trier chaque colonne par ordre croissant ou décroissant.

  8. Pour affiner ou personnaliser votre requête, vous pouvez la modifier et afficher les résultats sous forme de graphique de topologie dans Cloud Hub. Cliquez sur Modifier dans Cloud Hub.

Pour afficher des données supplémentaires sur l'agent sélectionné, consultez les tableaux de bord dans Surveillance des applications.

Étapes suivantes