Agent Registry 資料模型

Agent Registry 會將生態系統的代理元件分類為三種主要類型,您可以在環境中探索這些元件:

  • 代理:具備特定技能的自主型角色。技能代表代理程式的高階功能,也是主要的探索機制。
  • MCP 伺服器:提供標準化資料資源和工具。工具是 MCP 伺服器公開的決定性函式,代理可以叫用這些函式來執行特定動作。
  • 端點:代理程式存取的目標網址,通常是 REST API。Agent Registry 會將這些目的地抽象化為可管理的資源,讓您集中控管代理程式可存取哪些外部 API。

如要進一步瞭解這些概念,以及 Agent Registry 使用的其他概念,請參閱「基本概念」。

Agent Registry API 會區分讀取和寫入作業。在 Agent Registry 中,Service 是可寫入的 API 資源,代表您手動新增至登錄檔的代理、MCP 伺服器或端點。Agent Registry 也會自動註冊在支援的 Google Cloud 執行階段部署的代理和伺服器。

啟用 Agent Registry API,即可註冊及管理代理、MCP 伺服器和端點。您可以使用可寫入的 Service 資源,手動建立、更新及刪除登錄檔中的項目。然後查詢唯讀的 AgentMcpServerEndpoint 資源,分別取得、列出及搜尋已註冊的代理程式、伺服器和端點。

如要開始使用,請參閱「設定代理程式登錄」。

在登錄檔中註冊代理程式元件

Agent Registry 會透過自動和手動兩種註冊機制,維護代理和 MCP 伺服器目錄。使用 Service 資源手動建立、更新及刪除項目。

註冊機制 說明 已註冊的元件 支援的 Google Cloud 產品
自動註冊 您可以設定及使用 Agent Registry,自動探索及擷取部署在支援的 Google Cloud 執行階段的特定資源。對於導入開放式 Agent2Agent (A2A) 通訊協定的代理程式,登錄檔也會自動從代理資訊卡擷取技能和能力。 代理
MCP 伺服器 Google 官方和 Google Cloud 遠端 MCP 伺服器
手動註冊 如為外部資源、不支援的執行階段的自訂代理功能元件,或未實作 A2A 通訊協定的標準 REST 代理程式,您必須在登錄中建立 Service 資源,手動註冊這些項目。 代理 遠端代理程式
MCP 伺服器 不支援的執行階段或外部 MCP 伺服器上的自訂代理式元件

後續步驟