Ottimizza i modelli Gemini mediante il perfezionamento supervisionato

Console

Per ottimizzare un modello di testo utilizzando la console Google Cloud :

1. Nella sezione Vertex AI della Google Cloud console, vai alla pagina Vertex AI Studio.

   Vai a Vertex AI Studio

2. Fai clic su Crea modello ottimizzato.

3. Nella sezione Dettagli modello, configura quanto segue:

   1. Nel campo Nome modello ottimizzato, inserisci un nome per il nuovo modello ottimizzato, fino a 128 caratteri.
   2. Nel campo Modello di base, seleziona gemini-2.5-flash.
   3. Nell'elenco a discesa Regione, seleziona la regione in cui viene eseguito il job di ottimizzazione della pipeline e in cui è stato eseguito il deployment del modello ottimizzato.

4. In Impostazione di ottimizzazione, configura quanto segue:

   1. Nel campo Numero di epoche, inserisci il numero di epoche per l'ottimizzazione del modello.
   2. Nel campo Dimensioni adattatore, inserisci le dimensioni dell'adattatore da utilizzare per l'ottimizzazione del modello.
   3. Nel campo Moltiplicatore del tasso di apprendimento, inserisci la dimensione del passaggio in ogni iterazione. Il valore predefinito è 1. .

5. (Facoltativo) Per disattivare i checkpoint intermedi e utilizzare solo l'ultimo checkpoint, seleziona il pulsante di attivazione/disattivazione Esporta solo l'ultimo checkpoint.

6. Fai clic su Continua. Viene visualizzata la pagina Set di dati di ottimizzazione.

7. Seleziona il set di dati di ottimizzazione:

   • Per caricare un nuovo file del set di dati dal computer, seleziona Carica file su Cloud Storage.
   • Nel campo Seleziona file JSONL, fai clic su Sfoglia e seleziona il file del set di dati.
   • Nel campo Posizione del set di dati, fai clic su Sfoglia e seleziona il bucket Cloud Storage in cui vuoi archiviare il file del set di dati.
   • Per utilizzare un file del set di dati già presente in un bucket Cloud Storage, seleziona File esistente su Cloud Storage.
   • Nel campo Percorso file Cloud Storage, fai clic su Sfoglia e seleziona il bucket Cloud Storage in cui si trova il file del set di dati.

8. (Facoltativo) Per ottenere metriche di convalida durante l'addestramento, seleziona il pulsante di attivazione/disattivazione Abilita convalida del modello.

   1. Nel campo Set di dati di convalida, inserisci il percorso Cloud Storage del set di dati di convalida.

9. Fai clic su Avvia ottimizzazione.

   Il nuovo modello viene visualizzato nella sezione Modelli Gemini Pro ottimizzati della pagina Ottimizza e distilla. Al termine del job di ottimizzazione, lo stato è Riuscito.

SDK Google Gen AI

import time  from google import genai from google.genai.types import HttpOptions, CreateTuningJobConfig, TuningDataset  client = genai.Client(http_options=HttpOptions(api_version="v1"))  training_dataset = TuningDataset(     gcs_uri="gs://cloud-samples-data/ai-platform/generative_ai/gemini/text/sft_train_data.jsonl", )  tuning_job = client.tunings.tune(     base_model="gemini-2.5-flash",     training_dataset=training_dataset,     config=CreateTuningJobConfig(         tuned_model_display_name="Example tuning job",     ), )  running_states = set([     "JOB_STATE_PENDING",     "JOB_STATE_RUNNING", ])  while tuning_job.state in running_states:     print(tuning_job.state)     tuning_job = client.tunings.get(name=tuning_job.name)     time.sleep(60)  print(tuning_job.tuned_model.model) print(tuning_job.tuned_model.endpoint) print(tuning_job.experiment) # Example response: # projects/123456789012/locations/us-central1/models/1234567890@1 # projects/123456789012/locations/us-central1/endpoints/123456789012345 # projects/123456789012/locations/us-central1/metadataStores/default/contexts/tuning-experiment-2025010112345678  if tuning_job.tuned_model.checkpoints:     for i, checkpoint in enumerate(tuning_job.tuned_model.checkpoints):         print(f"Checkpoint {i + 1}: ", checkpoint)     # Example response:     # Checkpoint 1:  checkpoint_id='1' epoch=1 step=10 endpoint='projects/123456789012/locations/us-central1/endpoints/123456789000000'     # Checkpoint 2:  checkpoint_id='2' epoch=2 step=20 endpoint='projects/123456789012/locations/us-central1/endpoints/123456789012345' 

