Afficher les relations entre les agents

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

À l'aide des requêtes fournies, vous pouvez explorer les résultats de la requête 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 des agents 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 :
    • Le type fonctionnel des agents doit être défini sur AGENT. Ils doivent être déployés à l'aide de l'ADK, de Gemini Enterprise ou de Cloud Run, ou à l'aide de GKE et enregistrés dans Agent Registry.
    • Le type fonctionnel des serveurs MCP doit être défini sur MCP. Les serveurs MCP propriétaires déployés à l'aide de OneMCP, GKE ou Cloud Run sont inclus. Les autres serveurs MCP doivent être enregistrés dans 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 les 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 et ne s'applique pas aux ressources exclusives à l'application, 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 de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

    Activer les API

    2. Si vous avez ajouté d'autres projets à votre champ d'application de trace, 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 se trouvent dans 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 via des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher les graphiques d'un projet

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

    Accéder à la page "Topology" (Topologie)

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

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

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

    Le graphique de topologie est entièrement interactif. Vous pouvez effectuer un zoom avant et 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 sur le nœud.

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

    • Pour sélectionner les colonnes à afficher dans le tableau, cliquez sur Column display options (Options d'affichage des colonnes) .
    • Pour filtrer le tableau en fonction de propriétés spécifiques, sélectionnez les propriétés dans le champ Filter (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 Edit in Cloud Hub (Modifier dans Cloud Hub).

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

Afficher les graphiques d'un agent enregistré

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

    Accéder à la page "Agent Registry" (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 Queries (Requêtes), cliquez sur une requête.

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

    Le graphique de topologie est entièrement interactif. Vous pouvez effectuer un zoom avant et 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 sur le nœud.

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

    • Pour sélectionner les colonnes à afficher dans le tableau, cliquez sur Column display options (Options d'affichage des colonnes) .
    • Pour filtrer le tableau en fonction de propriétés spécifiques, sélectionnez les propriétés dans le champ Filter (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 Edit in Cloud Hub (Modifier dans Cloud Hub).

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

Étape suivante