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 會透過管理專案，集中探索及控管所有成員專案。
當您從管理專案查詢、列出或搜尋資源時，代理程式註冊資料庫會套用下列範圍規則，提供整合目錄，不會重複資源或造成端點衝突：
| 資源類別 | 管理邊界內的範圍 | 說明 |
|---|---|---|
| 自動探索的資源 | 從成員專案匯總 | 在管理專案的某個位置列出或搜尋代理和 MCP 伺服器時，系統會自動探索成員專案中的代理和 MCP 伺服器，並匯總至管理專案檢視畫面。查看、列出或搜尋代理或 MCP 伺服器時，您可以在要求中指定管理專案 ID 或成員專案 ID。資源名稱會保留 Agent Registry 指派給元件的 ID，並使用要求中指定的專案。 |
| 手動註冊的資源 | 範圍限定在建立這些資源的專案 | 自訂代理、外部 MCP 伺服器和手動註冊為 Service 資源的端點，其範圍僅限於建立這些資源的專案。在管理專案中建立，即可在管理邊界內查看；在成員專案中建立，則只能在該專案中查看。 |
| 繫結 | 範圍限定在建立這些資源的專案 | Binding 資源的範圍限定在建立資源的專案。如要查看整個邊界，請在管理專案中建立。如要查看單一專案，請在成員專案中建立。 |
| 獨立技能和發布商 | 範圍限定在建立這些資源的專案 | 自訂獨立 Skill、SkillRevision 和 Publisher 資源的範圍限定在建立這些資源的專案，不會從成員專案匯總至管理專案。設定代理程式登錄檔時，系統會自動在所有專案中，顯示 Google 代管的獨立技能。 |
| AI 應用程式 | 範圍限定在建立這些資源的專案 | 唯讀 AiApplication 資源及其連結的元件檢視畫面，範圍限定在建立應用程式的專案和位置。 |
支援的產品和元件
代理程式註冊資料庫會依註冊方式 (自動或手動)，將支援的產品和元件分類。
自動註冊
Agent Registry 會自動探索及擷取部署在專案中，或管理範圍內成員專案中的支援Google Cloud 工作負載。如果代理採用開放式 Agent2Agent (A2A) 通訊協定，登錄檔會自動從代理資訊卡擷取 A2A 技能和功能。設定 Agent Registry 後，您也可以在所有專案中找到 Google 代管的獨立技能。
下表列出代理程式註冊資料庫會自動註冊的產品和元件：
| 元件類型 | 支援的產品 |
|---|---|
| 代理 |
|
| MCP 伺服器 |
|
| 技能 | Google 代管技能可從所有專案中找到 |
手動註冊
遠端元件是指託管在管理專案或管理邊界外部的代理、MCP 伺服器或端點，例如託管在沒有邊界的獨立 Google Cloud 專案、地端部署基礎架構或外部雲端。您可以使用 Service 資源，在管理專案中手動註冊這些遠端元件。您也可以使用 Service 資源，在不支援的執行階段上手動註冊元件，或為未實作 A2A 通訊協定的代理註冊元件。如要自訂獨立技能，請使用 Skill 資源。
下表列出您手動註冊的產品和元件：
| 元件類型 | 支援的資源 |
|---|---|
| 代理 | 部署於 Compute Engine、GKE、Cloud Run、地端部署系統或外部雲端的 遠端代理 |
| MCP 伺服器 | 在不支援的執行階段或外部 MCP 伺服器上，使用自訂代理元件 |
| 端點 | 做為端點管理的外部目標 REST API 或服務網址 |
| 技能 | 貴組織編寫的獨立技能 |
後續步驟
- 瞭解身分和 ID。
- 瞭解元件生命週期和探索。
- 瞭解跨專案邊界。
- 瞭解技能架構。
- 設定 Agent Registry。