Skill Registry 是安全、私密且低延遲的存放區，可管理代理技能。每個技能都是獨立套件，包含結構指令、可執行的程式碼和說明文件，用於擴展代理程式的功能。
集中管理這些技能後，技能登錄檔可讓代理程式根據使用者意圖，動態探索及載入最相關的功能，進而提升效能並確保執行環境安全無虞。
基本概念
技能登錄服務推出兩個頂層標準 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 前置事項中的名稱欄位遺漏、超過 64 個字元、開頭或結尾為連字號，或包含小寫英文字母、數字和連字號以外的字元。
- YAML front matter 缺少說明欄位，或說明長度超過 1,024 個半形字元。
- YAML 前置事項中的授權欄位超過 1024 個半形字元。
SKILL.md檔案中的指令超過 500,000 個字元。
- 壓縮封存檔大小超過 10 MB。
內建技能
技能登錄檔內含內建的 gcp-skill-registry 技能。這項技能可讓代理程式與技能登錄檔互動，藉此建立、搜尋及管理可用技能，進而註冊新功能或探索現有功能。Google 會管理這項內建技能的生命週期、發布和版本管理，確保開箱即用。