您可以在 Gemini Enterprise Agent Platform 中查看代理關係,包括代理之間的通訊,以及代理與 MCP 伺服器之間的通訊。
您可以使用提供的查詢,以拓撲圖或表格形式查看查詢結果。代理程式關係資訊有助於瞭解依附元件,並支援代理程式管理。
您可以查看探索到的代理,以及向 Agent Registry 註冊的代理資料。Gemini Enterprise Agent Platform 會使用匯總追蹤資料判斷關係。
限制
- 查詢結果只會包含符合下列條件的元件:
- MCP 伺服器註冊至 Agent Registry 時,會由 App Hub 分類為共用資源,不會在拓撲圖中顯示其他節點的邊緣。這項限制僅適用於分類為共用資源的 MCP 伺服器,不適用於應用程式專屬資源,例如 Gemini Enterprise 資料連接器或 Cloud Run 上代管的 MCP 伺服器。
事前準備
啟用 App Hub、App Topology、Observability 和 Trace API。
啟用 API 時所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則,您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。- 使用 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」中查看資訊主頁。