Agent Registry 資料模型

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

  • 代理：自主 AI 角色，可執行特定工作、叫用工具，以及與其他代理協作。
  • MCP 伺服器：提供標準化資料資源和工具。工具是 MCP 伺服器公開的確定性函式，代理可以叫用這些函式來執行特定動作。
  • 端點：代理程式存取的目標網址，通常是 REST API。Agent Registry 會將這些目的地抽象化為可管理的資源，讓您集中控管代理可存取的外部 API。
  • 技能：可擴充代理功能的模組化能力。 代理註冊表會區分獨立技能 (指令和選用指令碼的套件，直接在註冊表中控管) 和 A2A 技能 (代理資訊卡上列出的能力說明，可讓其他代理瞭解何時及如何與該代理通訊)。

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

API 資源

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

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

建立 Service 時使用的規格標記會決定產生的唯讀資源集合：

旗標 資源收集 用途 有效值
--agent-spec-type
--agent-spec-content		 Agent (agents) 遠端代理程式 (符合 A2A 規範或標準 REST 代理程式) a2a-agent-card、no-spec
--endpoint-spec-type
--endpoint-spec-content		 Endpoint (endpoints) 外部目標 REST API 或服務網址 no-spec
--mcp-server-spec-type
--mcp-server-spec-content		 McpServer (mcp-servers) 外部 Model Context Protocol (MCP) 伺服器 tool-spec

這些旗標配對互斥。如果指定無效的旗標，資源就會在錯誤的集合中建立，且可能無法搭配類型專屬政策使用。

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

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

支援的產品和元件

Agent Registry 會根據支援的產品和元件註冊方式 (自動或手動)，將其分類。

自動註冊

Agent Registry 會自動探索並擷取專案中部署的支援工作負載。Google Cloud 對於導入開放式 Agent2Agent (A2A) 通訊協定的代理，登錄程序會自動從代理資訊卡擷取 A2A 技能和功能。設定 Agent Registry 後，全球使用者也能探索 Google 建立的獨立技能。

下表列出 Agent Registry 會自動註冊的產品和元件：

元件類型 支援的產品
代理程式
MCP 伺服器
技能 Google 的公開技能可供所有專案在全球探索

手動註冊

如果是自訂工作負載、外部雲端執行階段、地端部署基礎架構，或是未實作 A2A 通訊協定的代理程式，請使用可寫入的 Service 資源手動註冊元件。如果是自訂獨立技能，請使用 Skill 資源。

下表列出您手動註冊的產品和元件：

元件類型 支援的資源
代理程式 遠端代理程式，部署於 Compute Engine、Google Kubernetes Engine、 Cloud Run、地端部署系統或外部雲端
MCP 伺服器 在不支援的執行階段或外部 MCP 伺服器上使用自訂代理式元件
端點 受端點控管的外部目標 REST API 或服務網址
技能 貴機構自行編寫的獨立技能

後續步驟