Agent Registry 資料模型

Agent Registry 會將生態系統的代理元件分類為四種主要資源類型，方便您管理及探索：

  • 代理：自主 AI 角色，可執行特定 AI 工作流程。代理程式必須具備特定技能，才能瞭解工作流程功能。在 Agent Registry 中，代理程式技能會以宣告式中繼資料 (A2A 技能) 或模組化可執行套件 (技能) 表示。
  • MCP 伺服器：提供標準化資料資源和工具。工具是 MCP 伺服器公開的決定性函式，代理可以叫用這些函式來執行特定動作。
  • 端點：目標網址 (通常是 REST API)，代理程式會存取這些網址。Agent Registry 會將這些目的地抽象化為可管理的資源，讓您集中控管代理程式可存取的外部 API。
  • 技能：可執行的獨立指令、程式碼和中繼資料套件，直接在 Agent Registry 中管理。獨立技能與 A2A 技能不同，後者是代理程式代理資訊卡中宣告的內嵌宣告式中繼資料區塊資訊清單。

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

API 資源

Agent Registry API 會區分代理、端點和 MCP 伺服器的讀取和寫入作業：

  • 可寫入的 API 資源：您可以手動建立、更新或刪除登錄中的 Service 資源，管理這些代理程式元件。
  • 唯讀 API 資源：如要查詢、列出或搜尋這些代理程式元件，請向 Agent Registry API 要求唯讀 Agent、McpServer 或 Endpoint 資源。

獨立技能不會使用 Service 投影模型。而是直接使用 Skill、SkillRevision 和 Publisher API 資源，管理、版本控管及列出技能。

如要開始使用，請參閱「設定 Agent Registry」。如要進一步瞭解 Agent Registry API，請參閱 API 參考文件。

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

Agent Registry 會透過自動和手動兩種註冊機制，維護代理和 MCP 伺服器目錄。

Agent Registry 會自動註冊在支援的 Google Cloud 執行階段部署的代理程式和伺服器。啟用 Agent Registry API，即可註冊及管理代理、MCP 伺服器和端點。設定 Agent Registry 後，您也會立即看到 Google 建立的技能。

此外，您也可以使用 Service 資源手動建立、更新及刪除項目。接著，您會查詢唯讀的 Agent、McpServer 或 Endpoint 資源，分別取得、列出及搜尋已註冊的代理程式、伺服器和端點。如要手動註冊及搜尋技能，請使用 Skill 資源。

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

後續步驟