Guida per gli sviluppatori a Gemini 3.8 Flash

Gemini 3.8 Flash è il nostro modello per la programmazione e gli agenti più intelligente di sempre, che offre miglioramenti significativi rispetto a 3.7 Flash in termini di ingegneria del software, attività agentiche e ragionamento multi-step critico in domini specializzati. 3.8 Flash offre miglioramenti sostanziali rispetto a 3.7 Flash, spesso avvicinandosi alle prestazioni dei modelli pioneristici più costosi.

Questo documento illustra le novità di 3.8 Flash, come si inserisce nella famiglia di modelli Gemini, come eseguire la migrazione a 3.8 Flash e fornisce una guida rapida per l'utilizzo di 3.8 Flash.

Come si inserisce nella famiglia Gemini?

La linea Gemini Flash è il modello di riferimento per le attività agentiche nella famiglia Gemini 3, colmando il divario tra i modelli Pro di ragionamento approfondito e i modelli Gemini Flash-Lite ad alta velocità di trasmissione, offrendo al contempo un'elevata efficienza dei token ed elaborazione multimodale in più fasi.

Rispetto a 3.7 Flash, 3.8 Flash offre una maggiore precisione e prestazioni più affidabili a costo di un maggiore consumo di token. Tuttavia, 3.8 Flash include anche il controllo dello sforzo tramite i livelli di ragionamento per modulare questo consumo. Al livello di ragionamento medio, puoi comunque risolvere attività agentiche complesse riducendo il consumo di token. Puoi anche utilizzare livelli di ragionamento inferiori per le attività sensibili alla latenza per evitare completamente il sovraccarico di calcolo. Se vuoi ottimizzare l'efficienza di calcolo, valuta la possibilità di utilizzare 3.7 Flash.

Specifiche e confronti dei modelli

La seguente tabella è un confronto che copre alcune delle specifiche tra 3.8 Flash, 3.7 Flash e 3.1 Pro:

Per l'elenco completo delle funzionalità, degli strumenti e delle opzioni di consumo supportati, consulta la pagina del modello 3.8 Flash.

Novità di Gemini 3.8 Flash

La seguente tabella confronta i benchmark di valutazione standard per gli sviluppatori tra Gemini 3.8 Flash e 3.7 Flash:

Guida rapida

Prima di iniziare, devi eseguire l'autenticazione ad Agent Platform utilizzando le credenziali predefinite dell'applicazione (ADC) o una chiave API. Per ulteriori informazioni, consulta la pagina Inizia a utilizzare Gemini Enterprise Agent Platform.

Nei seguenti blocchi di codice, sostituisci PROJECT_ID con il tuo ID progetto.

Installazione

Assicurati di utilizzare l'SDK google-genai più recente:

pip install --upgrade google-genai

Richiesta di base

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.8-flash",
  contents="How does AI work?",
)
print(response.text)

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.8-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Regole API e convenzioni comportamentali obbligatorie

Gemini 3.8 Flash applica rigorosamente le seguenti convenzioni API standard della famiglia Gemini 3:

• Parametri di campionamento ritirati (temperature, top_k, top_p): questi parametri vengono ignorati dal backend. Puoi invece controllare il determinismo utilizzando thinking_level (LOW, MEDIUM, HIGH) e response_schema o json_schema.
• Parametri non supportati (frequency_penalty, presence_penalty, candidate_count): il passaggio di frequency_penalty, presence_penalty o candidate_count genererà un errore API attivo. Rimuovili dal codice client legacy.

• Regole di chiamata di funzione rigorose: un turno FunctionResponse deve corrispondere esattamente a id, name e al conteggio di esecuzione del precedente FunctionCall.

  • Asset multimodali: inserisci sempre gli asset multimodali nel payload della risposta.
  • Formattazione e testo pre-strumento: formatta le istruzioni in linea utilizzando \n\n. Se riscontri errori Malformed_Function_Call associati al testo pre-strumento, pulisci i commenti iniziali prima delle chiamate agli strumenti.

  • Per passare note di lavoro intermedie o aggiornamenti di stato prima di una chiamata allo strumento, racchiudili in una chiamata di funzione update() dedicata anziché emettere XML o testo non elaborato:

    {
      "name": "update",
      "description": "Update working notes before tool execution",
      "parameters": {
        "type": "OBJECT",
        "properties": {
          "previous_step": {"type": "STRING"},
          "plan": {"type": "STRING"},
          "next_step": {"type": "STRING"}
        },
        "required": ["previous_step", "plan", "next_step"]
      }
    }
    

• Convalida della sequenza di chat:

  • I payload della cronologia non possono terminare con un turno di ruolo "model".
  • I turni precompilati del modello non sono supportati e devono essere rimossi durante l'upgrade.
  • I turni vuoti nella cronologia delle conversazioni vengono eliminati automaticamente o generano errori di convalida.

3.8 Flash da 3.7 Flash o 3.6 Flash

Per eseguire la migrazione a 3.8 Flash da 3.7 Flash o 3.6 Flash:

1. Aggiorna l'ID modello: modifica la stringa del modello nelle chiamate API in gemini-3.8-flash.
2. Sostituisci il parametro del budget di ragionamento: sostituisci le configurazioni intere thinking_budget con l'enumerazione di stringhe thinking_level impostata su uno dei seguenti valori:
   • HIGH: consigliato per QA visiva densa, rilevamento di movimenti in frazioni di secondo (sport, editing) o ragionamento multi-step su video di oltre 60 minuti.
   • MEDIUM: il livello di ragionamento predefinito. Questo livello offre un equilibrio ottimale per le domande e risposte video generali, il riepilogo delle lezioni e il recupero dei clip.
   • LOW: consigliato per attività come ricerche rapide incentrate sulla trascrizione o estrazione di metadati di base.
3. Rimuovi i parametri ritirati e non supportati:
   • Rimuovi temperature, top_p e top_k.
   • Rimuovi candidate_count, frequency_penalty e presence_penalty.
   • Rimuovi tutti i turni precompilati del modello dalle cronologie delle conversazioni.

Elenco di controllo riepilogativo per gli sviluppatori

Risorse aggiuntive

• Pagina del modello Gemini 3.8 Flash
• Notebook introduttivo