SDK Vertex AI per Python

 import time  import vertexai from vertexai.tuning import sft  # TODO(developer): Update and un-comment below line # PROJECT_ID = "your-project-id" vertexai.init(project=PROJECT_ID, location="us-central1")  sft_tuning_job = sft.train(     source_model="gemini-2.0-flash-001",     # 1.5 and 2.0 models use the same JSONL format     train_dataset="gs://cloud-samples-data/ai-platform/generative_ai/gemini-1_5/text/sft_train_data.jsonl", )  # Polling for job completion while not sft_tuning_job.has_ended:     time.sleep(60)     sft_tuning_job.refresh()  print(sft_tuning_job.tuned_model_name) print(sft_tuning_job.tuned_model_endpoint_name) print(sft_tuning_job.experiment) # Example response: # projects/123456789012/locations/us-central1/models/1234567890@1 # projects/123456789012/locations/us-central1/endpoints/123456789012345 # <google.cloud.aiplatform.metadata.experiment_resources.Experiment object at 0x7b5b4ae07af0> 

REST

Per creare un job di ottimizzazione del modello, invia una richiesta POST utilizzando il metodo tuningJobs.create. Alcuni parametri non sono supportati da tutti i modelli. Includi solo i parametri applicabili per il modello che stai ottimizzando.

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

• PROJECT_ID: .
• TUNING_JOB_REGION: la regione in cui viene eseguito il job di ottimizzazione. Questa è anche la regione predefinita in cui viene caricato il modello ottimizzato.
• BASE_MODEL: Nome del modello di base da ottimizzare.
• TRAINING_DATASET_URI: l'URI Cloud Storage del set di dati di addestramento. Il set di dati deve essere formattato come file JSONL. Per ottenere risultati ottimali, fornisci almeno 100-500 esempi. Per saperne di più, consulta Informazioni sui set di dati di ottimizzazione supervisionata .
• VALIDATION_DATASET_URI(Facoltativo) L'URI Cloud Storage del file del set di dati di convalida.
• EPOCH_COUNT(Facoltativo) Il numero di passaggi completi che il modello esegue sull'intero set di dati di addestramento durante l'addestramento. Lascia il campo vuoto per utilizzare il valore consigliato precompilato.
• ADAPTER_SIZE(Facoltativo) Le dimensioni dell'adattatore da utilizzare per il job di ottimizzazione. Le dimensioni dell'adattatore influiscono sul numero di parametri addestrabili per il job di ottimizzazione. Un adattatore più grande implica che il modello può apprendere attività più complesse, ma richiede un set di dati di addestramento più grande e tempi di addestramento più lunghi.
• LEARNING_RATE_MULTIPLIER: facoltativo: un moltiplicatore da applicare al tasso di apprendimento suggerito. Lascia il campo vuoto per utilizzare il valore consigliato.
• EXPORT_LAST_CHECKPOINT_ONLY(Facoltativo) Imposta true per utilizzare solo l'ultimo checkpoint.
• TUNED_MODEL_DISPLAYNAME(Facoltativo) Un nome visualizzato per il modello ottimizzato. Se non viene impostato, viene generato un nome casuale.
• KMS_KEY_NAME(Facoltativo) L'identificatore di risorsa Cloud KMS della chiave di crittografia gestita dal cliente utilizzata per proteggere una risorsa. La chiave ha il formato: projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. La chiave deve trovarsi nella stessa regione in cui viene creata la risorsa di calcolo. Per saperne di più, consulta Chiavi di crittografia gestite dal cliente (CMEK).
• SERVICE_ACCOUNT(Facoltativo) Il account di servizio con cui viene eseguito il carico di lavoro tuningJob. Se non specificato, viene utilizzato l'agente di servizio Vertex AI Secure Fine-Tuning nel progetto. Consulta la sezione Agente di servizio di ottimizzazione. Se prevedi di utilizzare un service account gestito dal cliente, devi concedere il ruolo roles/aiplatform.tuningServiceAgent al account di servizio. Concedi anche il ruolo Agente di servizio di ottimizzazione roles/iam.serviceAccountTokenCreator al service account gestito dal cliente.

