Copia un modelo en Model Registry de Gemini Enterprise Agent Platform

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 determinístico 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 Model Registry de Gemini Enterprise Agent Platform, puedes copiar un modelo de Model Registry de Gemini Enterprise Agent Platform 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.
• Especificaciones de encriptación. 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.

Copia modelos entre proyectos

Requisitos previos

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

Predeterminado

1. Selecciona tu proyecto de origen en la consola de Google Cloud .
2. Navega a la página IAM y administración.
3. En la página de permisos de IAM, haz clic en Otorgar acceso y aparecerá una ventana emergente para permitirte agregar un principal nuevo al proyecto de origen.
4. Obtén la cuenta de servicio por producto y por proyecto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com del proyecto de destino.
5. Agrega la P4SA del proyecto de destino como una principal nueva al proyecto de origen y asígnale el rol de agente de servicio de Gemini Enterprise Agent Platform.
6. Después de hacer clic en Guardar, el proyecto de destino P4SA tendrá permisos para exportar modelos del proyecto de origen.

Nota: Otorgar el permiso de exportación del modelo 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 del modelo.

Usa una cuenta de servicio personalizada

1. Crea una cuenta de servicio personalizada o usa la que ya tienes. Esta cuenta de servicio debe pertenecer al proyecto de destino en el que se copia el modelo, y debes tener el permiso iam.serviceAccounts.actAs en esta cuenta de servicio.
2. Selecciona tu proyecto de origen en la consola de Google Cloud .
3. Navega a la página IAM y administración.
4. En la página de permisos de IAM, haz clic en Otorgar acceso y aparecerá una ventana emergente para permitirte agregar un principal nuevo al proyecto de origen.
5. Agrega la cuenta de servicio personalizada como una principal nueva al proyecto de origen y asígnale 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. Obtén la cuenta de servicio por producto y por proyecto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com del proyecto de destino.
8. Otorga a la P4SA del proyecto de destino el rol Service Account Token Creator en la cuenta de servicio personalizada.

Copia modelos entre proyectos:

REST

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

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

• DESTINATION_LOCATION: La región en la que deseas copiar el modelo. Por ejemplo, us-central1
• DESTINATION_PROJECT_ID: Es el ID del proyecto o número del proyecto al que deseas copiar el modelo.
• SOURCE_PROJECT_ID: Tu ID del proyecto o número de proyecto.
• SOURCE_LOCATION: Es la región de Agent Platform desde la que copias 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

Usa las siguientes instrucciones para copiar un modelo en un proyecto diferente.

1. En la consola de Google Cloud , ve a la página Gemini Enterprise Agent Platform Model Registry. Ir a Model Registry de Gemini Enterprise Agent Platform
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 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 encriptación, con una Google-owned and Google-managed encryption key o una clave de Cloud Key Management Service.

Cómo copiar modelos entre ubicaciones

REST

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

• DESTINATION_LOCATION: Es la región en la que usas Agent Platform. Por ejemplo, us-central1
• SOURCE_LOCATION: Es la región de Agent Platform 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.

Usa las siguientes instrucciones para copiar modelos.

1. En la consola de Google Cloud , ve a la página Gemini Enterprise Agent Platform Model Registry. Ir a Model Registry
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