管理技能修訂版本

在 Agent Registry 中，技能修訂版本代表技能套件的不可變更版本化快照。更新技能的程式碼或指令時，系統會建立新的修訂版本。這種分離式架構可讓您控管技能版本。

本文說明如何建立及管理技能修訂版本。如要瞭解如何更新特定技能的預設修訂版本，請參閱「更新技能中繼資料或預設修訂版本」。

事前準備

開始之前，請先設定 Agent Registry，並註冊獨立技能。您需要專案 ID 才能執行這些工作。

如要使用本文中的 Google Cloud CLI 指令，請務必設定 gcloud CLI 環境。

必要的角色

如要取得管理 Agent Registry 中技能修訂版本所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

其他 Agent Registry 角色可能也包含檢視、下載、建立、更新及刪除技能修訂版本所需的權限。詳情請參閱「Agent Registry 角色和權限」。

建立技能修訂版本

建立新修訂版本會將新的 ZIP 酬載上傳至現有技能容器。建立技能修訂版本後，該版本會自動成為技能的有效版本。不過，您隨時可以更新技能的預設版本。只有有效修訂版本可以下載。

如要瞭解技能的定價和功能費用，請參閱「Agent Registry 定價」。

技能修訂版本的 ZIP 檔案大小上限為 500 KB。

控制台

  1. 前往 Google Cloud 控制台的「Agent Registry」頁面：

    前往 Agent Registry

  2. 選取「技能」分頁，然後點選技能名稱。
  3. 在「技能詳細資料」頁面中，找到「版本記錄」表格。
  4. 按一下「新增版本」圖示 。

  5. 在「新增版本」面板中，選擇下列任一選項：

    • 檔案：上傳內含程式碼或提示詞指令 (SKILL.md) 檔案的套件或 ZIP 檔案。您可以按一下「瀏覽」，在本機環境中尋找檔案。

    • Bucket：提供包含有效 ZIP 組合的 Cloud Storage URI (gs://...)。您可以點選「瀏覽」，在 Cloud Storage bucket 中尋找檔案。

  6. 點選「建立」。

「技能詳細資料」頁面的「版本記錄」表格會顯示技能修訂版本。

gcloud

您可以上傳本機 ZIP 檔案，或匯入儲存在 Cloud Storage 中的套件，建立技能修訂版本。

更改下列內容：

  • REVISION_ID：要指派給技能修訂版本的 ID。
  • SKILL_ID：用於修訂的技能 ID。
  • PROJECT_ID：專案 ID。

  • LOCATION：登錄檔位置。

  • 上傳本機 ZIP 檔案：如要使用本機 ZIP 酬載建立技能修訂版本，請按照下列步驟操作：

    gcloud alpha agent-registry skills revisions create REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --payload="LOCAL_ZIP_PATH"

    將 LOCAL_ZIP_PATH 替換為本機上封裝技能封存檔的路徑。

  • 從 Cloud Storage bucket 匯入：如要使用 Cloud Storage bucket 中託管的 ZIP 封存檔建立技能修訂版本，請按照下列步驟操作：

    gcloud alpha agent-registry skills revisions create REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --gcs-source-uri="gs://BUCKET_NAME/SKILL_PACKAGE.zip"

    更改下列內容：

    • BUCKET_NAME：包含 ZIP 組合的 Cloud Storage bucket 名稱。
    • SKILL_PACKAGE：包含技能修訂版本的技能套件名稱。

REST

如要建立技能修訂版本，請將 POST 要求傳送至修訂版本集合。您可以直接上傳 ZIP 酬載，或指向 Cloud Storage 路徑。

  • 上傳本機 ZIP 檔案：在要求主體中指定 archiveUploadSource，其中包含 Base64 編碼的 ZIP 位元組。您可以在 curl 中使用內嵌的 base64 指令：

    curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
        "archiveUploadSource": {
          "archiveContent": "$(base64 -w0 local_skill.zip)"
        }
      }' \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions?skillRevisionId=REVISION_ID"

  • 從 Cloud Storage bucket 匯入：在要求主體中指定 gcsSource，指向 bucket 路徑：

    curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
        "gcsSource": {
          "uri": "gs://BUCKET_NAME/SKILL_PACKAGE.zip"
        }
      }' \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions?skillRevisionId=REVISION_ID"

更改下列內容：

  • PROJECT_ID：專案 ID。
  • LOCATION：登錄檔位置。
  • SKILL_ID：技能容器的 ID。
  • REVISION_ID：要指派給這個修訂版本的 ID。
  • BUCKET_NAME：包含 ZIP 檔案的 Cloud Storage bucket 名稱。
  • SKILL_PACKAGE：ZIP 封包的名稱。

列出並說明修訂版本

您可以查看技能的所有修訂版本清單，並檢查其相關中繼資料。 如要更新技能的預設修訂版本，請參閱「更新技能中繼資料或預設修訂版本」。

如要列出並查看修訂版本詳細資料，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Agent Registry」頁面：

    前往 Agent Registry

  2. 選取「技能」分頁，然後點選技能名稱。
  3. 在「技能詳細資料」頁面中，找到「版本記錄」表格。
  4. 查看版本 ID、建立時間、修訂狀態和可用動作。

gcloud

如要列出技能的所有修訂版本，請按照下列步驟操作：

gcloud alpha agent-registry skills revisions list \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION

如要說明特定修訂版本的中繼資料，請執行下列操作：

gcloud alpha agent-registry skills revisions describe REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION

REST

如要列出修訂版本，請按照下列步驟操作：

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions"

如要取得單一修訂版本的中繼資料：

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

下載修訂版本酬載

您可以下載特定修訂版本的已編譯 ZIP 檔案酬載，以便在本地進行驗證或偵錯。

如要下載酬載，必須符合下列兩項條件：

如要下載有效修訂版本的修訂內容酬載，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Agent Registry」頁面：

    前往 Agent Registry

  2. 選取「技能」分頁，然後點選技能名稱。
  3. 在「技能詳細資料」頁面中，找到「版本記錄」表格。
  4. 找出要下載的修訂版本。
  5. 按一下「動作」欄中的「下載」。ZIP 酬載會下載至本機電腦。

gcloud

如要下載修訂版本的封存酬載，請執行 describe 指令並使用 --alt=media 旗標，然後將輸出內容重新導向至檔案：

gcloud alpha agent-registry skills revisions describe REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --flags="alt=media" > skill_payload.zip

REST

向修訂版本的資源網址傳送 GET 要求，並加入查詢參數 alt=media。您必須搭配使用 -L 旗標和 curl，才能追蹤 HTTP 重新導向串流：

curl -L -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -o skill_payload.zip \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID?alt=media"

刪除特定修訂版本

刪除特定修訂版本後，系統會從 Agent Registry 移除該版本的 ZIP 酬載和中繼資料記錄。

通常只有管理員才能刪除個別修訂版本。你無法刪除設為技能預設修訂版本的修訂版本。如要更新技能的預設修訂版本，請參閱「更新技能中繼資料或預設修訂版本」。

如要刪除特定修訂版本，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Agent Registry」頁面：

    前往 Agent Registry

  2. 選取「技能」分頁，然後點選技能名稱。
  3. 在「技能詳細資料」頁面中，找到「版本記錄」表格。
  4. 找出要刪除的修訂版本。
  5. 在「動作」欄中，按一下「刪除」並確認動作。

gcloud

gcloud alpha agent-registry skills revisions delete REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION

REST

curl -X DELETE \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

後續步驟