Agent Registry 数据模型

Agent Registry 将生态系统的智能体组件分为四种主要资源类型，您可以管理和发现这些资源类型：

  • 智能体：可执行特定 AI 工作流的自主 AI 执行者。智能体通过具备特定的技能来了解其工作流功能。 在 Agent Registry 中，代理技能表示为声明性元数据（A2A 技能）或模块化可执行软件包（技能）。
  • MCP 服务器：标准化数据资源和工具的提供方。工具是 MCP 服务器公开的确定性函数，代理可以调用这些函数来执行特定操作。
  • 端点：代理访问的目标网址（通常为 REST API）。通过将这些目的地抽象为可管理的资源，Agent Registry 可让您集中管理代理可以访问哪些外部 API。
  • 技能：可执行的独立指令、代码和元数据包，直接在 Agent Registry 中进行管理。独立技能不同于 A2A 技能，后者是声明性元数据块清单，在智能体的智能体卡片中以内嵌方式声明。

如需详细了解 Agent Registry 使用的这些概念及其他概念，请参阅主要概念。

API 资源

代理注册表 API 将代理、端点和 MCP 服务器的读取和写入操作分开：

  • 可写入的 API 资源：您可以通过在注册表中手动创建、更新或删除 Service 资源来管理这些代理组件。
  • 只读 API 资源：如需查询、列出或搜索这些代理组件，您可以向 Agent Registry API 请求只读 Agent、McpServer 或 Endpoint 资源。

独立技能不使用 Service 投影模型。您可以使用 Skill、SkillRevision 和 Publisher API 资源直接管理技能、控制技能版本并列出技能。

如需开始使用，请参阅设置 Agent Registry。如需详细了解 Agent Registry API，请参阅 API 参考文档。

在注册表中注册 agentic 组件

Agent Registry 通过两种注册机制（自动和手动）维护代理和 MCP 服务器目录。

Agent Registry 会自动注册部署在受支持的 Google Cloud 运行时上的代理和服务器。通过启用 Agent Registry API 来注册和管理代理、MCP 服务器和端点。设置 Agent Registry 后，您还可以立即看到 Google 创建的技能。

此外，您还可以使用 Service 资源手动创建、更新和删除条目。然后，您可以查询只读的 Agent、McpServer 或 Endpoint 资源，以分别获取、列出和搜索已注册的代理、服务器和端点。如需手动注册和搜索技能，请使用 Skill 资源。

注册机制 说明 已注册的组件 支持的 Google Cloud 产品
自动注册 您可以配置和使用 Agent Registry，以自动发现和注入部署在受支持的 Google Cloud 运行时上的特定资源。对于实现开放式 Agent2Agent (A2A) 协议的代理，注册中心还会自动从其代理卡片中提取 A2A 技能和功能。 代理
MCP 服务器 官方 Google 和 Google Cloud 远程 MCP 服务器
技能 Google 的公开技能可供所有项目在全球范围内发现
手动注册 对于外部资源、不支持的运行时上的自定义代理组件，或者未实现 A2A 协议的标准 REST 代理，您必须通过在注册表中创建 Service 资源来手动注册它们。 对于独立技能，您可以使用 Skill 资源。 代理 远程代理
MCP 服务器 在不受支持的运行时或外部 MCP 服务器上使用自定义智能体组件
技能 您自己的独立技能

后续步骤