您可以在 Gemini Enterprise Agent Platform 中查看代理關係，包括代理之間的通訊，以及代理與 MCP 伺服器之間的通訊。
您可以透過提供的查詢，以拓撲圖或表格形式查看查詢結果。代理程式關係的相關資訊有助於瞭解依附元件，並支援代理程式管理。
您可以查看已探索到的代理，以及向 Agent Registry 註冊的代理資料。Gemini Enterprise Agent Platform 會使用匯總追蹤資料判斷關係。
限制
- 查詢結果只會顯示符合下列條件的元件：
- 代理的功能類型必須設為
AGENT，並使用 ADK、Gemini Enterprise 或 Cloud Run 部署；或使用 GKE 部署，並向代理程式登錄註冊。 - MCP 伺服器的功能類型必須設為
MCP。使用 OneMCP、GKE 或 Cloud Run 部署的第一方 MCP 伺服器也包含在內。如要納入其他 MCP 伺服器，必須向 Agent Registry 註冊。 - 工具、模型或 Workspace 代理程式等其他元件不會列入結果。
- 代理的功能類型必須設為
- MCP 伺服器註冊至 Agent Registry 時，會由 App Hub 分類為共用資源，不會在拓撲圖中顯示其他節點的邊緣。這項限制僅適用於分類為共用資源的 MCP 伺服器，不適用於應用程式專屬資源，例如 Gemini Enterprise 資料連接器或 Cloud Run 上代管的 MCP 伺服器。
事前準備
啟用 App Hub、App Topology、Observability 和 Trace API。
啟用 API 時所需的角色
如要啟用 API，您需要具備服務使用情形管理員 IAM 角色 (
roles/serviceusage.serviceUsageAdmin)，其中包含serviceusage.services.enable權限。瞭解如何授予角色。- 使用 OpenTelemetry 檢測 AI 應用程式。
如果您已將其他專案新增至追蹤範圍，建議您也為這些專案啟用 Observability API。拓撲圖只會顯示追蹤範圍專案的追蹤資料，且這些專案必須與所選專案位於同一機構。
必要的角色
如要取得查看拓撲圖所需的權限，請要求管理員在專案中授予您下列 IAM 角色：
-
查看圖表：App Topology Viewer (
roles/apptopology.viewer) -
查看已註冊的代理程式資料：
Agent Registry API 檢視者 (
agentregistry.viewer)
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。
查看專案的圖表
前往 Google Cloud 控制台的「拓撲」頁面。
在專案選擇工具中，選取含有代理程式的專案。
在「Queries」(查詢) 區段中，按一下查詢。
「圖表」部分會顯示所選查詢的結果。
拓撲圖表是完全互動式的，您可以放大和縮小，以及拖曳節點來協助您以視覺化方式呈現關係。如要開啟面板，提供圖表中節點的其他詳細資料，請按一下節點。
如要以表格形式查看查詢結果，請按一下「表格」。
- 如要選取表格顯示的資料欄，請按一下「資料欄顯示選項」圖示 。
- 如要篩選表格中的特定屬性，請在「篩選」欄位中選取屬性。
- 您也可以依遞增或遞減順序排序每個資料欄。
如要調整或自訂查詢，可以編輯所選查詢，並在 Cloud Hub 中以拓撲圖的形式查看結果。按一下「在 Cloud Hub 中編輯」。
如要查看所選專案中代理程式的其他資料，請在 Application Monitoring 中查看資訊主頁。
查看已註冊代理的圖表
前往 Google Cloud 控制台的「Agent Registry」頁面。
在專案選擇工具中，選取含有代理程式的專案。
在「代理程式」分頁中，按一下要查看的代理程式名稱。
按一下「拓撲」分頁標籤。
在「Queries」(查詢) 區段中，按一下查詢。
「圖表」部分會顯示所選查詢的結果。
拓撲圖表是完全互動式的，您可以放大和縮小，以及拖曳節點來協助您以視覺化方式呈現關係。如要開啟面板，提供圖表中節點的其他詳細資料，請按一下節點。
如要以表格形式查看查詢結果，請按一下「表格」。
- 如要選取表格顯示的資料欄，請按一下「資料欄顯示選項」圖示 。
- 如要篩選表格中的特定屬性，請在「篩選」欄位中選取屬性。
- 您也可以依遞增或遞減順序排序每個資料欄。
如要調整或自訂查詢，可以編輯所選查詢，並在 Cloud Hub 中以拓撲圖的形式查看結果。按一下「在 Cloud Hub 中編輯」。
如要查看所選代理程式的其他資料，請在「Application Monitoring」中查看資訊主頁。