Copia un modello in Model Registry di Gemini Enterprise Agent Platform

L'addestramento di AutoML, modelli di grandi dimensioni e modelli personalizzati in Agent Platform al livello desiderato richiede tempo e 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 coerenza del comportamento del modello tra le regioni. Con la funzionalità di 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 posizione separata nello stesso progetto o in un progetto diverso.

Nota: la copia del modello non supporta la copia dei modelli AutoML linguaggio naturale e BigQuery ML.

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

Limitazioni

Quando copi un modello, non vengono copiate tutte le informazioni. 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 inferenze batch.

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

Copia 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 console Google Cloud .
2. Vai alla pagina IAM e amministrazione.
3. Nella pagina delle autorizzazioni IAM, fai clic su Concedi l'accesso. Viene visualizzata una finestra popup che ti consente di aggiungere una nuova entità al progetto di origine.
4. Ottieni 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 Gemini Enterprise Agent Platform Service Agent.
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 nell'altro progetto può attivare il processo di esportazione del modello.

Utilizzo di un account di servizio personalizzato

1. Crea un service account personalizzato o utilizzane uno 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 console Google Cloud .
3. Vai alla pagina IAM e amministrazione.
4. Nella pagina delle autorizzazioni IAM, fai clic su Concedi l'accesso. 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, il account di servizio personalizzato avrà le autorizzazioni per esportare i modelli dal progetto di origine.
7. Ottieni 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 nel account di servizio personalizzato.

Copia i modelli tra i progetti:

REST

Nota: aggiungi il campo customServiceAccount nel corpo JSON della richiesta se utilizzi un service account 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 progetto.
• SOURCE_LOCATION: la regione della piattaforma agentica 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 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 le istruzioni riportate di seguito per copiare un modello in un altro progetto.

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise Agent Platform Model Registry. Vai a Model Registry di Gemini Enterprise Agent Platform
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.

Copia 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.
4. Scegli la regione di destinazione, ad esempio us-central1.
5. Opzioni avanzate: facoltativo per scegliere il metodo di crittografia, utilizzando una Google-owned and Google-managed encryption key o una chiave Cloud Key Management Service.

Copia i modelli tra le 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 della piattaforma dell'agente da cui copierai il modello.
• PROJECT_ID: l'ID progetto 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 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 all'interno della regione di destinazione o come nuova versione di un modello esistente in quella regione.

Segui queste istruzioni per copiare i modelli.

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise Agent Platform Model Registry. 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.

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