基本概念

Agent Registry 使用標準化術語,描述 AI 生態系統中的元件、資源和管理機制。瞭解這些基礎概念,有助於您在 Agent Registry 中註冊、探索、連結及管理代理、MCP 伺服器、端點和技能。

A2A 技能

與技能比較。

代理 agent-card.json 代理資訊卡中內嵌的能力說明。A2A 技能會說明代理可執行的工作及其通訊介面,讓其他代理知道何時及如何委派工作。

Agent Registry 支援 Agent2Agent (A2A) 規格的 0.3 和 1.0 版本。如要比較獨立技能,請參閱「獨立技能和 A2A 技能之間的差異」。

代理

AI 生態系統中的自主執行者,可規劃、推論、叫用工具,並與其他代理協作。代理是由代理 ID 和其擁有的各項 A2A 技能或獨立技能定義。在 Agent Registry 中,註冊的代理會以唯讀的 Agent 探索資源表示。

代理主體

指派給代理的專屬 Identity and Access Management (IAM) 身分,可讓代理持有權限、存取下游資源,以及產生稽核記錄。這類身分會以可驗證的 Google Cloud 服務帳戶或代管 Workload Identity 的形式呈現,例如直接繫結至代理程式運算執行階段的 SPIFFE ID。

主體字串包含執行階段參照路徑,並支援三個範圍:引擎執行個體、專案層級主體集,以及組織層級主體集。

如需完整的語法和存取控管指南,請參閱「代理主體」。

代理元件

AI 生態系統中的模組化功能實體,可透過 Agent Registry 註冊、探索及管理。儲存庫會將代理元件分為四種主要類型:代理、MCP 伺服器、端點和技能。

詳情請參閱「元件生命週期和探索」。

代理工作流程

AI 代理獨立決定工具使用方式、推論和執行路徑,以完成任務的一系列步驟。

驗證提供者

Agent Identity 驗證管理工具中的設定,用於儲存、取得及管理憑證 (例如 API 金鑰或 OAuth 權杖),以便將代理連結至外部工具和下游服務。

如要進一步瞭解如何將代理程式繫結至驗證提供者,請參閱「元件關係」。

繫結

來源代理與目標資源 (例如其他代理、MCP 伺服器或端點) 之間的定向連線。繫結會在元件之間建立明確的委派路徑,並將代理與驗證提供者建立關聯,以便委派權限。

詳情請參閱「繫結」。

資料資源

MCP 伺服器公開的特定資料情境或資料集,代理可存取這些資料,做為回覆或行動的依據。

探索

使用自然語言搜尋、標記或註冊資料庫 ID,查詢 Agent Registry,找出已註冊的代理、MCP 工具、端點或技能。

Agent Registry 的探索功能著重於探索使用情形,可找出自動化調度管理代理在執行階段可叫用的功能和元件。詳情請參閱「探索類型」。

端點

目標網址,通常是 REST API,由代理存取。在 Agent Registry 中,已註冊的端點會以唯讀的 Endpoint 探索資源表示,方便您集中管理代理可存取的外部服務。

管理專案

啟用 Agent Registry API 的 Google Cloud 專案,可集中編目、探索及管理代理元件。在跨專案管理邊界中,管理專案是邊界的中央管理專案。如要進一步瞭解單一專案和跨專案設定,請參閱「定義中央註冊資料庫的管理專案」。

管理範圍

註冊及管理 Agent Registry 資源的地理和架構邊界。

Agent Registry 使用中央 Google Cloud 管理專案,您可以在其中啟用 Agent Registry API,分類及管理代理元件。根據預設,自動註冊功能會探索在該管理專案中部署的支援工作負載。設定管理邊界後,管理專案會做為中央管理專案,自動匯總在邊界內成員專案中發現的支援工作負載。如要控管託管於控管專案或管理邊界外的「遠端」元件 (例如沒有邊界的獨立Google Cloud 專案、地端部署環境或外部雲端),請在控管專案的登錄檔中手動註冊這些元件。

Agent Registry 自動註冊 Google 或 Google Cloud遠端 MCP 伺服器時,只會在 global 位置建立 McpServer 資源,不會在個別區域建立。您可以在支援的地區位置或 global 位置,手動註冊代理、MCP 伺服器和端點,並建立繫結。區域閘道可管理流量,並將流量轉送至區域資源和 global MCP 伺服器。

如要瞭解完整的區域範圍規則和政策規定,請參閱「Agent Registry 位置」。

管理邊界

由一或多個 Google Cloud 專案組成的集合,用於定義 AI 生態系統的管理範圍,在 Resource Manager 中以 Boundary 資源表示。管理邊界是在 Resource Manager 的組織或資料夾中定義。您可以納入該資料夾或組織中的所有子專案,也可以依選用標記篩選子專案。管理邊界可讓您集中探索及控管多個成員專案中的代理元件。

