Agent Registry 会将生态系统的智能体组件分为四种主要资源类型，您可以管理和发现这些资源类型：
- 智能体：自主 AI 执行者，可执行特定任务、调用工具并与其他智能体协作。
- MCP 服务器：标准化数据资源和工具的提供方。工具是 MCP 服务器公开的确定性函数，代理可以调用这些函数来执行特定操作。
- 端点：代理访问的目标网址（通常是 REST API）。通过将这些目的地抽象为可管理的资源，Agent Registry 可让您集中管理代理可以访问哪些外部 API。
- 技能：可扩展智能体功能的模块化能力。智能体注册中心区分独立技能（直接在注册中心管理的指令和可选脚本的软件包）和 A2A 技能（列在智能体卡片上的能力说明，用于告知其他智能体何时以及如何与该智能体通信）。
如需详细了解代理注册服务使用的这些概念及其他概念，请参阅关键概念。
API 资源
代理注册表 API 将代理、端点和 MCP 服务器的读取和写入操作分开：
- 可写入的 API 资源：您可以通过在注册表中手动创建、更新或删除
Service资源来管理这些代理组件。 - 只读 API 资源：如需查询、列出或搜索这些代理组件，您需要向 Agent Registry API 请求只读
Agent、McpServer或Endpoint资源。
您在创建 Service 时使用的规范标志决定了生成的只读资源集合：
| 标志 | 资源集合 | 使用场景 | 有效值 |
|---|---|---|---|
--agent-spec-type--agent-spec-content |
Agent (agents) |
远程代理（符合 A2A 标准或标准 REST 代理） | a2a-agent-card，no-spec |
--endpoint-spec-type--endpoint-spec-content |
Endpoint (endpoints) |
外部目标 REST API 或服务网址 | no-spec |
--mcp-server-spec-type--mcp-server-spec-content |
McpServer (mcp-servers) |
外部 Model Context Protocol (MCP) 服务器 | tool-spec |
这些标志对是互斥的。如果您指定了无效标志，系统会在错误的集合中创建资源，并且该资源可能无法与特定于类型的政策搭配使用。
独立技能不使用 Service 投影模型。您可以使用 Skill、SkillRevision 和 Publisher API 资源直接管理技能、控制技能版本并列出技能。
如需开始使用，请参阅设置代理注册表。如需详细了解 Agent Registry API，请参阅 API 参考文档。
支持的产品和组件
代理注册表会根据受支持的产品和组件的注册方式（自动或手动）对其进行分类。
自动注册
代理注册表会自动发现并提取项目中部署的受支持Google Cloud 工作负载。对于实现开放式 Agent2Agent (A2A) 协议的代理，注册中心会自动从其代理卡片中提取其 A2A 技能和功能。 设置代理注册表后，Google 创建的独立技能也可在全球范围内被发现。
下表列出了代理注册服务自动注册的产品和组件：
| 组件类型 | 支持的产品 |
|---|---|
| 代理 |
|
| MCP 服务器 |
|
| skill | Google 的公开技能可供所有项目在全球范围内发现 |
手动注册
对于自定义工作负载、外部 Cloud Runtime、本地基础架构或未实现 A2A protocol 的代理，您可以使用可写入的 Service 资源手动注册组件。对于自定义独立技能，您可以使用 Skill 资源。
下表列出了您手动注册的产品和组件：
| 组件类型 | 支持的资源 |
|---|---|
| 代理 | 部署在 Compute Engine、Google Kubernetes Engine、Cloud Run、本地系统或外部云平台上的 远程代理 |
| MCP 服务器 | 在不受支持的运行时或外部 MCP 服务器上运行的自定义智能体组件 |
| Endpoints | 作为端点管理的外部目标 REST API 或服务网址 |
| skill | 由您的组织编写的自有独立技能 |