Metodo HTTP e URL:

POST https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs

Corpo JSON della richiesta:

 {   "baseModel": "BASE_MODEL",   "supervisedTuningSpec" : {       "trainingDatasetUri": "TRAINING_DATASET_URI",       "validationDatasetUri": "VALIDATION_DATASET_URI",       "hyperParameters": {           "epochCount": "EPOCH_COUNT",           "adapterSize": "ADAPTER_SIZE",           "learningRateMultiplier": "LEARNING_RATE_MULTIPLIER"       },       "export_last_checkpoint_only": EXPORT_LAST_CHECKPOINT_ONLY,   },   "tunedModelDisplayName": "TUNED_MODEL_DISPLAYNAME",   "encryptionSpec": {     "kmsKeyName": "KMS_KEY_NAME"   },   "serviceAccount": "SERVICE_ACCOUNT" } 

Per inviare la richiesta, scegli una di queste opzioni:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs"

$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://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente.

 {   "name": "projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs/TUNING_JOB_ID",   "createTime": CREATE_TIME,   "updateTime": UPDATE_TIME,   "status": "STATUS",   "supervisedTuningSpec": {         "trainingDatasetUri": "TRAINING_DATASET_URI",         "validationDatasetUri": "VALIDATION_DATASET_URI",         "hyperParameters": {             "epochCount": EPOCH_COUNT,             "adapterSize": "ADAPTER_SIZE",             "learningRateMultiplier": LEARNING_RATE_MULTIPLIER         },     },   "tunedModelDisplayName": "TUNED_MODEL_DISPLAYNAME",   "encryptionSpec": {     "kmsKeyName": "KMS_KEY_NAME"   },   "serviceAccount": "SERVICE_ACCOUNT" } 

Comando curl di esempio

PROJECT_ID=myproject LOCATION=global curl \ -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://${LOCATION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${LOCATION}/tuningJobs" \ -d \ $'{    "baseModel": "gemini-2.5-flash",    "supervisedTuningSpec" : {       "training_dataset_uri": "gs://cloud-samples-data/ai-platform/generative_ai/gemini/text/sft_train_data.jsonl",       "validation_dataset_uri": "gs://cloud-samples-data/ai-platform/generative_ai/gemini/text/sft_validation_data.jsonl"    },    "tunedModelDisplayName": "tuned_gemini" }' 

Colab Enterprise

Puoi creare un job di ottimizzazione del modello in Vertex AI utilizzando il riquadro laterale in Colab Enterprise. Il riquadro laterale aggiunge gli snippet di codice pertinenti al notebook. Puoi quindi modificare gli snippet di codice ed eseguirli per creare il job di ottimizzazione. Per saperne di più sull'utilizzo del riquadro laterale con i job di ottimizzazione di Vertex AI, consulta Interagire con Vertex AI per ottimizzare un modello.

1. Nella console Google Cloud , vai alla pagina I miei blocchi note di Colab Enterprise.

   Vai a I miei notebook

2. Nel menu Regione, seleziona la regione che contiene il notebook.

3. Fai clic sul notebook che vuoi aprire. Se non hai ancora creato un blocco note, creane uno.

4. A destra del notebook, nel riquadro laterale, fai clic sul pulsante  Ottimizzazione.

   Il riquadro laterale espande la scheda Sintonizzazione.

