在「Agent Registry」中，您可以查看拓撲圖，瞭解代理程式或 AI 應用程式的流量。分析圖表有助於瞭解代理或 AI 應用程式是否與可信任的代理、MCP 伺服器和端點通訊。
如要進一步瞭解代理程式資源，請使用查詢產生器，在「拓撲」頁面上執行查詢。您可以將與代理程式相關聯的可觀測性、安全性、軟體供應鏈和基礎架構資源資料視覺化。
拓撲資料有部分限制。
事前準備
這些操作說明假設您已設定 Agent Registry，並註冊代理程式資源。
如要查看代理程式流量，請檢測 AI 應用程式。
如果尚未啟用，請啟用 App Hub、App Topology、Cloud Asset Inventory 和 Observability API。
啟用 API 時所需的角色
如要啟用 API，您必須具備
serviceusage.services.enable權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。如果您要保護 VPC Service Controls 周邊範圍內的服務，請更新周邊範圍，納入應用程式拓撲和提供基礎資料的服務。瞭解詳情。
必要的角色
如要取得在 Agent Registry 中查看拓撲圖所需的權限，請要求管理員在您要使用 App Topology 的專案中，授予下列 IAM 角色：
- App Topology Viewer (
roles/apptopology.viewer) - Agent Registry API 檢視者 (
roles/agentregistry.viewer)
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。
這些預先定義的角色具備在 Agent Registry 中查看拓撲圖所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：
所需權限
如要在 Agent Registry 中查看拓撲圖，必須具備下列權限：
-
取得探索到的資源資料：
apptopology.discoveredResourcesTopologies.generate -
取得資源資料：
apptopology.sreDomainTopologies.generate
查看代理程式拓撲
前往 Google Cloud 控制台的「Agent Registry」頁面。
在專案挑選器中，選取含有代理程式的專案。
在「代理」分頁中，按一下要查看的代理名稱。
按一下「拓撲」分頁標籤。
在「快速查詢」部分，按一下查詢。如果查詢有相符結果，系統就會顯示拓撲圖。
探索拓撲圖。圖表會顯示符合查詢的資源，以及這些資源之間的關係。
- 圖示代表節點、已探索及註冊的資源，以及資源類型。
- 線條代表節點之間的連線和關係。
您可以透過下列方式與拓撲互動：
- 縮放或重新放置節點，即可變更視覺化內容。
- 將滑鼠游標懸停在兩個節點之間的連線線上，即可查看連線的標籤。
- 選取節點或連線，即可取得相關資訊。
- 按一下「切換面板」 ，即可隱藏或顯示查詢面板。
如要查看所選代理程式的其他資料，請在「應用程式監控」中查看資訊主頁。
查看 AI 應用程式拓撲
前往 Google Cloud 控制台的「Agent Registry」頁面。
在專案挑選器中，選取含有 AI 應用程式的專案。
在「AI applications」(AI 應用程式) 分頁中，點選要查看的代理程式名稱。
按一下「拓撲」分頁標籤。
在「快速查詢」部分，按一下查詢。如果查詢有相符結果，系統就會顯示拓撲圖。
探索拓撲圖。圖表會顯示符合查詢的資源，以及這些資源之間的關係。
- 圖示代表節點、已探索及註冊的資源，以及資源類型。
- 線條代表節點之間的連線和關係。
您可以透過下列方式與拓撲互動：
- 縮放或重新放置節點，即可變更視覺化內容。
- 將滑鼠游標懸停在兩個節點之間的連線線上，即可查看連線的標籤。
- 選取節點或連線，即可取得相關資訊。
- 按一下「切換面板」 ，即可隱藏或顯示查詢面板。
如要查看所選應用程式的其他資料，請在「應用程式監控」中查看資訊主頁。
後續步驟
- 在拓撲頁面上，查看更多有關代理程式資源的資料。