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