5. Fai clic sul pulsante Ottimizza un modello Gemini.

   Colab Enterprise aggiunge celle di codice al notebook per ottimizzare un modello Gemini.

6. Nel notebook, individua la cella di codice che memorizza i valori dei parametri. Utilizzerai questi parametri per interagire con Vertex AI.

7. Aggiorna i valori dei seguenti parametri:

   • PROJECT_ID: l'ID del progetto in cui si trova il notebook.
   • REGION: la regione in cui si trova il notebook.
   • TUNED_MODEL_DISPLAY_NAME: il nome del modello ottimizzato.

8. Nella cella di codice successiva, aggiorna i parametri di ottimizzazione del modello:

   • source_model: il modello Gemini che vuoi utilizzare, ad esempio gemini-2.0-flash-001.
   • train_dataset: l'URL del set di dati di addestramento.
   • validation_dataset: l'URL del set di dati di convalida.
   • Regola i parametri rimanenti in base alle tue esigenze.

9. Esegui le celle di codice che il riquadro laterale ha aggiunto al notebook.

10. Dopo l'esecuzione dell'ultima cella di codice, fai clic sul pulsante  Visualizza job di ottimizzazione visualizzato.

11. Il riquadro laterale mostra informazioni sul job di ottimizzazione del modello.

    • La scheda Monitora mostra le metriche di ottimizzazione quando sono pronte.
    • La scheda Set di dati mostra un riepilogo e le metriche relative al tuo set di dati dopo l'elaborazione.
    • La scheda Dettagli mostra informazioni sul job di ottimizzazione, ad esempio il metodo di ottimizzazione e il modello di base (modello di origine) che hai utilizzato.

12. Al termine del job di ottimizzazione, puoi passare direttamente dalla scheda Dettagli ottimizzazione a una pagina in cui puoi testare il modello. Fai clic su Testa.

    La console Google Cloud si apre alla pagina Chat di testo di Vertex AI, dove puoi testare il modello.

Console

Per visualizzare i job di ottimizzazione nella console Google Cloud , vai alla pagina Vertex AI Studio.

Vai a Vertex AI Studio

I job di ottimizzazione di Gemini sono elencati nella tabella Modelli ottimizzati con Gemini Pro.

SDK Google Gen AI

from google import genai from google.genai.types import HttpOptions  client = genai.Client(http_options=HttpOptions(api_version="v1"))  responses = client.tunings.list() for response in responses:     print(response.name)     # Example response:     # projects/123456789012/locations/us-central1/tuningJobs/123456789012345 

SDK Vertex AI per Python

import vertexai from vertexai.tuning import sft  # TODO(developer): Update and un-comment below line # PROJECT_ID = "your-project-id" vertexai.init(project=PROJECT_ID, location="us-central1")  responses = sft.SupervisedTuningJob.list()  for response in responses:     print(response) # Example response: # <vertexai.tuning._supervised_tuning.SupervisedTuningJob object at 0x7c85287b2680> # resource name: projects/12345678/locations/us-central1/tuningJobs/123456789012345 

REST

Per visualizzare un elenco dei job di ottimizzazione del modello, invia una richiesta GET utilizzando il metodo tuningJobs.list.

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

• PROJECT_ID: .
• TUNING_JOB_REGION: la regione in cui viene eseguito il job di ottimizzazione. Questa è anche la regione predefinita in cui viene caricato il modello ottimizzato.

Metodo HTTP e URL:

GET https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs

Per inviare la richiesta, scegli una di queste opzioni:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente.

 {   "tuning_jobs": [     TUNING_JOB_1, TUNING_JOB_2, ...   ] } 

Console

1. Per visualizzare i dettagli di un modello ottimizzato nella console Google Cloud , vai alla pagina Vertex AI Studio.

   Vai a Vertex AI Studio

2. Nella tabella Modelli ottimizzati con Gemini Pro, trova il tuo modello e fai clic su Dettagli.

   Viene visualizzata la pagina dei dettagli del modello.

