查看代理關係

您可以在 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 伺服器,必須向代理註冊資料庫註冊。
    • 工具、模型或 Workspace 代理程式等其他元件不會列入結果。
  • MCP 伺服器註冊至 Agent Registry 時,會由 App Hub 分類為共用資源,不會在拓撲圖中顯示其他節點的邊緣。這項限制僅適用於分類為共用資源的 MCP 伺服器,不適用於應用程式專屬資源,例如 Gemini Enterprise 資料連接器或 Cloud Run 上代管的 MCP 伺服器。

事前準備

  1. 啟用 App Hub、App Topology、Observability 和 Trace API。

    啟用 API 時所需的角色

    如要啟用 API,您必須具備 serviceusage.services.enable 權限。如果您建立了專案,可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則,您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色

    啟用 API

  2. 如果您已在追蹤範圍中加入其他專案,建議您也為這些專案啟用 Observability API。拓撲圖只會顯示追蹤記錄範圍專案的追蹤記錄資料,且這些專案必須與所選專案位於同一個機構。

  3. 使用 OpenTelemetry 檢測 AI 應用程式

必要的角色

如要取得查看拓撲圖所需的權限,請要求管理員在專案中授予您下列 IAM 角色:

  • 查看圖表:App Topology Viewer (roles/apptopology.viewer)
  • 查看已註冊的代理程式資料: Agent Registry API 檢視者 (agentregistry.viewer)

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

查看專案的圖表

  1. 前往 Google Cloud 控制台的「拓撲」頁面。

    前往「拓撲」

  2. 在專案挑選器中,選取含有代理程式的專案。

  3. 在「Queries」(查詢) 區段中,按一下查詢。

  4. 「圖表」部分會顯示所選查詢的結果。

    拓撲圖是完全互動式的,你可以放大/縮小,以及拖曳節點,以便清楚瞭解關係。如要開啟面板,查看圖表中節點的其他詳細資料,請按一下節點。

  5. 如要以表格形式查看查詢結果,請按一下「表格」

    • 如要選取表格顯示的資料欄,請按一下「資料欄顯示選項」
    • 如要依特定屬性篩選表格,請在「篩選條件」欄位中選取屬性。
    • 您也可以依遞增或遞減順序排序每個資料欄。
  6. 如要修正或自訂查詢,您可以編輯所選查詢,並在 Cloud Hub 中以拓撲圖的形式查看結果。按一下「在 Cloud Hub 編輯」

如要查看所選專案中代理程式的其他資料,請在 Application Monitoring 中查看資訊主頁。

查看已註冊代理程式的圖表

  1. 前往 Google Cloud 控制台的「Agent Registry」頁面。

    前往 Agent Registry

  2. 在專案挑選器中,選取含有代理程式的專案。

  3. 在「代理程式」分頁中,按一下要查看的代理程式名稱。

  4. 按一下「拓撲」分頁標籤。

  5. 在「Queries」(查詢) 區段中,按一下查詢。

  6. 「圖表」部分會顯示所選查詢的結果。

    拓撲圖是完全互動式的,你可以放大/縮小,以及拖曳節點,以便清楚瞭解關係。如要開啟面板,查看圖表中節點的其他詳細資料,請按一下節點。

  7. 如要以表格形式查看查詢結果,請按一下「表格」

    • 如要選取表格顯示的資料欄,請按一下「資料欄顯示選項」
    • 如要依特定屬性篩選表格,請在「篩選條件」欄位中選取屬性。
    • 您也可以依遞增或遞減順序排序每個資料欄。
  8. 如要修正或自訂查詢,您可以編輯所選查詢,並在 Cloud Hub 中以拓撲圖的形式查看結果。按一下「在 Cloud Hub 編輯」

如要查看所選代理程式的其他資料,請在「Application Monitoring」中查看資訊主頁。

後續步驟