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