註冊代理程式

註冊代理程式後,代理程式就會成為 Agent Registry 中可供探索的元件。發布代理程式的 A2A 技能,可協助貴機構的其他開發人員和協調器代理程式尋找及重複使用您的工作,加速整體 AI 開發作業。

Agent Registry 可與 Agent2Agent (A2A) 通訊協定及其規格完美整合。A2A 是開放標準,可讓代理聲明自身功能和身分。Agent Registry 支援 A2A 規格的 0.31.0 版本。詳情請參閱「代理程式資訊卡結構定義」。

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

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

自動註冊

支援的 Google Cloud 執行階段會預設或透過選擇加入的部署步驟,在同一個專案中向 Agent Registry 註冊代理程式。自動註冊功能是在專案層級運作,不會自動探索部署在其他專案中的代理程式。 Google Cloud

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

  • Gemini Enterprise Agent Platform 的 Agent Runtime:使用 SDK 部署的代理會自動註冊,無須額外設定。
  • 內建 Google 代理:Google 直接提供的代理 (例如 Google Workspace 和 Gemini Enterprise 代理) 無須任何設定即可探索。
  • Google Kubernetes Engine:部署至 Google Kubernetes Engine (GKE) 的容器化代理程式,只要包含特定的 Agent Registry 功能類型標籤,就會完成註冊。

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

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

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

手動註冊

如果代理程式是託管在外部平台、地端部署、不支援自動探索的 Google Cloud執行階段,或位於不同Google Cloud 專案中,則必須手動註冊。

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

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

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

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

跨專案註冊注意事項

如果貴機構使用集中式控管架構和代理閘道,您可以在中央控管專案中部署「代理至任何位置」輸出閘道,並註冊部署在多個輻射或工作負載專案中的代理。

由於自動註冊只會探索本機專案中的資源,因此您必須在中央控管專案的登錄檔中手動註冊遠端代理程式。透過跨專案註冊,中央閘道可以找到並控管代理程式。如需操作說明,請參閱「從其他專案註冊代理程式」。

整合獨立技能

代理程式登錄可讓您管理及控管代理程式的獨立技能,做為頂層資源。獨立技能會註冊為登錄檔中的 Skill 資源,讓管理員套用精細的存取政策,並使用技能修訂版本管理版本記錄。

Gemini Enterprise 中建構及管理代理時,您可以參考這些已註冊的技能,擴充代理的功能。如要瞭解如何註冊及管理獨立技能,請參閱「註冊技能」和「管理技能」。