Skill Registry は、エージェント スキルを管理するための安全でプライベートな低レイテンシのリポジトリとして機能します。各スキルは、エージェントの機能を拡張するように設計された、構造的な手順、実行可能コード、ドキュメントを含む自己完結型のパッケージです。
これらのスキルを一元化することで、Skill Registry は、ユーザーの意図に基づいて最も関連性の高い機能をエージェントが動的に検出して読み込めるようにし、パフォーマンスを最適化して安全な実行環境を確保します。
主なコンセプト
Skill Registry には、ライフサイクルとバージョニングを管理するための 2 つのトップレベルの標準 API エンティティが用意されています。
| コンセプト | 説明 |
|---|---|
| スキル |
メタデータ（表示名、
作成タイムスタンプと更新タイムスタンプ、ラベルなど）、デフォルトのリビジョン、
スキルのコンテンツを含む、変更可能なトップレベル エンティティ。
想定されるスキル構造の例については、 SKILL.md ファイルを Google Cloud Skills リポジトリでご覧ください。
|
| スキル リビジョン | 特定のスキル バージョンの不変のスナップショット。名前、説明、親スキルリソースへの不変の参照が含まれます。 |
スキル ペイロードの検証
エージェントが有効なスキル コンテンツを使用できるようにするため、システムは作成時または更新時にすべてのスキル ペイロードを自動的に検証します。これらの検証は非同期で実行されます。
システムが次のいずれかを検出した場合、非同期オペレーションは検証エラーで失敗します。
- ファイルが適切な 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 文字を超えている。
- 圧縮されたアーカイブのサイズが 10 MB を超えている。
組み込みスキル
Skill Registry には、組み込みの gcp-skill-registry
スキルが含まれています。このスキルを使用すると、エージェントは Skill Registry
とやり取りして、利用可能なスキルを作成、検索、管理できます。これにより、新しい機能を登録したり、既存の機能を見つけたりできます。Google
は、この組み込みスキルのライフサイクル、リリース、バージョニングを管理し、すぐに使用できる機能を提供します。