Agent Registry 會將 AI 生態系統整理成標準化資源，方便您註冊、探索及管理代理、MCP 伺服器、端點和技能。瞭解 Agent Registry 如何區分可寫入的 Service 資源和唯讀的探索資源，以及哪些產品支援自動和手動註冊，有助於設計及管理註冊資料庫。
代理元件
您可以使用 Agent Registry 註冊、探索及管理下列類型的代理元件：
- 代理：自主 AI 執行者，可執行特定工作、叫用工具，並與其他代理協作。
- MCP 伺服器：實作 Model Context Protocol (MCP) 的程式，用於公開標準化資料資源和工具。工具是 MCP 伺服器公開的確定性函式，代理可叫用這些函式來執行特定動作。
- 端點：代理存取的目標網址，通常是 REST API。Agent Registry 會將這些目的地抽象化為可管理的資源，讓您集中控管代理可存取的外部 API。
- 技能：模組化功能，可擴充代理的能力。獨立技能是指令和選用指令碼的套件，直接在註冊資料庫中管理。A2A 技能是代理資訊卡上的能力說明，可讓其他代理瞭解何時及如何與該代理通訊。詳情請參閱「技能架構」。
服務資源和探索資源
Agent Registry 如何呈現元件，取決於元件類型和註冊模型。如要進一步瞭解元件生命週期和探索，請參閱「元件生命週期和探索」。
代理、MCP 伺服器和端點
無論代理、MCP 伺服器或端點是自動或手動註冊，Agent Registry 都會將其表示為唯讀的 Agent、McpServer 或 Endpoint 探索資源。消費者 (例如：自動調度管理代理、用戶端應用程式和開發人員) 會使用這些探索資源，列出、搜尋及查看已註冊的元件。
如果是自動註冊的元件，Agent Registry 會直接從支援的執行階段擷取中繼資料，並建立探索資源，不需 Service 資源。
手動註冊代理、MCP 伺服器或端點時，Agent Registry 會建立下列項目，將管理作業與元件探索作業分開：
- 可寫入的
Service資源：儲存元件的中繼資料，包括代理元件類型、介面網址、說明、通訊協定繫結和功能規格。您可以建立、更新或刪除Service資源，以便執行管理作業，例如更新中繼資料或取消註冊元件，而不必修改或刪除基礎部署作業。 - 探索資源：建立或更新
Service資源時，Agent Registry 會讀取中繼資料，並自動建立或更新Agent、McpServer或Endpoint探索資源，代表登錄檔中的元件。
建立 Service 資源時使用的規格旗標，會決定產生的唯讀資源集合：
| 旗標 | 資源收集 | 用途 | 有效值 |
|---|---|---|---|
--agent-spec-type--agent-spec-content |
agents 集合中的 Agent 項資源 |
遠端 A2A 相容或標準 REST 代理 | a2a-agent-card、no-spec |
--endpoint-spec-type--endpoint-spec-content |
endpoints 集合中的 Endpoint 項資源 |
外部目標 REST API 或服務網址 | no-spec |
--mcp-server-spec-type--mcp-server-spec-content |
mcp-servers 集合中的 McpServer 項資源 |
外部 Model Context Protocol (MCP) 伺服器 | tool-spec、no-spec |
這些旗標組合互斥，如果指定多個組合的旗標，系統會傳回錯誤。如果為錯誤的元件類型指定旗標組合，代理程式註冊資料庫會在與指定旗標相符的集合中建立探索資源。舉例來說，註冊端點時傳遞 --agent-spec-type=no-spec 會建立 Agent 資源，而非 Endpoint 資源，因此特定類型的查詢和管理政策不會如預期套用。
獨立技能
獨立技能不會使用個別的 Service 資源。而是直接使用頂層 Skill 資源、子項 SkillRevision 資源和 Publisher 資源，註冊、建立版本及查詢技能。
如要開始使用，請參閱「設定代理程式登錄檔」。如要進一步瞭解 Agent Registry API，請參閱 API 參考文件。
支援的產品和元件
代理程式註冊資料庫會依註冊方式 (自動或手動)，將支援的產品和元件分類。
自動註冊
Agent Registry 會自動探索並擷取專案中部署的支援Google Cloud 工作負載。如果代理採用開放式 Agent2Agent (A2A) 通訊協定，登錄檔會自動從代理資訊卡擷取 A2A 技能和功能。設定代理登錄檔時，您也可以在所有專案中找到 Google 代管的獨立技能。
下表列出代理程式註冊資料庫會自動註冊的產品和元件：
| 元件類型 | 支援的產品 |
|---|---|
| 代理 |
|
| MCP 伺服器 |
|
| 技能 | Google 代管技能可從所有專案中找到 |
手動註冊
如果是「遠端」元件，也就是託管於管理專案外部 (位於獨立 Google Cloud 專案、地端部署基礎架構或外部雲端) 的代理、MCP 伺服器或端點，您必須使用 Service 資源，在管理專案中手動註冊元件。您也可以使用 Service 資源，在不支援的執行階段或未實作 A2A 通訊協定的代理上手動註冊元件。如要建立自訂獨立技能，請使用 Skill 資源。
下表列出您手動註冊的產品和元件：
| 元件類型 | 支援的資源 |
|---|---|
| 代理 | 部署於 Compute Engine、GKE、Cloud Run、地端部署系統或外部雲端的 遠端代理 |
| MCP 伺服器 | 在不支援的執行階段或外部 MCP 伺服器上，使用自訂代理元件 |
| 端點 | 做為端點管理的外部目標 REST API 或服務網址 |
| 技能 | 貴組織編寫的獨立技能 |