Skill Registry 是一个安全、私密且低延迟的代码库，用于管理智能体技能。每项技能都是一个独立的软件包，包含结构化指令、可执行代码和文档，旨在扩展代理的功能。
通过集中管理这些技能，技能注册表使智能体能够根据用户意图动态发现和加载最相关的功能，从而优化性能并确保安全的执行环境。
主要概念
技能注册表引入了两个顶级标准 API 实体，用于管理生命周期和版本控制：
| 概念 | 说明 |
|---|---|
| 技能 |
一个可变的顶级实体，包含元数据（例如显示名称、创建和更新时间戳以及标签）、默认修订版本和技能内容。
如需查看预期技能结构的示例，请参阅 Google Cloud 技能代码库中的 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 front matter 中的名称字段缺失、超过 64 个字符、以连字符开头或结尾，或者包含小写字母、数字和连字符以外的字符。
- YAML 前置元数据中的说明字段缺失或超过 1024 个字符。
- YAML front matter 中的 license 字段超过了 1024 个字符。
SKILL.md文件中的指令超过了 500,000 个字符。
- ZIP 归档文件的大小超过 10 MB。
内置 skill
Skill Registry 包含一个内置 gcp-skill-registry skill。此技能使代理能够与技能注册表进行交互，以创建、搜索和管理可用技能，从而使代理能够注册新功能或发现现有功能。Google 负责管理此内置技能的生命周期、发布和版本控制，确保其开箱即用。