Copia un modelo en Model Registry de Agent Platform de Gemini Enterprise

Entrenar tus modelos de AutoML, grandes y personalizados en Agent Platform al nivel que deseas requiere tiempo y experimentación. Si tienes un modelo con buen rendimiento que te gustaría usar en otra ubicación o proyecto, el entrenamiento de un modelo nuevo no es la mejor opción. El entrenamiento de modelos no es determinista por naturaleza, por lo que es poco probable que tengas un modelo idéntico a partir de datos idénticos. Además, entrenar un modelo en cada región o proyecto no es una forma infalible de mantener la coherencia del comportamiento de un modelo entre regiones. Con el modelo de copia de Gemini Enterprise Agent Platform Model Registry, puedes copiar un modelo de Gemini Enterprise Agent Platform Model Registry a una ubicación independiente en el mismo proyecto o en uno diferente.

Nota: La copia de modelo no admite la copia de modelos de AutoML Natural Language y BigQuery ML.

Cuando haces una copia del modelo, si no especificas la versión del modelo sobre la que deseas copiar, se copia la versión predeterminada del modelo. Para obtener más información sobre el modelo predeterminado o el alias del modelo, consulta Cómo usar los alias del modelo.

Limitaciones

Cuando copias un modelo, no toda la información del modelo se copia. El modelo copiado no conservará lo siguiente:

• Alias de versiones.
• El ID de modelo personalizado: puedes especificar un ID nuevo una vez que se copia el modelo. Cualquier evaluación existente del modelo.
• Cualquier evaluación existente del modelo.
• Debes especificar la clave de encriptación cuando copies el modelo para tu región de destino. Implementaciones e inferencias por lotes.
• Para la copia entre proyectos, no puedes copiar modelos personalizados que tengan una imagen de contenedor de terceros.

Para la copia entre proyectos, no puedes copiar modelos personalizados que tengan una imagen de contenedor de terceros.

Requisitos previos

Requisitos previos

Para copiar un modelo entre proyectos, el propietario del modelo de origen debe primero otorgar el permiso de exportación del modelo al proyecto de destino:

Selecciona tu proyecto de origen en laconsola.

1. Navega a la página IAM y administración. Google Cloud
2. En la página de IAM y Administrador.
3. En la página de permisos de IAM, haz clic en Otorgar acceso y aparecerá una ventana emergente para que agregues una entidad nueva al proyecto de origen.
4. Agrega la P4SA del proyecto de destino como un principal nuevo al proyecto de origen y asígnale el rol de agente de servicio de Gemini Enterprise Agent Platform. service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com
5. Añada el P4SA del proyecto de destino como una nueva entidad al proyecto de origen y asígnele el rol de agente de servicio de la plataforma Gemini Enterprise.
6. Después de hacer clic en Guardar, la P4SA del proyecto de destino tendrá permisos para exportar modelos desde el proyecto de origen.

Nota: Otorgar el permiso de exportación de modelos al proyecto de destino P4SA significa que cualquier persona con acceso de carga de modelos en el otro proyecto puede activar el proceso de exportación de modelos.

Crea una cuenta de servicio personalizada o usa la existente.

1. Crea una cuenta de servicio personalizada o usa una existente. Esta cuenta de servicio debe pertenecer al proyecto de destino donde se copia el modelo y debes tener el permiso iam.serviceAccounts.actAs en esta cuenta de servicio.
2. Navega a la página IAM y administración. Google Cloud
3. En la página de IAM y Administrador.
4. Agrega la cuenta de servicio personalizada como un principal nuevo al proyecto de origen y asígnale el rol `Gemini Enterprise Agent Platform User` o cualquier rol personalizado con el permiso `aiplatform.models.export`.
5. Después de hacer clic en **Guardar** , la cuenta de servicio personalizada tendrá permisos para exportar modelos del proyecto de origen y asignar el rol Gemini Enterprise Agent Platform User o cualquier rol personalizado con el permiso aiplatform.models.export.
6. Después de hacer clic en Guardar, la cuenta de servicio personalizada tendrá permisos para exportar modelos del proyecto de origen.
7. Otorga la P4SA del proyecto de destino service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com con el rol `Service Account Token Creator` en la cuenta de servicio personalizada.
8. Conceda al P4SA del proyecto de destino el rol Service Account Token Creator en la cuenta de servicio personalizada.

REST

**Nota:** Agrega el campo `customServiceAccount` en el cuerpo JSON de la solicitud si usas una cuenta de servicio personalizada.

Nota: Agrega el campo customServiceAccount en el cuerpo JSON de la solicitud si usas una cuenta de servicio personalizada.

Before using any of the request data, make the following replacements:

• DESTINATION_LOCATION: La región en la que deseas copiar el modelo. Por ejemplo, us-central1
• DESTINATION_PROJECT_ID: El ID o número de proyecto al que deseas copiar el modelo.
• SOURCE_PROJECT_ID: Tu ID del proyecto o número de proyecto.
• SOURCE_LOCATION: La región de la plataforma de agente desde la que está copiando un modelo.
• SOURCE_MODEL_ID: La fuente del ID del modelo que se copiará.
• VERSION_ID: (Opcional) ID de la versión del modelo que se copiará (si no se copia la versión predeterminada)

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

  {
    "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"
      }
    }
  }

Console

En laconsola, ve a la página **Gemini Enterprise Agent Platform Model Registry**.

1. Ir a Gemini Enterprise Agent Platform Model Registry Google Cloud Ve a Model Registry de la plataforma de agente de Gemini Enterprise.
2. En el registro de modelos, selecciona el menú Más acciones del modelo que quieres copiar.
   
3. Haz clic en Copiar modelo.
4. Elige A otro proyecto o A otra región.

Cómo copiar el modelo a un proyecto diferente

1. Elige A otro proyecto.
2. Elige la versión del modelo que deseas copiar.
3. Elige el proyecto de destino al que deseas copiar.
4. Elige la región de destino, por ejemplo, us-central1.
5. Opciones avanzadas: Opcional para elegir el método de cifrado, usando una Google-owned and Google-managed encryption key o una clave de Cloud KMS.

REST

REST

Antes de usar cualquiera de los datos de solicitud a continuación, haz los siguientes reemplazos:

• DESTINATION_LOCATION: la región en la que usas Vertex AI. Por ejemplo, us-central1
• SOURCE_LOCATION: La región de Vertex AI desde la que copiarás el modelo.
• PROJECT_ID: Tu ID del proyecto o número de proyecto.
• MODEL_ID: ID del modelo que se copiará.
• VERSION_ID: (Opcional) ID de la versión del modelo que se copiará (si no se copia la versión predeterminada)

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

  {
    "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"
      }
    }
  }

Console

Con una copia entre regiones, puedes copiar un modelo como un modelo nuevo dentro de la región de destino o como una versión nueva de un modelo existente en esa región.

En laconsola, ve a la página **Gemini Enterprise Agent Platform Model Registry**.

1. Ir a Model Registry Google Cloud En Model Registry, selecciona el menú **Más acciones** more_vert del modelo que deseas copiar.
2. En Model Registry, selecciona el menú Más acciones del modelo que deseas copiar.
   
3. Haz clic en Copiar modelo.
4. Elige A otro proyecto o A otra región.

Cómo copiar un modelo a una región diferente

1. Elige A otra región.
2. Elige la versión del modelo que deseas copiar.
3. Selecciona Copiar como modelo nuevo o Copiar como versión nueva.
4. Elige la región de destino.
5. Agrega el nombre o el ID del modelo de destino. Si copias un modelo a otra región por primera vez, se le asigna el alias predeterminado en la región nueva