copia 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 e un po' di sperimentazione. 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 tu 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 consistenza del comportamento del modello tra regioni. Con la copia del modello di Vertex AI Model Registry, puoi copia un modello da Vertex AI Model Registry in una posizione separata allo stesso progetto o a un altro progetto.

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 relative informazioni vengono copiate. Il modello 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 specificarne uno nuovo al momento della copia per la regione di destinazione.
• Deployment e previsioni batch.
• 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. Accedi alla sezione IAM & pagina Amministrazione.
3. Nella pagina delle autorizzazioni IAM, fai clic su Concedi l'accesso e viene visualizzata una finestra popup che ti consente di aggiungere una nuova entità al progetto di origine.
4. Ottieni il numero numerico del progetto di destinazione e la credenziale P4SA di il progetto di destinazione
5. Aggiungi la credenziale P4SA del progetto di destinazione come nuova entità all'origine e assegnare il ruolo Agente di servizio Vertex AI al progetto di destinazione P4SA.
6. Dopo aver fatto clic su Salva, il progetto di destinazione P4SA dispone delle autorizzazioni per esportare i modelli dal progetto di origine.

REST

Prima di utilizzare i dati della richiesta, effettua 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 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, la versione predefinita viene copiata)

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 Model Registry di Vertex AI. 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 progetto diverso

1. Scegli In 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.

Copia 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: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, 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 a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login 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:

$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.

Usa le seguenti istruzioni per copiare i modelli.

1. Nella console Google Cloud, vai alla pagina Model Registry di Vertex AI. Vai a 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'altra regione

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 del modello di destinazione. Se copi un modello per la prima volta, a questo viene assegnato l'alias predefinito nella nuova regione.