注册代理

注册代理会将其转换为可发现的服务。通过发布代理的技能，您可以帮助组织中的其他开发者和编排器代理找到并重复使用您的工作，从而加快整体 AI 开发速度。

根据代理运行时，Agent Registry 支持两种主要注册机制：自动注册和手动注册。

本文档可帮助您选择适合代理运行时的注册机制。

自动注册

受支持的 Google Cloud 运行时默认或通过选择性部署步骤向 Agent Registry 注册代理。

以下运行时支持自动注册： Google Cloud

Vertex AI Agent Engine：使用 SDK 部署的代理无需进行额外配置即可注册。
内置 Google 代理：Google 直接提供的代理（例如 Google Workspace 和 Gemini Enterprise 代理）无需任何配置即可被发现。
Google Kubernetes Engine：部署到 GKE 的容器化代理在包含特定的 Agent Registry 功能类型注解时注册。

在注册期间捕获的代理的元数据和技能取决于代理的协议：

实现 Agent2Agent (A2A) 协议的代理： A2A 是一种开放标准，可让代理声明其功能和身份。如果您的代理实现了此协议，Agent Registry 会自动从代理的代理技能中提取代理的技能，并填充注册表。
未实现 A2A protocol 的代理：Agent Registry 会注册代理，但无法自动捕获推理网址和技能等元数据。如需提供此信息以使您的代理可被发现，请使用手动注册。

如需了解支持自动注册的 Google Cloud 运行时，请参阅使用自动注册。

对于托管在外部平台、本地或 Google Cloud 不支持自动发现的运行时上的代理，您必须使用手动注册。

如需手动注册代理，您可以使用 Agent Registry API 创建一个 Service 资源，用于定义代理的端点和配置。此可写资源还包含代理的具体详细信息。创建 Service 后，注册表会生成一个只读 Agent 资源，您可以使用该资源进行发现。

您可以手动注册两种类型的代理：

符合 A2A 标准的代理：实现 Agent2Agent (A2A) 规范 (A2A_AGENT_CARD) 的代理。注册表会扫描其代理卡片 (agent-card.json) 端点，以对其技能编制索引。
标准 REST 代理：未实现 A2A 规范 (NO_SPEC) 的远程代理，例如标准 REST API 端点。

如需了解如何手动注册代理，请参阅使用手动注册。