本文說明 Agent Registry 的重要詞彙和概念。
A2A 技能
與技能比較。
以代理的代理資訊卡 (agent-card.json) 內嵌表示的宣告式功能中繼資料區塊。A2A 技能說明代理對代理通訊介面，以及符合 A2A 規範的代理所具備的高階功能。
Agent Registry 支援 Agent2Agent (A2A) 規格的 0.3 和 1.0 版本。
代理
AI 生態系統中的自主行為者，由ID 和具備的特定 A2A 技能或技能定義。
代理程式 ID
代理程式的全域不重複且不可變更名稱。這個邏輯 ID 可做為消費者呼叫代理程式的穩定參照，且無論基礎架構如何變更，這個 ID 都不會改變。
Agent Registry 會在擷取期間自動產生代理程式 ID，並採用統一資源名稱 (URN) 格式。確切格式取決於代理程式的部署位置。例如：
- Gemini Enterprise Agent Platform 中的 Agent Runtime：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Cloud Run 服務：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - GKE 部署作業：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace：
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - 手動註冊的代理程式：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
代理主體
指派給代理的專屬 Identity and Access Management (IAM) ID，可讓代理持有權限並接受稽核。這類身分會以可驗證的Google Cloud 服務帳戶或受管理的工作負載身分形式呈現，例如繫結至代理程式或伺服器的 SPIFFE ID。
由於這個身分直接繫結至代理程式執行階段的運算資源，主體字串會納入該基礎資源的確切路徑。舉例來說，Gemini Enterprise Agent Platform 部署作業的 Agent Runtime 代理主體如下：
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
當您查看代理程式的詳細資料時，代理程式登錄會將這個身分顯示為僅供輸出的屬性。
代理元件
AI 生態系統中的模組化功能實體，您可透過 Agent Registry 註冊、探索及管理。登錄檔會將代理程式元件分類為四種主要類型：代理程式、MCP 伺服器、端點和技能。
代理式工作流程
AI 代理會自行判斷工具使用方式、推論和執行路徑，以完成工作。
驗證供應商
代理身分驗證管理員中的設定，用於儲存、取得及管理憑證 (例如 API 金鑰或 OAuth 權杖)，以便將代理連結至特定外部工具和應用程式，並定義驗證類型。
繫結
來源代理與目標資源之間的連線，例如另一個代理、MCP 伺服器或端點。建立繫結時，您會建立明確的關係，讓協調器代理與下游功能互動。繫結也用於將代理與驗證提供者建立關聯，以支援委派權限。
資料資源
MCP 伺服器公開的特定資料情境或資料集，代理可存取這些項目，以提供回覆或採取行動。
探索
根據說明、標記或技能查詢登錄資料，找出現有代理、MCP 工具或端點。
Agent Registry 的探索功能著重於以消費為中心的功能，供 AI 自動化調度管理工具使用。您會探索已註冊的功能，以便建構及協調 AI 系統。
Agent Registry 的這項程序與基礎架構探索不同 (例如 App Hub)，後者會找出 Google Cloud 專案中未註冊的運算資源。
端點
對於 Agent Registry API，這是代表目標網址的資源，通常是 Agent 存取的 REST API。Agent Registry 會將這些目的地抽象化為可管理的資源，讓您集中控管代理程式可存取的外部服務。
Model Context Protocol (MCP)
這項開放標準可將 AI 模型連結至資料來源和工具，取代自訂外掛程式。
MCP 伺服器 (或伺服器)
這項服務會實作 Model Context Protocol (MCP)，為 AI 代理程式 提供標準化工具和資料資源。
MCP 伺服器 ID
MCP 伺服器的全域專屬不變統一資源名稱 (URN)。與代理程式 ID 類似，這個名稱可做為探索特定工具組的穩定參照。
格式取決於這是內建的 Google 服務還是已註冊的外部伺服器。例如：
- Google Cloud 遠端 MCP 伺服器：
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - 手動註冊的 MCP 伺服器：
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
註冊
將代理元件 (例如代理、MCP 伺服器或端點) 新增至登錄檔的程序。代理程式登錄提供下列登錄機制：
- 自動註冊：自動擷取支援的Google Cloud AI 資源，例如 Agent Runtime 中的資源。自動註冊功能僅適用於單一專案。
- 手動註冊：手動導入自訂或外部代理元件，或跨多個 Google Cloud 專案部署代理，以集中探索及管理。
資源 URI
主機的實體執行階段位置或基礎架構，用於代管代理程式或 MCP 伺服器。統一資源識別碼 (URI) 是可識別這個執行階段資源的專屬字元序列。舉例來說，資源 URI 可以是 Agent Runtime 端點、Google Kubernetes Engine (GKE) 部署作業或 Cloud Run 服務。
資源 URI 與代理 ID 或 MCP 伺服器 ID 不同。這些值是 URN 格式的專屬名稱，用於識別登錄中的代理程式和 MCP 伺服器。相較之下，資源 URI 會指向代理程式或伺服器執行的實際運算資源。
代理程式的資源 URI 路徑會嵌入代理程式主體字串中，以便在 IAM 政策中明確識別該資源。如果是跨專案註冊，資源 URI 會參照運算資源所在的專案。
當您查看代理的詳細資料時，代理程式登錄會將這個 URI 顯示為僅供輸出的屬性。
您可以在拓撲圖中，使用資源 URI 建構查詢，以便顯示特定代理程式的流量流向和關係。在 Agent Registry API 中，這個值由 agentregistry.googleapis.com/system/RuntimeReference 屬性表示。
服務
對於 Agent Registry API，可寫入的資源用於手動將自訂或外部代理程式元件註冊到登錄檔。Service 代表手動新增至登錄檔的代理、MCP 伺服器或端點。您可以建立及管理 Service 資源，定義 Agent Registry 不會自動擷取的代理元件端點和中繼資料。
視您提供的規格而定，Agent Registry 會自動將此 Service 投影到消費者端，做為唯讀的 Agent、McpServer 或 Endpoint 資源以供探索。
您一律使用 Service 資源建立、編輯或刪除登錄項目。不過，如要取得、列出或搜尋這些項目，請查詢唯讀的 Agent、McpServer 或 Endpoint 資源。
技能
與 A2A 技能比較。
在 Agent Registry 中註冊為頂層資源的可執行獨立套件，可透過提供特定指令、自然語言或程式碼來完成工作，進而擴充代理程式的功能。技能包含指令檔 (SKILL.md)、執行階段執行指令碼和中繼資料資產。
技能是以統一資源名稱 (URN) 識別。確切格式取決於發布商。例如：
- Google 建立的技能：
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID。 例如：urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing。 - 手動註冊的技能：
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID。 例如：urn:skill:projects-123456789:locations:global:private-create-docs。
設定代理程式登錄後，系統會立即顯示 Google 建立的技能。 不過，您也可以註冊自己的技能。您可以在 Agent Registry 中註冊技能，做為代理和MCP 伺服器的同層級資源。每個技能都有預設修訂版本，且可包含多個版本化的技能修訂版本。
平台管理員可透過管理技能的生命週期狀態，以及設定執行階段解析的預設版本指標，控管技能。
技能修訂
技能套件的不可變更版本化快照。修訂版本可讓您更新技能指令或程式碼，而不必變更父項技能的 ID。
你可以管理技能修訂版本，控管技能版本。
Publisher
在 Agent Registry 中建立及註冊技能的實體。
預先填入的發布商包括 Google 發布商 (例如 cloud.google.com 和 discoveryengine.googleapis.com)，以及已驗證的合作夥伴。設定代理程式登錄時，系統會立即顯示這些發布商建立的 Google 技能。
您建立的技能會自動指派給預設的private發布者，因此特定技能的發布 ID 會加上 private-前置字元。您無法註冊自訂發布者資源。
檢查已註冊技能的發布者詳細資料。
工具
MCP 伺服器提供的確定性函式，代理可以叫用。