SDK Google Gen AI

from google import genai from google.genai.types import HttpOptions  client = genai.Client(http_options=HttpOptions(api_version="v1"))  # Get the tuning job and the tuned model. # Eg. tuning_job_name = "projects/123456789012/locations/us-central1/tuningJobs/123456789012345" tuning_job = client.tunings.get(name=tuning_job_name)  print(tuning_job.tuned_model.model) print(tuning_job.tuned_model.endpoint) print(tuning_job.experiment) # Example response: # projects/123456789012/locations/us-central1/models/1234567890@1 # projects/123456789012/locations/us-central1/endpoints/123456789012345 # projects/123456789012/locations/us-central1/metadataStores/default/contexts/tuning-experiment-2025010112345678 

SDK Vertex AI per Python

import vertexai from vertexai.tuning import sft  # TODO(developer): Update and un-comment below lines # PROJECT_ID = "your-project-id" # LOCATION = "us-central1" vertexai.init(project=PROJECT_ID, location=LOCATION)  tuning_job_id = "4982013113894174720" response = sft.SupervisedTuningJob(     f"projects/{PROJECT_ID}/locations/{LOCATION}/tuningJobs/{tuning_job_id}" )  print(response) # Example response: # <vertexai.tuning._supervised_tuning.SupervisedTuningJob object at 0x7cc4bb20baf0> # resource name: projects/1234567890/locations/us-central1/tuningJobs/4982013113894174720 

REST

Per ottenere i dettagli di un job di ottimizzazione del modello, invia una richiesta GET utilizzando il metodo tuningJobs.get e specifica TuningJob_ID.

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

• PROJECT_ID: .
• TUNING_JOB_REGION: la regione in cui viene eseguito il job di ottimizzazione. Questa è anche la regione predefinita in cui viene caricato il modello ottimizzato.
• TUNING_JOB_ID: l'ID del job di ottimizzazione.

Metodo HTTP e URL:

GET https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs/TUNING_JOB_ID

Per inviare la richiesta, scegli una di queste opzioni:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs/TUNING_JOB_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs/TUNING_JOB_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente.

 {   "name": "projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs/TUNING_JOB_ID",   "tunedModelDisplayName": "TUNED_MODEL_DISPLAYNAME",   "createTime": CREATE_TIME,   "endTime": END_TIME,   "tunedModel": {       "model": "projects/PROJECT_ID/locations/TUNING_JOB_REGION/models/MODEL_ID",       "endpoint": "projects/PROJECT_ID/locations/TUNING_JOB_REGION/endpoints/ENDPOINT_ID"   },   "experiment": "projects/PROJECT_ID/locations/TUNING_JOB_REGION/metadataStores/default/contexts/EXPERIMENT_ID",   "tuning_data_statistics": {       "supervisedTuningDataStats": {           "tuninDatasetExampleCount": "TUNING_DATASET_EXAMPLE_COUNT",           "totalBillableTokenCount": "TOTAL_BILLABLE_TOKEN_COUNT",           "tuningStepCount": "TUNING_STEP_COUNT"       }   },   "status": "STATUS",   "supervisedTuningSpec" : {         "trainingDatasetUri": "TRAINING_DATASET_URI",         "validationDataset_uri": "VALIDATION_DATASET_URI",         "hyperParameters": {             "epochCount": EPOCH_COUNT,             "learningRateMultiplier": LEARNING_RATE_MULTIPLIER         }     } } 

Console

1. Per annullare un job di ottimizzazione nella console Google Cloud , vai alla pagina Vertex AI Studio.

   Vai a Vertex AI Studio

2. Nella tabella Modelli Gemini Pro ottimizzati, fai clic su more_vert Gestisci esecuzione.

3. Fai clic su Annulla.

SDK Vertex AI per Python

