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 フロントマターの description フィールドがないか、1,024 文字を超えています。
- YAML フロントマターの license フィールドが 1,024 文字を超えています。
SKILL.mdファイルの手順が 500,000 文字を超えています。
- ZIP 形式のアーカイブのサイズが 10 MB を超えています。
組み込みスキル
Skill Registry には、組み込みの gcp-skill-registry スキルが含まれています。このスキルにより、エージェントはスキル レジストリを操作して、利用可能なスキルを作成、検索、管理できます。これにより、新しい機能を登録したり、既存の機能を見つけたりできます。Google は、この組み込みスキルのライフサイクル、リリース、バージョニングを管理し、すぐに利用できる機能を提供します。