Ver relacionamentos de agentes

É possível conferir os relacionamentos entre agentes na Gemini Enterprise Agent Platform, incluindo a comunicação entre agentes e entre agentes e servidores MCP.

Usando as consultas fornecidas, é possível analisar os resultados como um gráfico de topologia ou uma tabela. As informações sobre relacionamentos entre agentes podem ajudar você a entender as dependências e apoiar a governança de agentes.

Você pode conferir os dados dos agentes descobertos e dos registrados no Registro de agentes. A Gemini Enterprise Agent Platform determina relações usando dados de rastreamento agregados.

Limitações

  • Os resultados da consulta incluem apenas componentes que atendem aos seguintes critérios:
    • Os agentes precisam ter o tipo funcional definido como AGENT e ser implantados usando o ADK, o Gemini Enterprise ou o Cloud Run. Também podem ser implantados usando o GKE e registrados no Registro de agentes.
    • Os servidores MCP precisam ter o tipo funcional definido como MCP. Servidores MCP próprios implantados usando OneMCP, GKE ou Cloud Run estão incluídos. Outros servidores MCP precisam ser registrados no Agent Registry para serem incluídos.
    • Outros componentes, como ferramentas e modelos, ou agentes do Workspace não estão incluídos nos resultados.
  • Quando um servidor MCP é registrado no Agent Registry, ele é classificado como um recurso compartilhado pelo App Hub, que não mostra arestas para outros nós no gráfico de topologia. Essa limitação só se aplica se o servidor MCP for classificado como um recurso compartilhado e não se aplica a recursos exclusivos do aplicativo, como conectores de dados do Gemini Enterprise ou servidores MCP hospedados no Cloud Run.

Antes de começar

  1. Ative as APIs App Hub, App Topology, Observability e Trace.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão com o papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar as APIs

    2. Se você adicionou outros projetos ao seu escopo de rastreamento, recomendamos que também ative a API Observability para esses projetos. O gráfico de topologia mostra apenas dados de rastreamento de projetos no mesmo escopo e organização do projeto selecionado.

  2. Instrumente seus aplicativos de IA com o OpenTelemetry.

Funções exigidas

Para ter as permissões necessárias para visualizar gráficos de topologia, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  • Ver gráficos: App Topology Viewer (roles/apptopology.viewer)
  • Ver dados do agente registrado: Leitor da API Agent Registry (agentregistry.viewer)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Ver gráficos de um projeto

  1. No console do Google Cloud , acesse a página "Topologia".

    Acesse "Topologia"

  2. No seletor de projetos, selecione o projeto que contém seus agentes.

  3. Na seção Consultas, clique em uma consulta.

  4. A seção Gráfico mostra os resultados da consulta selecionada.

    O gráfico de topologia é totalmente interativo. Você pode aumentar e diminuir o zoom e arrastar os nós para visualizar as relações. Para abrir um painel com mais detalhes sobre um nó no gráfico, clique nele.

  5. Para ver os resultados da consulta como uma tabela, clique em Tabela.

    • Para selecionar as colunas que a tabela mostra, clique em Opções de exibição de coluna
    • Para filtrar a tabela por propriedades específicas, selecione as propriedades no campo Filtro.
    • Também é possível classificar cada coluna em ordem crescente ou decrescente.

  6. Para refinar ou personalizar sua consulta, edite a consulta selecionada e veja os resultados como um gráfico de topologia no Cloud Hub. Clique em Editar no Cloud Hub.

Para conferir mais dados sobre os agentes no projeto selecionado, acesse os painéis em Monitoramento de aplicativos.

Ver gráficos de um agente registrado

  1. No console do Google Cloud , acesse a página "Registro de agentes".

    Acessar o Agent Registry

  2. No seletor de projetos, selecione o projeto que contém seus agentes.

  3. Na guia Agentes, clique no nome do agente que você quer visualizar.

  4. Clique na guia Topologia.

  5. Na seção Consultas, clique em uma consulta.

  6. A seção Gráfico mostra os resultados da consulta selecionada.

    O gráfico de topologia é totalmente interativo. Você pode aumentar e diminuir o zoom e arrastar os nós para visualizar as relações. Para abrir um painel com mais detalhes sobre um nó no gráfico, clique nele.

  7. Para ver os resultados da consulta como uma tabela, clique em Tabela.

    • Para selecionar as colunas que a tabela mostra, clique em Opções de exibição de coluna
    • Para filtrar a tabela por propriedades específicas, selecione as propriedades no campo Filtro.
    • Também é possível classificar cada coluna em ordem crescente ou decrescente.

  8. Para refinar ou personalizar sua consulta, edite a consulta selecionada e veja os resultados como um gráfico de topologia no Cloud Hub. Clique em Editar no Cloud Hub.

Para conferir mais dados sobre o agente selecionado, consulte os painéis em Application Monitoring.

A seguir