Visualizzare le relazioni con gli agenti

Puoi visualizzare le relazioni tra gli agenti nella piattaforma Gemini Enterprise Agent, inclusa la comunicazione tra gli agenti e tra gli agenti e i server MCP.

Utilizzando le query fornite, puoi esplorare i risultati della query come grafico di topologia o come tabella. Le informazioni sulle relazioni tra gli agenti possono aiutarti a comprendere le dipendenze e a supportare la governance degli agenti.

Puoi visualizzare i dati sia per gli agenti rilevati sia per quelli registrati in Agent Registry. Gemini Enterprise Agent Platform determina le relazioni utilizzando i dati di traccia aggregati.

Limitazioni

  • I risultati della query includono solo i componenti che soddisfano i seguenti criteri:
    • Gli agenti devono avere il tipo funzionale impostato su AGENT ed essere sottoposti a deployment utilizzando ADK, Gemini Enterprise o Cloud Run oppure essere sottoposti a deployment utilizzando GKE e registrati in Agent Registry.
    • I server MCP devono avere il tipo funzionale impostato su MCP. Sono inclusi i server MCP proprietari di cui è stato eseguito il deployment utilizzando OneMCP, GKE o Cloud Run. Gli altri server MCP devono essere registrati con Agent Registry per essere inclusi.
    • Altri componenti, come strumenti e modelli o Workspace Agents, non sono inclusi nei risultati.
  • Quando un server MCP viene registrato in Agent Registry, viene classificato come risorsa condivisa da App Hub, che non mostra i bordi ad altri nodi nel grafico della topologia. Questa limitazione si applica solo se il server MCP è classificato come risorsa condivisa e non si applica a risorse esclusive dell'applicazione, come i connettori di dati Gemini Enterprise o i server MCP ospitati su Cloud Run.

Prima di iniziare

  1. Abilita le API App Hub, App Topology, Observability e Trace.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

    Abilita le API

    2. Se hai aggiunto altri progetti all'ambito delle tracce, ti consigliamo di abilitare l'API Observability anche per questi progetti. Il grafico della topologia mostra solo i dati di traccia dei progetti nell'ambito traccia che si trovano nella stessa organizzazione del progetto selezionato.

  2. Instrumenta le tue applicazioni AI con OpenTelemetry.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare i grafici della topologia, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

  • Visualizza grafici: App Topology Viewer (roles/apptopology.viewer)
  • Visualizza i dati dell'agente registrato: Agent Registry API Viewer (agentregistry.viewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Visualizzare i grafici per un progetto

  1. Nella console Google Cloud , vai alla pagina Topologia.

    Vai a Topologia

  2. Nel selettore di progetti, seleziona il progetto che contiene i tuoi agenti.

  3. Nella sezione Query, fai clic su una query.

  4. La sezione Grafico mostra i risultati della query selezionata.

    Il grafico della topologia è completamente interattivo. Puoi aumentare e diminuire lo zoom e trascinare i nodi per visualizzare le relazioni. Per aprire un riquadro che fornisce ulteriori dettagli su un nodo del grafico, fai clic sul nodo.

  5. Per visualizzare i risultati della query come tabella, fai clic su Tabella.

    • Per selezionare le colonne visualizzate nella tabella, fai clic su Opzioni di visualizzazione delle colonne .
    • Per filtrare la tabella in base a proprietà specifiche, seleziona le proprietà nel campo Filtro.
    • Puoi anche ordinare ogni colonna in ordine crescente o decrescente.

  6. Per perfezionare o personalizzare la query, puoi modificarla e visualizzare i risultati come grafico della topologia in Cloud Hub. Fai clic su Modifica in Cloud Hub.

Per visualizzare altri dati sugli agenti nel progetto selezionato, visualizza le dashboard in Monitoraggio applicazioni.

Visualizzare i grafici per un agente registrato

  1. Nella console Google Cloud , vai alla pagina Registro degli agenti.

    Vai al registry degli agenti

  2. Nel selettore di progetti, seleziona il progetto che contiene i tuoi agenti.

  3. Nella scheda Agenti, fai clic sul nome dell'agente che vuoi visualizzare.

  4. Fai clic sulla scheda Topologia.

  5. Nella sezione Query, fai clic su una query.

  6. La sezione Grafico mostra i risultati della query selezionata.

    Il grafico della topologia è completamente interattivo. Puoi aumentare e diminuire lo zoom e trascinare i nodi per visualizzare le relazioni. Per aprire un riquadro che fornisce ulteriori dettagli su un nodo del grafico, fai clic sul nodo.

  7. Per visualizzare i risultati della query come tabella, fai clic su Tabella.

    • Per selezionare le colonne visualizzate nella tabella, fai clic su Opzioni di visualizzazione delle colonne .
    • Per filtrare la tabella in base a proprietà specifiche, seleziona le proprietà nel campo Filtro.
    • Puoi anche ordinare ogni colonna in ordine crescente o decrescente.

  8. Per perfezionare o personalizzare la query, puoi modificarla e visualizzare i risultati come grafico della topologia in Cloud Hub. Fai clic su Modifica in Cloud Hub.

Per visualizzare altri dati sull'agente selezionato, visualizza le dashboard in Monitoraggio delle applicazioni.

Passaggi successivi