import vertexai from vertexai.tuning import sft  # TODO(developer): Update and un-comment below lines # PROJECT_ID = "your-project-id" # LOCATION = "us-central1" vertexai.init(project=PROJECT_ID, location=LOCATION)  tuning_job_id = "4982013113894174720" job = sft.SupervisedTuningJob(     f"projects/{PROJECT_ID}/locations/{LOCATION}/tuningJobs/{tuning_job_id}" ) job.cancel()

REST

Per annullare un job di ottimizzazione del modello, invia una richiesta POST utilizzando il metodo tuningJobs.cancel e specifica TuningJob_ID.

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

• PROJECT_ID: .
• TUNING_JOB_REGION: la regione in cui viene eseguito il job di ottimizzazione. Questa è anche la regione predefinita in cui viene caricato il modello ottimizzato.
• TUNING_JOB_ID: l'ID del job di ottimizzazione.

Metodo HTTP e URL:

POST https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs/TUNING_JOB_ID:cancel

Per inviare la richiesta, scegli una di queste opzioni:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs/TUNING_JOB_ID:cancel"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/tuningJobs/TUNING_JOB_ID:cancel" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente.

 {} 

Console

1. Per testare un modello ottimizzato nella Google Cloud console, vai alla pagina Vertex AI Studio.

   Vai a Vertex AI Studio

2. Nella tabella Modelli ottimizzati con Gemini Pro, trova il tuo modello e fai clic su Testa.

   Si apre una nuova pagina in cui puoi creare una conversazione con il modello personalizzato.

SDK Google Gen AI

from google import genai from google.genai.types import HttpOptions  client = genai.Client(http_options=HttpOptions(api_version="v1"))  # Get the tuning job and the tuned model. # Eg. tuning_job_name = "projects/123456789012/locations/us-central1/tuningJobs/123456789012345" tuning_job = client.tunings.get(name=tuning_job_name)  contents = "Why is the sky blue?"  # Predicts with the tuned endpoint. response = client.models.generate_content(     model=tuning_job.tuned_model.endpoint,     contents=contents, ) print(response.text) # Example response: # The sky is blue because ... 

SDK Vertex AI per Python

from vertexai.generative_models import GenerativeModel  sft_tuning_job = sft.SupervisedTuningJob("projects/<PROJECT_ID>/locations/<TUNING_JOB_REGION>/tuningJobs/<TUNING_JOB_ID>") tuned_model = GenerativeModel(sft_tuning_job.tuned_model_endpoint_name) print(tuned_model.generate_content(content)) 

REST

Per testare un modello ottimizzato con un prompt, invia una richiesta POST e specifica TUNED_ENDPOINT_ID.

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

• PROJECT_ID: .
• TUNING_JOB_REGION: la regione in cui viene eseguito il job di ottimizzazione. Questa è anche la regione predefinita in cui viene caricato il modello ottimizzato.
• ENDPOINT_ID: l'ID endpoint del modello ottimizzato dall'API GET.
• TEMPERATURE: la temperatura viene utilizzata per il campionamento durante la generazione della risposta, che si verifica quando vengono applicati topP e topK. La temperatura controlla il grado di casualità nella selezione dei token. Le temperature basse sono ideali per prompt che richiedono risposte meno aperte o creative, mentre le temperature più alte possono portare a risultati più diversificati o creativi. Una temperatura pari a 0 indica che vengono sempre selezionati i token con la probabilità più alta. In questo caso, le risposte a un determinato prompt sono per lo più deterministiche, ma è comunque possibile una piccola variazione.

  Se il modello restituisce una risposta troppo generica, troppo breve o fornisce una risposta di riserva, prova ad aumentare la temperatura.

• TOP_P: Top-P cambia il modo in cui il modello seleziona i token per l'output. I token vengono selezionati dal più probabile al meno probabile finché la somma delle loro probabilità non corrisponde al valore di Top-P. Ad esempio, se i token A, B e C hanno una probabilità di 0,3, 0,2 e 0,1 e il valore di top-P è 0.5, il modello seleziona A o B come token successivo utilizzando la temperatura ed esclude C come candidato.

  Specifica un valore più basso per risposte meno casuali e un valore più alto per risposte più casuali.

