本文說明 Agent Registry 的重要詞彙和概念。
代理
AI 生態系統中的自主參與者，由ID 和具備的特定技能定義。
代理程式 ID
代理程式的全域不重複名稱，且無法變更。這個邏輯 ID 可做為消費者呼叫代理程式的穩定參照，且無論基礎架構如何變更，這個 ID 都不會改變。
代理程式 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 工具或端點。
代理程式登錄中的探索功能著重於以消費為中心的功能，可供 AI 協調器使用。您會探索已註冊的功能，以便建構及協調 AI 系統。
代理程式登錄中的這項程序與基礎架構探索不同 (例如 App Hub)，後者會識別 Google Cloud 專案中未註冊的運算資源。
端點
對於 Agent Registry API，這是指代表目標網址的資源，通常是 代理程式存取的 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 中。
- 手動註冊：手動導入自訂或外部代理程式元件。
資源 URI
主機的實體執行階段位置或基礎架構，可代管代理程式或 MCP 伺服器。統一資源識別碼 (URI) 是可識別這個執行階段資源的專屬字元序列。舉例來說，資源 URI 可以是 Agent Runtime 端點、Google Kubernetes Engine (GKE) 部署作業或 Cloud Run 服務。
資源 URI 與代理 ID 或 MCP 伺服器 ID 不同。這些值是 URN 格式的專屬名稱，用於識別登錄中的代理程式和 MCP 伺服器。相反地，資源 URI 會指向代理程式或伺服器執行的實際運算資源。
代理程式的資源 URI 路徑會嵌入 agent principal 字串中，以便在 IAM 政策中明確識別該資源。
當您查看代理程式的詳細資料時，代理程式登錄會將這個 URI 顯示為僅供輸出的屬性。
您可以在拓撲圖中，使用資源 URI 建構查詢，以便顯示特定代理程式的流量流向和關係。在 Agent Registry API 中，這個值是由 agentregistry.googleapis.com/system/RuntimeReference 屬性表示。
服務
對於 Agent Registry API，可寫入的資源用於手動將自訂或外部代理程式元件註冊到登錄檔。Service 代表手動新增至登錄檔的代理、MCP 伺服器或端點。您可建立及管理 Service 資源，定義 Agent Registry 不會自動擷取的代理程式元件端點和中繼資料。
視您提供的規格而定，代理程式登錄服務會自動將此 Service 投影到消費者端，做為探索用的唯讀 Agent、McpServer 或 Endpoint 資源。
您一律使用 Service 資源建立、編輯或刪除登錄項目。不過，如要取得、列出或搜尋這些項目，請查詢唯讀的 Agent、McpServer 或 Endpoint 資源。
技能
A2A 代理具備的高階功能。技能是從 A2A 代理資訊卡擷取，並做為代理探索的主要資料點。
工具
MCP 伺服器提供的確定性函式，代理可以叫用。