Skill Registry 總覽

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 會管理這項內建技能的生命週期、發布和版本管理,確保即時可用。

後續步驟

指南

瞭解如何在技能登錄中建立、更新、搜尋及刪除技能。