Copia un modello in Model Registry di Gemini Enterprise Agent Platform

L'addestramento di modelli AutoML, di grandi dimensioni e personalizzati in Agent Platform al livello desiderato richiede tempo e sperimentazione. Se hai un modello con buone prestazioni 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, quindi è improbabile che tu possa ottenere 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 le regioni. Con la copia del modello di Model Registry di Gemini Enterprise Agent Platform, puoi copiare un modello da Model Registry di Gemini Enterprise Agent Platform in una località separata nello stesso progetto o in un progetto diverso.

Nota: la copia del modello non supporta la copia dei modelli AutoML Natural Language e BigQuery ML.

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

Limitazioni

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

• Alias della 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 inferenze batch.

Per la copia tra progetti, non puoi copiare i modelli personalizzati che hanno un'immagine container di terze parti.

Copiare i modelli tra progetti

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:

Predefinito

1. Seleziona il progetto di origine dalla Google Cloud console.
2. Vai alla pagina IAM e 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. Recupera il account di servizio per prodotto e per progetto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com del progetto di destinazione.
5. Aggiungi il P4SA del progetto di destinazione come nuova entità al progetto di origine e assegnagli il ruolo di Agente di servizio della piattaforma agentica Gemini Enterprise.
6. Dopo aver fatto clic su Salva, il P4SA del progetto di destinazione avrà le autorizzazioni per esportare i modelli dal progetto di origine.

Nota: la concessione dell'autorizzazione di esportazione del modello al P4SA del progetto di destinazione significa che chiunque abbia accesso al caricamento del modello sull'altro progetto può attivare il processo di esportazione del modello.

Utilizzo di un account di servizio personalizzato

1. Crea un service account personalizzato o utilizza quello esistente. Questo account di servizio deve appartenere al progetto di destinazione in cui viene copiato il modello e devi disporre dell'autorizzazione iam.serviceAccounts.actAs su questo account di servizio.
2. Seleziona il progetto di origine dalla Google Cloud console.
3. Vai alla pagina IAM e amministrazione.
4. 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.
5. Aggiungi il account di servizio personalizzato come nuova entità al progetto di origine e assegnagli il ruolo Gemini Enterprise Agent Platform User o qualsiasi ruolo personalizzato con l'autorizzazione aiplatform.models.export.
6. Dopo aver fatto clic su Salva, l'account di servizio personalizzato avrà le autorizzazioni per esportare i modelli dal progetto di origine.
7. Recupera il account di servizio per prodotto e per progetto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com del progetto di destinazione.
8. Concedi al P4SA del progetto di destinazione il ruolo Service Account Token Creator sull'account di servizio personalizzato.

Copiare i modelli tra progetti:

REST

Nota: aggiungi il campo customServiceAccount nel corpo JSON della richiesta se utilizzi un account di servizio personalizzato.

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

• DESTINATION_LOCATION: la regione in cui vuoi copiare il modello. Ad esempio, us-central1
• DESTINATION_PROJECT_ID: l'ID progetto o il numero del progetto in cui vuoi copiare il modello.
• SOURCE_PROJECT_ID: l'ID progetto o il numero del tuo progetto.
• SOURCE_LOCATION: la regione di Agent Platform da cui stai copiando un modello.
• SOURCE_MODEL_ID: l'origine dell'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/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 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 all'interfaccia a riga di comando 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 queste istruzioni per copiare i modelli in un altro progetto.

1. Nella Google Cloud console, vai alla pagina Model Registry della piattaforma agentica Gemini Enterprise. Vai a Model Registry della piattaforma agentica Gemini Enterprise
2. In 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 In un altro progetto.
2. Scegli la versione del modello che vuoi copiare.
3. Scegli il progetto di destinazione in cui vuoi copiare il modello.
4. Scegli la regione di destinazione, ad esempio us-central1.
5. Opzioni avanzate: facoltativamente, puoi scegliere il metodo di crittografia utilizzando una chiave di crittografia gestita da Google-owned and Google-managed encryption key o una chiave Cloud KMS.

Copiare i modelli tra località

REST

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

• DESTINATION_LOCATION: la regione in cui utilizzi Agent Platform. Ad esempio, us-central1
• SOURCE_LOCATION: la regione di Agent Platform da cui copierai il modello.
• PROJECT_ID: l'ID progetto o il numero del tuo 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 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 all'interfaccia a riga di comando 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 nella regione di destinazione o come nuova versione di un modello esistente in quella regione.

Segui queste istruzioni per copiare i modelli.

1. Nella Google Cloud console, vai alla pagina Model Registry della piattaforma agentica Gemini Enterprise. Vai a Model Registry
2. In 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 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, gli viene assegnato l'alias predefinito nella nuova regione.