註冊代理程式

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

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

視代理程式執行階段而定,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) 的容器化代理程式,只要包含特定代理程式登錄功能類型註解,就會完成註冊。

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

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

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

手動註冊

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

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

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

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

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