在 Gemini Enterprise Agent Platform Model Registry 中複製模型

在 Agent Platform 訓練 AutoML、大型模型和自訂模型，需要時間和實驗，才能達到所需水準。如果您有成效良好的模型，想在其他專案或位置使用，訓練新模型並非最佳選擇。模型訓練本質上不具確定性，因此即使使用相同資料，也不太可能產生完全相同的模型。此外，在每個區域或專案中訓練模型，並非維持跨區域模型行為一致性的萬全之策。使用 Gemini Enterprise Agent Platform Model Registry 複製模型，即可將模型從 Gemini Enterprise Agent Platform Model Registry 複製到同一專案中的其他位置，或複製到其他專案。

注意： 複製模型不支援複製 AutoML 自然語言和 BigQuery ML 模型。

執行模型複製作業時，如未指定要複製的模型版本，系統會複製預設模型版本。如要進一步瞭解模型預設值或模型別名，請參閱「如何使用模型別名」。

限制

複製模型時，系統不會複製所有模型資訊。複製的模型不會保留下列項目：

• 版本別名。
• 自訂模型 ID。複製模型後，即可指定新的 ID。
• 任何現有的模型評估。
• 加密規格。複製模型至目標區域時，必須指定加密金鑰。
• 部署作業和批次推論。

如果是跨專案複製，則無法複製含有第三方容器映像檔的自訂模型。

在專案之間複製模型

必要條件

如要跨專案複製模型，來源模型擁有者必須先將模型匯出權限授予目的地專案：

預設

1. 在 Google Cloud 控制台選取來源專案。
2. 前往「IAM & Admin」(IAM 與管理) 頁面。
3. 在「IAM 權限」頁面，點選「授予存取權」，畫面上會顯示彈出式視窗，讓您將新主體新增至來源專案。
4. 取得目的地專案的每項產品和專案服務帳戶 (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com。
5. 將目的地專案的 P4SA 新增為來源專案的新主體，並指派 Gemini Enterprise Agent Platform 服務代理角色。
6. 點選「Save」(儲存) 後，目的地專案 P4SA 就能從來源專案匯出模型。

注意： 如果將模型匯出權限授予目的地專案 P4SA，代表任何具備其他專案模型上傳權限的使用者，都能觸發模型匯出程序。

使用自訂服務帳戶

1. 建立自訂服務帳戶或使用現有帳戶。這個服務帳戶必須屬於模型複製到的目的地專案，且您必須具備這個服務帳戶的 iam.serviceAccounts.actAs 權限。
2. 在 Google Cloud 控制台選取來源專案。
3. 前往「IAM & Admin」(IAM 與管理) 頁面。
4. 在「IAM 權限」頁面，點選「授予存取權」，畫面上會顯示彈出式視窗，讓您將新的主體新增至來源專案。
5. 將自訂服務帳戶新增為來源專案的新主體，並指派 Gemini Enterprise Agent Platform User 角色或任何具有 aiplatform.models.export 權限的自訂角色。
6. 點選「Save」(儲存) 後，自訂服務帳戶就會具備從來源專案匯出模型的權限。
7. 取得目的地專案的每項產品和專案服務帳戶 (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com。
8. 將自訂服務帳戶的 Service Account Token Creator 角色授予目的地專案的 P4SA。

在專案之間複製模型：

REST

注意： 如果您使用自訂服務帳戶，請在要求 JSON 主體中新增 customServiceAccount 欄位。

使用任何要求資料之前，請先修改下列項目的值：

• DESTINATION_LOCATION：要複製模型的目標區域。例如：us-central1
• DESTINATION_PROJECT_ID：要複製模型的專案 ID 或專案編號。
• SOURCE_PROJECT_ID：專案 ID 或專案編號。
• SOURCE_LOCATION：要複製模型的 Agent Platform 區域。
• SOURCE_MODEL_ID：要複製的模型 ID 來源。
• VERSION_ID：(選用) 要複製的模型版本 ID (如未提供，則會複製預設版本)

HTTP 方法和網址：

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy

JSON 要求主體：

   {
    "sourceModel": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/models/SOURCE_MODEL_ID"
    }

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

控制台

請按照下列操作說明，將模型複製到其他專案。

1. 前往 Google Cloud 控制台的「Gemini Enterprise Agent Platform Model Registry」頁面。 前往 Gemini Enterprise Agent Platform 的 Model Registry
2. 在 Model Registry 中，選取要複製的模型，然後按一下「More actions」(更多動作) 選單 。
   
3. 按一下「複製模型」。
4. 選擇「移至其他專案」或「移至其他區域」。

將模型複製到其他專案

1. 選擇「移至其他專案」。
2. 選擇要複製的模型版本。
3. 選擇要複製到的目的地專案。
4. 選擇目的地區域，例如 us-central1。
5. 進階選項：可選擇加密方法，使用 Google-owned and Google-managed encryption key 或 Cloud Key Management Service 金鑰。

在不同位置之間複製模型

REST

使用任何要求資料之前，請先修改下列項目的值：

• DESTINATION_LOCATION：您使用 Agent Platform 的區域。例如：us-central1
• SOURCE_LOCATION：要複製模型的 Agent Platform 區域。
• PROJECT_ID：專案 ID 或專案編號。
• MODEL_ID：要複製的模型 ID。
• VERSION_ID：(選用) 要複製的模型版本 ID (如未提供，則會複製預設版本)

HTTP 方法和網址：

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy

JSON 要求主體：

{"sourceModel": "projects/PROJECT_ID/locations/SOURCE_LOCATION/models/MODEL_ID[@VERSION_ID]"
}

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

控制台

透過跨區域複製，您可以將模型複製為目標區域中的新模型，或該區域中現有模型的新版本。

請按照下列操作說明複製模型。

1. 前往 Google Cloud 控制台的「Gemini Enterprise Agent Platform Model Registry」頁面。 前往「Model Registry」
2. 在 Model Registry 中，選取要複製的模型「更多動作」選單 。
   
3. 按一下「複製模型」
4. 選擇「移至其他專案」或「移至其他區域」。

將模型複製到其他區域

1. 選擇「移至其他區域」。
2. 選擇要複製的模型版本。
3. 選取「複製為新模型」或「複製為新版本」。
4. 選擇目的地區域。
5. 新增目的地模型名稱或模型 ID。如果是首次複製模型，系統會在新區域中指派預設別名。