註冊代理程式

註冊代理程式後，代理程式就會變成可探索的服務。發布代理程式的技能，可協助貴機構的其他開發人員和協調器代理程式尋找及重複使用您的工作，進而加速整體 AI 開發作業。

視代理程式執行階段而定，Agent Registry 支援兩種主要註冊機制：自動註冊和手動註冊。

這份文件可協助您選擇適合代理程式執行階段的註冊機制。

自動註冊

支援的 Google Cloud 執行階段會預設或透過選擇加入的部署步驟，向 Agent Registry 註冊代理。

下列 Google Cloud 執行階段支援自動註冊：

Vertex AI Agent Engine：使用 SDK 部署的代理程式會自動註冊，不需額外設定。
內建 Google 代理：Google 直接提供的代理，例如 Google Workspace 和 Gemini Enterprise 代理，無需任何設定即可探索。
Google Kubernetes Engine：部署至 GKE 的容器化代理程式包含特定代理程式登錄功能類型註解時，就會註冊。

代理程式註冊期間擷取的中繼資料和技能取決於代理程式的通訊協定：

實作 Agent2Agent (A2A) 通訊協定的代理程式： A2A 是一項開放標準，可讓代理程式聲明自身的能力和身分。如果代理程式實作這項通訊協定，代理程式登錄服務會自動從代理程式資訊卡擷取代理程式的技能，並填入登錄服務。
未實作 A2A 通訊協定的代理程式：Agent Registry 會註冊代理程式，但無法自動擷取推論網址和技能等中繼資料。如要提供這項資訊，讓服務專員可供搜尋，請使用手動註冊。

如要瞭解支援自動註冊的 Google Cloud 執行階段，請參閱「使用自動註冊」。

如果代理程式託管於外部平台、地端部署或不支援自動探索的 Google Cloud執行階段，則必須使用手動註冊。

如要手動註冊代理程式，請使用 Agent Registry API 建立 Service 資源，定義代理程式的端點和設定。這個可寫入的資源也包含代理商的具體詳細資料。建立 Service 後，登錄檔會產生唯讀的 Agent 資源，可用於探索。

您可以手動註冊兩種類型的代理程式：

符合 A2A 規範的代理：實作 Agent2Agent (A2A) 規格 (A2A_AGENT_CARD) 的代理。登錄程序會掃描其代理資訊卡 (agent-card.json) 端點，為其技能建立索引。
標準 REST 代理程式：未實作 A2A 規格 (NO_SPEC) 的遠端代理程式，例如標準 REST API 端點。

如要瞭解如何手動註冊代理程式，請參閱「使用手動註冊」。