Skill Registry 是一个安全、私密且低延迟的存储库，用于管理智能体技能。每项技能都是一个独立的软件包，包括结构说明、可执行代码和文档，旨在扩展智能体的功能。
通过集中管理这些技能，Skill Registry 使智能体能够根据用户意图动态发现和加载最相关的功能，从而优化性能并确保安全的执行环境。
主要概念
Skill Registry 引入了两个顶级标准 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 前言中的名称字段缺失、超过 64 个字符、以连字符开头或结尾，或者包含小写字母、数字和连字符以外的字符。
- YAML 前言中的说明字段缺失或超过 1,024 个字符。
- YAML 前言中的许可字段超过 1,024 个字符。
SKILL.md文件中的说明超过 500,000 个字符。
- 压缩归档文件的大小超过 10 MB。
内置技能
Skill Registry 包含内置的 gcp-skill-registry 技能。借助此技能，智能体可以与 Skill Registry
互动，以创建、搜索和管理可用技能，从而注册新功能或发现现有功能。Google 管理此内置技能的生命周期、发布和版本控制，确保开箱即用的功能。