Agent Registry 可以注册托管在受支持的 Google Cloud 运行时上的代理 ，而无需您手动调用 Agent Registry API。根据运行时，此注册过程会自动进行，或者需要在部署期间执行选择启用配置步骤。
本文档介绍了如何为受支持的运行时上的代理启用发现功能。如果您在外部或不受支持的运行时上托管代理， 请参阅使用手动注册。
在注册期间从代理提取的元数据和技能取决于代理的协议。如需了解详情，请参阅 注册代理。
从 Agent Runtime 注册代理
如果您在 Gemini Enterprise Agent Platform 上使用 Agent Runtime开发和部署代理， 则 Agent Registry 中的注册是自动进行的。
Agent2Agent (A2A) 协议是一种开放 标准，可让代理声明其功能和身份。以下 示例展示了如何将实现 A2A 协议的 代理 部署到 Agent Runtime。如需了解详情，请参阅 部署代理。
# 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]"],
},
)
当您在 Agent Runtime 中更新或删除代理时，Agent Registry 会自动同步这些更改。
注册内置 Google 代理
内置 Google 代理（例如 Google Workspace 和 Gemini Enterprise 代理）会自动注册到 Agent Registry。您无需执行任何配置或部署步骤。这些代理会被提取，并可在您的注册表中被发现。
从 GKE 注册代理
您可以通过将 apphub.cloud.google.com/functional-type: "AGENT"
注解添加到部署中，来注册部署在
Google Kubernetes Engine (GKE)
上的代理。此注解会将部署标识为 AI 智能体，让 Agent Registry 执行内省扫描。
以下示例展示了 GKE 代理部署清单。如需了解详情，请参阅 部署和编排 AI 代理。
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-agent
annotations:
# Identifies the deployment 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：
在项目选择器中，选择您在其中 设置 Agent Registry的 Google Cloud 项目。
选择代理 标签页。
该页面会显示所有已注册代理的列表及其详细信息，例如名称、标识符、说明、运行时和位置。
按代理的位置或其运行时资源过滤列表：
- 如需按位置过滤，请点击位置 菜单，选择要过滤的位置，然后点击应用 。
- 如需按运行时过滤，请点击运行时 菜单，选择要过滤的运行时，然后点击应用 。
该页面会显示针对您所选条件的已注册代理的过滤列表。
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 格式，该格式取决于代理的部署位置。例如，您可以通过
使用
--filter="agentId:'urn:agent:googleapis.com:*'"按 googleapis.com 发布商过滤列表，以发现内置 Google Workspace 代理。