• TOP_K: Top-K cambia il modo in cui il modello seleziona i token per l'output. Un top-K pari a 1 indica che il token successivo selezionato è il più probabile tra tutti i token nel vocabolario del modello (chiamato anche decodifica greedy). Un top-K pari a 3 indica, invece, che il token successivo viene selezionato tra i tre token più probabili (utilizzando la temperatura).

  Per ogni fase di selezione dei token, vengono campionati i token Top-K con le probabilità più alte. Quindi i token vengono ulteriormente filtrati in base a top-P e il token finale viene selezionato utilizzando il campionamento con temperatura.

  Specifica un valore più basso per risposte meno casuali e un valore più alto per risposte più casuali.

• MAX_OUTPUT_TOKENS: il numero massimo di token che possono essere generati nella risposta. Un token equivale a circa quattro caratteri. 100 token corrispondono a circa 60-80 parole.

  Specifica un valore più basso per risposte più brevi e un valore più alto per risposte potenzialmente più lunghe.

Metodo HTTP e URL:

POST https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/endpoints/ENDPOINT_ID:generateContent

Corpo JSON della richiesta:

 {     "contents": [         {             "role": "USER",             "parts": {                 "text" : "Why is sky blue?"             }         }     ],     "generation_config": {         "temperature":TEMPERATURE,         "topP": TOP_P,         "topK": TOP_K,         "maxOutputTokens": MAX_OUTPUT_TOKENS     } } 

Per inviare la richiesta, scegli una di queste opzioni:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/endpoints/ENDPOINT_ID:generateContent"

$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://TUNING_JOB_REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/TUNING_JOB_REGION/endpoints/ENDPOINT_ID:generateContent" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente.

 {   "candidates": [     {       "content": {         "role": "model",         "parts": [Why is sky blue?           {             "text": "The sky appears blue due to a phenomenon called Rayleigh scattering, where shorter blue wavelengths of sunlight are scattered more strongly by the Earth's atmosphere than longer red wavelengths."           }         ]       },       "finishReason": "STOP",       "safetyRatings": [         {           "category": "HARM_CATEGORY_HATE_SPEECH",           "probability": "NEGLIGIBLE",           "probabilityScore": 0.06325052,           "severity": "HARM_SEVERITY_NEGLIGIBLE",           "severityScore": 0.03179867         },         {           "category": "HARM_CATEGORY_DANGEROUS_CONTENT",           "probability": "NEGLIGIBLE",           "probabilityScore": 0.09334688,           "severity": "HARM_SEVERITY_NEGLIGIBLE",           "severityScore": 0.027742893         },         {           "category": "HARM_CATEGORY_HARASSMENT",           "probability": "NEGLIGIBLE",           "probabilityScore": 0.17356819,           "severity": "HARM_SEVERITY_NEGLIGIBLE",           "severityScore": 0.025419652         },         {           "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",           "probability": "NEGLIGIBLE",           "probabilityScore": 0.07864238,           "severity": "HARM_SEVERITY_NEGLIGIBLE",           "severityScore": 0.020332353         }       ]     }   ],   "usageMetadata": {     "promptTokenCount": 5,     "candidatesTokenCount": 33,     "totalTokenCount": 38   } } 

SDK Vertex AI per Python

from google.cloud import aiplatform  aiplatform.init(project=PROJECT_ID, location=LOCATION)  # To find out which models are available in Model Registry models = aiplatform.Model.list()  model = aiplatform.Model(MODEL_ID) model.delete() 

REST

Chiama il metodo models.delete.

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

• PROJECT_ID: .
• REGION: la regione in cui si trova il modello ottimizzato.
• MODEL_ID: il modello da eliminare.

Metodo HTTP e URL:

DELETE https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/models/MODEL_ID

Per inviare la richiesta, scegli una di queste opzioni:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/models/MODEL_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/models/MODEL_ID" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.