Skill Registry は、エージェントのスキルを管理するための安全でプライベートな低レイテンシのリポジトリとして機能します。各スキルは、エージェントの機能を拡張するように設計された、構造的な手順、実行可能コード、ドキュメントを含む自己完結型のパッケージです。
これらのスキルを一元管理することで、Skill Registry は、ユーザーの意図に基づいて最も関連性の高い機能を動的に検出して読み込むことができるため、パフォーマンスを最適化し、安全な実行環境を確保できます。
主なコンセプト
Skill Registry では、ライフサイクルとバージョン管理を行うために、2 つのトップレベルの標準 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 フロントマターの license フィールドが 1,024 文字を超えています。
SKILL.mdファイルの手順が 500,000 文字を超えています。
- ZIP 形式のアーカイブのサイズが 10 MB を超えている。
組み込みスキル
Skill Registry には、組み込みの gcp-skill-registry スキルが含まれています。このスキルにより、エージェントはスキル レジストリを操作して、利用可能なスキルを作成、検索、管理できます。これにより、新しい機能を登録したり、既存の機能を見つけたりできます。Google は、この組み込みスキルのライフサイクル、リリース、バージョニングを管理し、すぐに使える機能を提供します。