在 Gemini Enterprise Agent Platform Model Registry 中复制模型

若要在 Agent Platform 中将 AutoML 模型、大模型和自定义模型训练到所需的水平，需要花费一定时间并进行实验。如果您在其他项目或位置已有表现良好的模型，并且您希望使用该模型，那么便没有必要训练新模型。由于模型训练本质上具有不确定性，因此即便使用相同的训练数据，也不太可能获得完全一样的模型。此外，在每个区域或项目中都训练模型会导致跨区域模型行为的一致性无法得以保证。借助 Gemini Enterprise Agent Platform Model Registry 中的复制模型功能，您可以将 Gemini Enterprise Agent Platform Model Registry 中的模型复制到同一项目中的单独位置或复制到其他项目。

注意： 复制模型功能不支持复制 AutoML Natural Language 和 BigQuery ML 模型。

复制模型时，如果您未指定要复制的模型版本，则系统会复制默认模型版本。如需详细了解模型默认设置或模型别名，请参阅如何使用模型别名。

限制

复制模型时，并非所有模型信息都会被复制。复制的模型副本不会保留以下信息：

• 版本别名。
• 自定义模型 ID。您可以在复制模型后为其指定新 ID。
• 任何现有的模型评估。
• 加密规范。在为目标区域复制模型时，您必须指定加密密钥。
• 部署和批量推理。

对于跨项目复制，您无法复制具有第三方容器映像的自定义模型。

在项目之间复制模型

前提条件

如需跨项目复制模型，源模型的所有者需要先向目标项目授予模型导出权限：

默认

1. 在 Google Cloud 控制台中选择源项目。
2. 前往“IAM 和管理”页面。
3. 在 IAM 权限页面上，点击授予访问权限，系统随即会显示一个弹出式窗口，供您向源项目添加新的主账号。
4. 获取目标项目的产品和项目专属服务账号 (P4SA) service-{project_number}@gcp-sa-aiplatform.。
5. 将目标项目的 P4SA 作为新主账号添加到源项目，并为其分配 Gemini Enterprise Agent Platform Service Agent 角色。
6. 点击保存后，目标项目 P4SA 将拥有从源项目导出模型的权限。

注意： 向目标项目 P4SA 授予模型导出权限意味着，其他项目中拥有模型上传权限的任何人都可以触发模型导出流程。

使用自定义服务账号

1. 创建自定义服务账号或使用现有服务账号。此服务账号必须属于模型复制到的目标项目，并且您需要拥有此服务账号的 iam.serviceAccounts.actAs 权限。
2. 在 Google Cloud 控制台中选择源项目。
3. 前往“IAM 和管理”页面。
4. 在 IAM 权限页面上，点击授予访问权限，系统随即会显示一个弹出式窗口，供您向源项目添加新的主账号。
5. 将自定义服务账号作为新主账号添加到源项目，并向其分配 Gemini Enterprise Agent Platform User 角色或具有 aiplatform.models.export 权限的任何自定义角色。
6. 点击保存后，自定义服务账号将拥有从源项目导出模型的权限。
7. 获取目标项目的产品和项目专属服务账号 (P4SA) service-{project_number}@gcp-sa-aiplatform.。
8. 向目标项目的 P4SA 授予自定义服务账号的 Service Account Token Creator 角色。

在项目之间复制模型：

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 中选择要复制的模型的更多操作菜单 。
   
3. 点击复制模型。
4. 选择移至其他项目或移至其他区域。

将模型复制到其他项目

1. 选择移至其他项目。
2. 选择要复制的模型版本。
3. 选择要复制到的目标项目。
4. 选择目标区域，例如 us-central1。
5. 高级选项：可以选择加密方法，使用 Google-owned and Google-managed encryption key 或 Cloud KMS 密钥。

在各个位置之间复制模型

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。如果您是首次复制某个模型，则系统会在新区域中为其分配默认别名。