Agent Registry 将生态系统的代理组件分为四种主要资源类型,您可以管理和发现这些资源:
- 代理:执行特定 AI 工作流的自主 AI 参与者。代理通过拥有特定 技能来了解其工作流功能。 在 Agent Registry 中,代理技能以声明式元数据 (A2A 技能) 或模块化可执行 软件包 (技能) 的形式表示。
- MCP 服务器:标准化数据资源和 工具的提供商。工具是 MCP 服务器公开的确定性函数,代理可以调用这些函数来执行特定操作。
- 端点:代理访问的目标网址,通常是 REST API。通过将这些目标抽象为可管理的资源,Agent Registry 可让您集中管理代理可以访问哪些外部 API。
- 技能:直接在 Agent Registry 中管理的独立可执行指令、代码和 元数据软件包。独立技能与 A2A 技能不同,后者是在代理的代理 卡片中内联声明的声明式元数据块清单。
如需详细了解这些概念以及 Agent Registry 使用的其他概念, 请参阅主要概念。
API 资源
Agent Registry API 将代理、端点和 MCP 服务器的读取和写入操作分开:
- 可写 API 资源: 您可以通过在注册表中手动
创建、更新或删除
Service资源来管理这些代理组件。 - 只读 API 资源: 如需查询、列出或搜索这些代理组件,您可以向 Agent Registry API 请求只读
Agent、McpServer或Endpoint资源。
独立 技能 不使用 Service
投影模型。相反,您可以使用 Skill、SkillRevision 和 Publisher API 资源直接管理、版本控制和列出技能
。
如需开始使用,请参阅设置 Agent Registry。如需详细了解 Agent Registry API,请参阅 API 参考文档。
在注册表中注册代理组件
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 官方 MCP 服务器和 Google Cloud 远程 MCP 服务器 | ||
| 技能 | Google 的公共技能 可从所有项目中全局发现 | ||
| 手动注册 |
对于外部资源、不受支持的运行时上的自定义智能体组件或未实现 A2A protocol 的标准 REST 代理,您必须通过在注册数据库中创建 Service 资源来手动注册它们。对于独立技能,您可以使用 Skill 资源。
|
代理 | 远程代理 |
| MCP 服务器 | 不受支持的运行时上的自定义代理组件或外部 MCP 服务器 | ||
| 技能 | 您自己的独立技能 |
后续步骤
- 查看主要概念,熟悉 Agent Registry 中使用的基本术语。
- 设置 Agent Registry。
- 了解代理的 自动注册和手动注册之间的区别。