Copiare un modello in Vertex AI Model Registry

Addestramento di AutoML, modelli di grandi dimensioni e modelli personalizzati in Vertex AI al livello desiderato richiede tempo e degli esperimenti. Se vuoi utilizzare un modello dalle buone prestazioni un altro progetto o luogo, addestrare 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 ogni regione o progetto non rappresenta un modo infallibile per gestire un modello interregionale della coerenza del comportamento. 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 modello predefinito o l'alias del modello, consulta Come utilizzare gli alias del modello.

Limitazioni

Quando copi un modello, non tutte le informazioni del modello vengono copiate. Il testo copiato non conserverà 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 durante la copia il modello per la regione target.
• 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.

Copia 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 tuo progetto dalla console Google Cloud.
2. Accedi alla sezione IAM & pagina Amministrazione.
3. Nella pagina delle autorizzazioni IAM, fai clic su Concedi l'accesso e apri una finestra popup. 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 nuova entità all'origine e assegnargli il ruolo di 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 o il numero del 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 stanno 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 delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'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 di Google. 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. ed esegui questo 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

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

Usa le istruzioni riportate di seguito per copiare un modello in un altro progetto.

1. Nella console Google Cloud, vai alla pagina Vertex AI Model Registry. Vai a Vertex AI Model Registry
2. In Model Registry, seleziona More actions (Altre azioni) menu per il modello da 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 In un altro progetto.
2. Scegli la versione del modello che vuoi 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: puoi 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 stai utilizzando Vertex AI. Ad esempio, us-central1
• SOURCE_LOCATION: la regione Vertex AI da cui per copiare 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, la versione predefinita viene copiata)

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 delle seguenti 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. ed esegui questo 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: 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 Vertex AI Model Registry. Vai al registro dei modelli
2. In Model Registry, seleziona More actions (Altre azioni) menu per il modello da copiare.
   
3. Fai clic su Copia modello.
4. Scegli In un altro progetto o In un'altra regione.

Copiare il modello in una regione diversa

1. Scegli In un'altra regione.
2. Scegli la versione del modello che vuoi 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 modello di destinazione. Se copi un modello per la prima volta, gli viene assegnato l'alias predefinito nella nuova regione.