Copiare un modello in Vertex AI Model Registry

L'addestramento di modelli AutoML, di grandi dimensioni e personalizzati in Vertex AI al livello desiderato richiede tempo ed esperimenti. Se hai un modello con un buon rendimento che vuoi utilizzare in un altro progetto o in un'altra località, l'addestramento di un nuovo modello non è l'opzione migliore. L'addestramento del modello è di natura non deterministica, pertanto è improbabile che si ottenga un modello identico da dati identici. Inoltre, l'addestramento di un modello in ogni regione o progetto non è un modo infallibile per mantenere la coerenza del comportamento del modello tra regioni. Con il modello di copia del registro dei modelli di Vertex AI, puoi copiare un modello dal registro dei modelli di Vertex AI in una posizione separata nello stesso progetto o in un progetto diverso.

Nota: l'opzione Copia modello non supporta la copia dei modelli di linguaggio naturale AutoML e BigQuery ML.

Quando esegui una copia del modello, se non specifichi la versione del modello da copiare, viene copiata la versione predefinita. Per scoprire di più sul valore predefinito del modello o sull'alias del modello, consulta Come utilizzare gli alias del modello.

Limitazioni

Quando copi un modello, non tutte le informazioni del modello vengono copiate. Il modello copiato non manterrà quanto segue:

• Alias versione.
• L'ID del modello personalizzato. Puoi specificare un nuovo ID dopo aver copiato il modello.
• Qualsiasi valutazione del modello esistente.
• Specifiche di crittografia. Devi specificare la chiave di crittografia quando copi il modello per la regione di destinazione.
• Deployment e previsioni batch.
• I modelli Gemini 1.5 non possono essere copiati tra progetti.
• Per la copia tra progetti, puoi copiare i modelli personalizzati che hanno un'immagine container di terze parti.

Copiare i modelli tra progetti

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Prerequisiti

Per copiare un modello tra progetti, il proprietario del modello di origine deve prima concedere l'autorizzazione di esportazione del modello al progetto di destinazione:

1. Seleziona il progetto dalla console Google Cloud.
2. Vai alla pagina IAM e amministrazione.
3. Nella pagina delle autorizzazioni IAM, fai clic su Concedi accesso e viene visualizzata una finestra popup che ti consente di aggiungere una nuova entità al progetto di origine.
4. Recupera l'account di servizio (P4SA) per prodotto e progettoservice-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com del progetto di destinazione.
5. Aggiungi il P4SA del progetto di destinazione come nuovo principale al progetto di origine e assegnagli il ruolo Agente di servizio Vertex AI.
6. Dopo aver fatto clic su Salva, il progetto di destinazione P4SA avrà le autorizzazioni per esportare i modelli dal progetto di origine.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• DESTINATION_LOCATION: la regione in cui vuoi copiare il modello. Ad esempio, us-central1
• DESTINATION_PROJECT_ID: l'ID progetto o il numero di progetto in cui vuoi copiare il modello.
• SOURCE_PROJECT_ID: l'ID o il numero del progetto.
• SOURCE_LOCATION: la regione Vertex AI da cui stai copiando un modello.
• SOURCE_MODEL_ID: l'origine dell'ID modello da copiare.
• VERSION_ID: (facoltativo) ID della versione del modello da copiare (se non viene fornito, viene copiata la versione predefinita)

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Segui le istruzioni riportate di seguito per copiare un modello in un progetto diverso.

1. Nella console Google Cloud, vai alla pagina Model Registry di Vertex AI. Vai a Vertex AI Model Registry
2. Nel Model Registry, seleziona il menu Altre azioni per il modello che vuoi copiare.
   
3. Fai clic su Copia modello.
4. Scegli In un altro progetto o In un'altra regione.

Copiare il modello in un altro progetto

1. Scegli A un altro progetto.
2. Scegli la versione del modello da copiare.
3. Scegli il progetto di destinazione in cui vuoi eseguire la copia.
4. Scegli la regione di destinazione, ad esempio us-central1.
5. Opzioni avanzate: facoltativo per scegliere il metodo di crittografia, utilizzando una chiave di crittografia gestita da Google o una chiave Cloud KMS.

Copiare i modelli tra località

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• DESTINATION_LOCATION: la regione in cui utilizzi Vertex AI. Ad esempio, us-central1
• SOURCE_LOCATION: la regione Vertex AI da cui copierai il modello.
• PROJECT_ID: l'ID o il numero del progetto.
• MODEL_ID:l'ID del modello da copiare.
• VERSION_ID: (facoltativo) ID della versione del modello da copiare (se non viene fornito, viene copiata la versione predefinita)

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

  {
    "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 tra regioni, puoi copiare un modello come nuovo modello all'interno della regione di destinazione o come nuova versione di un modello esistente in quella regione.

Segui le istruzioni riportate di seguito per copiare i modelli.

1. Nella console Google Cloud, vai alla pagina Model Registry di Vertex AI. Vai a Model Registry
2. Nel Model Registry, seleziona il menu Altre azioni per il modello che vuoi copiare.
   
3. Fai clic su Copia modello.
4. Scegli In un altro progetto o In un'altra regione.

Copiare il modello in un'altra regione

1. Scegli In un'altra regione.
2. Scegli la versione del modello da copiare.
3. Seleziona Copia come nuovo modello o Copia come nuova versione.
4. Scegli la regione di destinazione.
5. Aggiungi il nome o l'ID del modello di destinazione. Se copi un modello per la prima volta, a questo viene assegnato l'alias predefinito nella nuova regione.