Skill Registry 是一个安全、私密且低延迟的仓库，用于管理智能体 skill。每个技能都是一个独立的软件包，包含结构化指令、可执行代码和文档，旨在扩展代理的功能。
通过集中管理这些技能，技能注册表可让代理根据用户意图动态发现并加载最相关的功能，从而优化性能并确保安全的执行环境。
主要概念
技能注册表引入了两个顶级标准 API 实体来管理生命周期和版本控制：
| 概念 | 说明 |
|---|---|
| 技能 |
包含元数据（例如显示名称、创建和更新时间戳以及标签）、默认修订版本和技能内容的可变顶级实体。
如需查看预期技能结构的示例，请参阅 Google Cloud Skills 代码库中的 SKILL.md 文件。
|
| 技能修订版本 | 特定技能版本的不可变快照。它包含名称、说明以及对父技能资源的不可变引用。 |
技能载荷验证
为确保代理可以使用有效的技能内容，系统会在创建或更新技能时自动验证所有技能载荷。这些验证以异步方式执行。
如果系统检测到以下任一情况，异步操作会因验证错误而失败：
- 相应文件不是有效的 ZIP 文件，或者缺少关键信息。
- 相应 ZIP 文件为空。
- 相应 ZIP 文件内包含的项超过 10,000 个。
- ZIP 中的文件或文件夹名称包含
..或以/或\\开头。 - 相应 ZIP 文件包含符号链接。
- zip 文件中存在重复的文件名或文件夹名称。
- 解压缩后，zip 文件中所有文件的总大小超过 500 MB。
- 文件压缩过度，压缩比超过 100。
- zip 文件中的文件夹深度超过 8 层。
- 相应 ZIP 文件不包含
SKILL.md文件。 SKILL.md文件存在以下问题：SKILL.md文件缺少必需的 YAML 前言或预期的 Markdown 内容。- YAML 前言中的“name”字段缺失、超过 64 个字符、以连字符开头或结尾，或者包含小写字母、数字和连字符以外的字符。
- YAML 前置元数据中的说明字段缺失或超过 1,024 个字符。
- YAML 前言中的许可字段超过 1024 个字符。
SKILL.md文件中的指令超过了 50 万个字符。
- 压缩归档文件的大小超过 10 MB。
内置技能
Skill Registry 包含内置的 gcp-skill-registry 技能。此技能可让代理与技能注册表互动，以创建、搜索和管理可用技能，从而使代理能够注册新功能或发现现有功能。Google 会管理此内置技能的生命周期、发布和版本控制，确保开箱即用的功能。