如果您使用 Agent Development Kit (ADK) 建構自訂代理，並將其託管在自己的基礎架構上，可以公開 Agent Card 並手動註冊端點，讓代理在 Agent Registry 中可供探索。
這份文件說明如何確保 ADK 代理符合 Agent2Agent (A2A) 通訊協定，讓登錄檔為其技能建立索引。
Agent Card 端點
如要讓 Agent Registry 瞭解自訂代理的功能，代理必須使用 Agent2Agent (A2A) 通訊協定公開其元資料和可用技能。
根據 A2A 規格，代理必須在特定端點 (通常是 /.well-known/agent-card.json) 提供代理資訊卡，也就是說明代理身分和工具的 JSON 文件。
使用 ADK 的特定 A2A 伺服器外掛程式或模組註冊代理程式時，架構會根據您在程式碼中提供的 Agent 定義和 tools，自動產生並提供這個代理程式資訊卡。
註冊公開的代理程式
將 ADK 代理部署至代管環境，並成功提供 REST 端點後，請指示 Agent Registry 探索該代理。
由於自訂部署需要手動註冊，因此您會在登錄檔中建立 Service 資源。將產生的代理程式卡片儲存為本機 JSON 檔案，例如 agent-card.json。
使用 Google Cloud CLI 註冊代理程式，請務必指定 a2a-agent-card 規格類型，並使用 --agent-spec-content 旗標上傳本機檔案：
gcloud agent-registry services create AGENT_NAME \
--project=PROJECT_ID \
--location=LOCATION \
--display-name="DISPLAY_NAME" \
--agent-spec-type=a2a-agent-card \
--agent-spec-content=agent-card.json
規格檔案大小上限為 10 KB。
更改下列內容：
AGENT_NAME：您要為代理程式指定的名稱，例如my-custom-agent。PROJECT_ID：專案 ID。LOCATION：註冊資料庫位置或區域。DISPLAY_NAME：代理程式的名稱，方便使用者辨識。
建立 Service 資源後，代理程式登錄會剖析代理程式資訊卡、建立可探索的 Agent 資源，並為 ADK Python 程式碼中定義的技能建立索引，方便其他開發人員搜尋。