註冊代理程式

註冊代理程式後,代理程式就會成為 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 部署的代理會自動註冊,無須額外設定。詳情請參閱「從 Agent Runtime 註冊代理程式」。
  • 內建 Google 代理:Google 直接提供的代理 (例如 Google Workspace 和 Gemini Enterprise 代理) 無須任何設定即可探索。詳情請參閱「註冊內建 Google 代理程式」。
  • Google Kubernetes Engine:部署至 Google Kubernetes Engine (GKE) 的容器化代理程式,會在設定 AI 代理程式功能類型標籤和代理程式資訊卡註解時註冊。GKE 叢集執行階段控制器會執行內省掃描,並將中繼資料發布至 Agent Registry。詳情請參閱「從 GKE 註冊代理程式」。
  • Cloud Run:部署至 Cloud Run 服務或工作的容器化代理程式,會在以功能和身分類型標記部署時註冊。Cloud Run 會自動向 Agent Registry 註冊代理程式的名稱、網址和類型 (AGENT)。詳情請參閱「從 Cloud Run 註冊代理程式」。

註冊期間為代理程式建立索引的後設資料和功能,取決於代理程式是否實作 Agent2Agent (A2A) 通訊協定:

  • 實作 A2A 通訊協定的代理:系統會查詢代理的代理資訊卡 (/.well-known/agent-card.json),自動將其宣傳的 A2A 技能和能力擷取到登錄目錄中。
  • 未實作 A2A 通訊協定的代理程式 (標準 REST 或 gRPC 端點): 系統會註冊代理程式的介面網址和傳輸繫結,但無法自動擷取語意功能。如要將功能與非 A2A 端點建立關聯,可以使用手動註冊功能描述這些功能,或將功能連結至 AI 應用程式中的獨立技能和 MCP 伺服器。

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

手動註冊

如果代理程式是託管在外部平台、地端部署、不支援自動探索的執行階段,或位於不同專案中,則必須手動註冊。 Google CloudGoogle 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 中建構及管理代理時,您可以參考這些已註冊的技能,擴充代理的功能。如要瞭解如何註冊及管理獨立技能,請參閱「註冊技能」和「管理技能」。