Agent Registry 可以探索及註冊託管於支援的Google Cloud 執行階段的代理，不必手動呼叫 Agent Registry API。視執行階段而定，這個註冊程序會自動進行，或是在部署期間需要執行選擇加入設定步驟。
本文說明如何在支援的執行階段中，為代理程式啟用探索功能。如果代理程式是外部代管或使用不支援的執行階段，請參閱「使用手動註冊」。
在代理程式註冊期間擷取的中繼資料和技能取決於代理程式的通訊協定。詳情請參閱「註冊代理程式」。
註冊 Vertex AI Agent Engine 的代理
如果您使用 Vertex AI Agent Engine 開發代理，並使用 Vertex AI SDK 部署代理，系統會自動在 Agent Registry 中註冊。
Agent2Agent (A2A) 通訊協定是開放標準，可讓代理聲明自身功能和身分。以下範例說明如何將實作 A2A 通訊協定的代理程式部署至 Vertex AI Agent Engine。詳情請參閱「部署代理程式」。
# Create and deploy the agent
# This action automatically registers the agent in Agent Registry
remote_agent = client.agent_engines.create(
agent=my_a2a_agent, # Your defined A2A object
config={
"display_name": "my-support-agent",
"description": "An agent that handles support tickets.",
"requirements": ["google-cloud-aiplatform[agent_engines,langchain]"],
},
)
在 Vertex AI Agent Engine 更新或刪除代理時，Agent Registry 會自動同步處理這些變更。
註冊內建的 Google 代理
系統會自動將內建的 Google 代理 (例如 Google Workspace 和 Gemini Enterprise 代理) 整合至代理程式登錄服務。您不需要執行任何設定或部署步驟。這些代理程式會擷取並在登錄檔中探索。
從 GKE 註冊代理
如要註冊部署在 Google Kubernetes Engine 的代理，請在部署作業中新增 apphub.cloud.google.com/functional-type: "AGENT" 註解。這項註解會將部署作業識別為 AI 代理程式，讓 Agent Registry 執行內省掃描。
以下範例顯示 GKE 代理程式部署資訊清單。詳情請參閱「部署及協調 AI 代理程式」。
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-agent
annotations:
# Identifies the workload as an AI agent
apphub.cloud.google.com/functional-type: "AGENT"
spec:
selector:
matchLabels:
app: my-agent
template:
metadata:
labels:
app: my-agent
spec:
containers:
- name: server
image: gcr.io/my-project/my-agent:1.0.0
套用部署作業後，GKE 叢集會自動嘗試從代理程式擷取中繼資料，並直接同步到 Agent Registry 資料模型。
驗證註冊
您可以列出代理程式，確認 Agent Registry 是否已成功註冊代理程式：
控制台
前往 Google Cloud 控制台的「Agent Registry」：
在專案選擇工具中，選取 Google Cloud 您設定 Agent Registry 的專案。
選取「代理人」分頁。
這個頁面會列出所有已註冊的代理程式及其詳細資料，例如名稱、ID、說明、執行階段和位置。
依據代理程式位置或執行階段資源篩選清單：
- 如要依地點篩選，請按一下「地點」選單，選取要篩選的地點，然後按一下「套用」。
- 如要依執行階段篩選，請點選「執行階段」選單，選取要篩選的執行階段，然後點選「套用」。
頁面會顯示已根據所選條件篩選的註冊代理人清單。
gcloud
如果您有多個代理程式，或想確認特定代理程式 (例如自動註冊的代理程式) 的註冊狀態，可以依代理程式的中繼資料篩選清單。
如要執行這項操作，請務必設定 Agent Registry 的 Google Cloud CLI 環境，然後執行下列指令：
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
更改下列內容：
PROJECT_ID：專案 ID。REGION：登錄檔區域。FILTER_EXPRESSION：要篩選的代理程式篩選運算式。舉例來說，如要依顯示名稱篩選，可以使用displayName='DISPLAY_NAME'。如要依全球不重複的識別碼 (URN) 篩選，可以使用agentId='urn:agent:AGENT_URN'。
內建 Google 服務使用的 URN 格式取決於代理程式的部署位置。舉例來說，您可以透過篩選清單中的 googleapis.com 發布者，找出內建的 Google Workspace 代理程式。篩選方式如下：--filter="agentId:'urn:agent:googleapis.com:*'"