註冊代理程式後,代理程式就會成為 Agent Registry 中可探索的元件。發布代理程式的技能,可協助貴機構的其他開發人員和協調器代理程式尋找及重複使用您的工作,加速整體 AI 開發作業。
視代理程式執行階段而定,Agent Registry 支援兩種主要註冊機制:自動註冊和手動註冊。
這份文件可協助您選擇適合代理程式執行階段的註冊機制。
自動註冊
支援的 Google Cloud 執行階段會預設或透過選擇加入的部署步驟,向 Agent Registry 註冊代理。
下列 Google Cloud 執行階段支援自動註冊:
- Gemini Enterprise Agent Platform 的 Agent Runtime:使用 SDK 部署的代理程式會自動註冊,無須額外設定。
- 內建 Google 代理:Google 直接提供的代理 (例如 Google Workspace 和 Gemini Enterprise 代理) 無須任何設定即可探索。
- Google Kubernetes Engine:部署至 Google Kubernetes Engine (GKE) 的容器化代理程式,會在包含特定代理程式登錄功能類型註解時註冊。
註冊代理時擷取的中繼資料和技能取決於代理的通訊協定:
- 導入 Agent2Agent (A2A) 通訊協定的代理: A2A 是一項開放標準,可讓代理聲明自身功能和身分。如果代理程式實作這項通訊協定,代理程式登錄服務會自動從代理程式卡片擷取代理程式的技能,並填入登錄服務。
- 未實作 A2A 通訊協定的 Agent:Agent Registry 會註冊 Agent,但無法自動擷取推論網址和技能等中繼資料。如要提供這項資訊,讓服務專員可供搜尋,請使用手動註冊。
如要瞭解支援自動註冊的 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 端點。
如要瞭解如何手動註冊代理程式,請參閱「使用手動註冊」。