本文說明 Agent Registry 的重要詞彙和概念。
代理
AI 生態系統中的自主執行者，由ID 和具備的特定技能定義。
代理程式 ID
代理程式的全域不重複名稱，且無法變更。這個邏輯 ID 可做為消費者呼叫代理程式的穩定參照，無論基礎架構如何變更，這個 ID 都不會改變。
Agent Registry 會在擷取期間自動產生代理程式 ID，並採用統一資源名稱 (URN) 格式。確切格式取決於代理程式的部署位置。例如：
- Vertex AI Agent Engine：
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
代理主體
指派給代理程式的專屬 IAM ID，可讓代理程式持有權限並接受稽核。這類身分會以可驗證的 Google Cloud服務帳戶或受管理的工作負載身分 (例如 SPIFFE ID) 的形式，繫結至代理程式或伺服器。
由於這個身分直接繫結至代理程式執行階段的運算資源，主體字串會納入該基礎資源的確切路徑。舉例來說，Vertex AI Agent Engine 部署作業的代理主體如下所示：
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
當您查看代理程式的詳細資料時，代理程式登錄會將這項身分顯示為僅供輸出的屬性。
代理工作流程
AI 代理會自行決定工具使用方式、推論和執行路徑，以完成工作。
驗證供應商
代理身分驗證管理員中的設定，用於儲存、取得及管理憑證 (例如 API 金鑰或 OAuth 權杖)，以便將代理連結至特定外部工具和應用程式，並定義驗證類型。
繫結
來源代理與目標資源之間的連線，例如另一個代理、MCP 伺服器或端點。建立繫結後，您就能建立明確的關係，讓協調器代理與下游功能互動。繫結也用於將代理與驗證提供者建立關聯，以支援委派權限。
資料資源
MCP 伺服器公開的特定資料環境或資料集，代理可存取這些資料，以提供回覆或採取行動。
探索
根據說明、標記或技能查詢登錄資料，找出現有代理程式或 MCP 工具。如果代理透過代理資訊卡公開功能 (例如實作 Agent2Agent (A2A) 通訊協定的代理)，就能透過技能探索功能。
端點
對於 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
註冊
將代理程式元件新增至登錄檔的程序。代理程式登錄提供下列登錄機制：
- 自動註冊：自動擷取支援的工作負載，例如 Vertex AI Agent Engine 中的工作負載。 Google Cloud
- 手動註冊：手動導入自訂或外部工作負載。
資源 URI
主機的實體執行階段位置或基礎架構，用於代管代理程式或 MCP 伺服器。統一資源識別碼 (URI) 是用來識別這個執行階段資源的專屬字元序列。舉例來說，資源 URI 可以是 Vertex AI 端點、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 伺服器提供的確定性函式，代理可以叫用。