Skill Registry 是安全、私密且低延遲的存放區,可管理代理程式技能。每項技能都是獨立的套件,包括結構化指令、可執行的程式碼和文件,旨在擴充代理程式的功能。
集中管理這些技能後,技能登錄服務可讓代理程式根據使用者意圖,動態探索及載入最相關的功能,進而提升效能並確保執行環境安全無虞。
基本概念
技能登錄服務推出兩個頂層標準 API 實體,可管理生命週期和版本管理:
| 概念 | 說明 |
|---|---|
| 技能 |
可變動的頂層實體,內含中繼資料 (例如顯示名稱、建立和更新時間戳記,以及標籤)、預設修訂版本和技能內容。 如需預期技能結構的範例,請參閱 Google Cloud Skills 存放區中的 SKILL.md 檔案。
|
| 技能修訂 | 特定技能版本的不變快照。包括名稱、說明,以及父項技能資源的不變動參照。 |
驗證技能酬載
為確保服務專員可以使用有效的技能內容,系統會在建立或更新期間自動驗證所有技能有效負載。這些驗證作業會以非同步方式執行。
如果系統偵測到下列任一情況,非同步作業就會失敗並顯示驗證錯誤:
- 檔案不是正確的 ZIP 檔案,或缺少重要資訊。
- ZIP 檔案沒有內容。
- ZIP 檔案內含超過 10,000 個項目。
- 壓縮檔中的檔案或資料夾名稱含有
..,或以/或\\開頭。 - ZIP 檔案包含符號連結。
- ZIP 檔案中包含重複的檔案或資料夾名稱。
- ZIP 檔案解壓縮後,所有檔案的總大小超過 500 MB。
- 檔案壓縮過度,壓縮比超過 100。
- ZIP 檔案中的資料夾超過 8 層。
- ZIP 檔案不含
SKILL.md檔案。 SKILL.md檔案有下列問題:SKILL.md檔案缺少必要的 YAML 前言,或預期的 Markdown 內容。- YAML 前置事項中的名稱欄位遺失、超過 64 個字元、開頭或結尾為連字號,或包含小寫英文字母、數字和連字號以外的字元。
- YAML 前置事項缺少說明欄位,或說明欄位超過 1024 個字元。
- YAML 前置事項中的授權欄位超過 1024 個字元。
SKILL.md檔案中的指令超過 500,000 個字元。
- 壓縮封存檔大小超過 10 MB。
內建技能
技能登錄服務內建 gcp-skill-registry 技能。這項技能可讓代理與技能登錄檔互動,藉此建立、搜尋及管理可用技能,進而註冊新功能或探索現有功能。Google 會管理這項內建技能的生命週期、發布和版本管理,確保即時可用。