Agent Registry 會使用 Resource Manager 中的 BoundaryConfig、Boundary 和 CapabilityConfig 資源,支援跨專案檢視和集中式存取權政策。如要進一步瞭解這些 Resource Manager 資源,請參閱「管理邊界和功能總覽」。

如要進一步瞭解如何在代理程式登錄資料庫中使用管理邊界,請參閱「跨專案邊界」。

管理專案

Google Cloud 專案,做為管理邊界的中央管理專案,集中管理邊界內的管理工作、API 端點和中繼資料。您可以使用管理專案設定 Agent Registry、設定計費和配額,以及查詢成員專案中匯總的代理和工具登錄檔。

詳情請參閱「管理專案」。

Model Context Protocol (MCP)

用於將 AI 模型連結至資料來源和工具的開放標準,可取代客製化外掛程式。

MCP 伺服器

實作 Model Context Protocol (MCP) 的程式,可向 AI 代理公開標準化工具和資料資源功能。在 Agent Registry 中,已註冊的 MCP 伺服器會以唯讀 McpServer 探索資源的形式呈現。

發布者

建立及註冊技能的實體,在 Agent Registry 中以 Publisher 資源表示。發布商會建立技能的擁有權和技能 ID 語法。

Google 代管技能會使用服務網域。手動建立的技能會自動限定在 private 發布者範圍內,並加上 private- 前置字元。

詳情請參閱「發布者」。

註冊

將代理元件 (例如代理、MCP 伺服器、端點或技能) 新增至 Agent Registry 的程序。

Agent Registry 支援兩種註冊模式:

  • 自動註冊:自動擷取代理、MCP 伺服器和 Google 代管技能,來源包括支援的 Google Cloud 執行階段 (例如 Gemini Enterprise Agent Platform 上的 Agent Runtime),這些執行階段部署在已啟用 Agent Registry 的管理專案中,或是在您設定管理邊界時,從成員專案匯總。
  • 手動註冊:在管理專案的註冊資料庫中建立資源,明確註冊遠端或自訂代理、MCP 伺服器、端點和私人獨立技能,包括託管於獨立 Google Cloud 專案 (無管理邊界)、地端部署環境、外部雲端或不支援執行階段的元件。

如需詳細的架構比較,請參閱「註冊模型」。

註冊資料庫 ID

Agent Registry 指派給已註冊代理元件的全域不重複、不可變更統一資源名稱 (URN)。這個 ID 為消費者和自動調度管理代理提供穩定的參考依據,以便在代理程式註冊表中探索、篩選及搜尋元件,無論基礎架構變更或程式碼更新,都能保持不變。

如需詳細的 URN 語法格式,請參閱「登錄檔 ID」。

執行階段參考資料

託管代理、MCP 伺服器或端點的實體執行階段位置或運算基礎架構,在 Agent Registry 中以 agentregistry.googleapis.com/system/RuntimeReference 屬性表示。例如,執行階段參照可以指向 Agent Runtime 推論引擎、Google Kubernetes Engine (GKE) 部署作業或 Cloud Run 服務。

執行階段參考路徑會嵌入代理主體,用於評估 IAM 政策。詳情請參閱「執行階段參考資料」。

服務資源

Agent Registry 中的可寫入資源,由其資源名稱識別,用於手動註冊代理、MCP 伺服器或端點時的管理作業。Service 資源會儲存元件的中繼資料,包括代理元件的類型,以及介面網址、說明、通訊協定繫結和功能規格等設定詳細資料。自動註冊的元件或獨立技能不會使用 Service 資源。

您可以建立、更新或刪除 Service 資源,在 Agent Registry 中註冊、更新中繼資料或取消註冊手動註冊的元件,而不必修改或刪除基礎部署作業。建立或更新 Service 資源時,Agent Registry 會讀取中繼資料,並自動建立或更新對應的 Agent、McpServer 或 Endpoint 探索資源。在 Agent Registry 中,消費者 (例如自動調度管理代理、用戶端應用程式和開發人員) 會使用這些唯讀探索資源,列出、搜尋及查看代理元件。詳情請參閱「Agent Registry 中的代理元件表示法」。

技能

與 A2A 技能比較。

在 Agent Registry 中註冊為頂層 Skill 資源的獨立套件,可提供特定指令和選用指令碼來完成工作,藉此擴充代理的功能。技能包含 SKILL.md 指令檔案、選用指令碼和中繼資料資產。

技能會以技能 ID 識別,範圍由發布者和標準資源名稱定義。每項技能都會維護預設修訂版本指標,並有一或多個版本化快照,每個快照都代表一個技能修訂版本。

如要瞭解架構、封裝和生命週期,請參閱「技能架構」。

技能修訂版本

技能套件的不可變更版本快照,在 Agent Registry 中以 SkillRevision 資源表示。技能修訂版本可讓您更新技能指令或選用指令碼,而不必變更父項技能 ID,或破壞現有的代理依附元件。

如要進一步瞭解修訂版本管理和不可變動性,請參閱「技能修訂版本」。

工具

由 MCP 伺服器提供的確定性函式,可由代理叫用。