Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Guida per gli sviluppatori a Gemini 3.8 Flash

Gemini 3.8 Flash è il nostro modello più intelligente di sempre, che offre miglioramenti significativi rispetto a 3.7 Flash nell'ingegneria del software, nelle attività con agenti e nel ragionamento multi-step critico in domini specializzati. 3.8 Flash offre miglioramenti sostanziali rispetto a 3.7 Flash, avvicinandosi spesso alle prestazioni dei modelli pionieristici 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 agentico principale della famiglia Gemini 3, che colma il divario tra i modelli Gemini Pro di deep reasoning e i modelli Gemini Flash-Lite ad alto throughput, offrendo al contempo un'elevata efficienza dei token e un'elaborazione multimodale in più passaggi.

Rispetto a 3.7 Flash, 3.8 Flash offre una maggiore accuratezza e prestazioni più affidabili, ma con un consumo di token più elevato. Tuttavia, 3.8 Flash offre anche il controllo dello sforzo tramite i livelli di ragionamento per consentirti di modulare questo consumo. Con il livello di ragionamento medio, puoi comunque risolvere attività agentiche complesse riducendo al contempo il consumo di token. Puoi anche utilizzare livelli di ragionamento inferiori per le attività sensibili alla latenza per evitare completamente l'overhead di calcolo. Se vuoi ottimizzare l'efficienza di calcolo, valuta l'utilizzo di 3.7 Flash.

Specifiche e confronti dei modelli

La seguente tabella mette a confronto alcune delle specifiche di 3.8 Flash, 3.7 Flash e 3.1 Pro:

	Gemini 3.8 Flash	Gemini 3.7 Flash	Gemini 3.1 Pro
ID modello	`gemini-3.8-flash`	`gemini-3.7-flash`	`gemini-3.1-pro-preview`
Fase di lancio	GA	GA	Anteprima
Tipi di input	Testo, immagine, audio, video	Testo, immagine, audio, video	Testo, immagine, audio, video
Tipi di output	Testo	Testo	Testo
Finestra contestuale	1.048.576	1.048.576	1.048.576
Lunghezza massima dei token di output	65.536	65.536	65.536
Aree geografiche supportate	Globale, multiregionale	Globale, multiregionale	Globale
Livelli di ragionamento supportati	`LOW`, `MEDIUM`, `HIGH` (Valore predefinito: `MEDIUM`)	`LOW`, `MEDIUM`, `HIGH` (Valore predefinito: `MEDIUM`)	`LOW`, `MEDIUM`, `HIGH` (Predefinito: `HIGH`)
Scopo principale	Agentic Workflows, programmazione, comprensione interattiva dei video	Workflow agentici generali, orchestrazione in più fasi, programmazione	Ragionamento approfondito, attività ad alta complessità

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

Quali sono le novità di Gemini 3.8 Flash?

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

Benchmark di valutazione	3.8 Flash	3.7 Flash
Terminal-bench 2.1	90,8%	81,6%
SWE-Bench Pro	61,6%	60,4%
SWE-Atlas	51,9%	48,0%
τ³-bench Banking	38,1%	30,9%
CharXiv (multimodale)	86,2%	84,5%
GDP.pdf	35,0%	34,0%
Humanity's Last Exam (HLE)	45,4%	45,7%

Guida rapida

Prima di iniziare, devi autenticarti su Agent Platform utilizzando le Credenziali predefinite dell'applicazione (ADC) o una chiave API. Per saperne di più, consulta Inizia a utilizzare Gemini Enterprise Agent Platform.

Nei blocchi di codice seguenti, sostituisci PROJECT_ID con l'ID progetto.

Installazione

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

pip install --upgrade google-genai

Richiesta di base

Python

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)

REST

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 obbligatorie e convenzioni comportamentali

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

Parametri di campionamento deprecati (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 rigide per la chiamata di funzione: un turno FunctionResponse deve corrispondere rigorosamente a id, name e al conteggio delle esecuzioni del FunctionCall precedente.
- Asset multimodali: inserisci sempre gli asset multimodali all'interno del payload della risposta.
- Formattazione e testo pre-strumento: formatta le istruzioni in linea utilizzando \n\n. Se riscontri errori Malformed_Function_Call legati al testo pre-strumento, ripulisci i commenti iniziali prima delle chiamate allo strumento.
- Per passare note di lavoro intermedie o aggiornamenti di stato prima di una chiamata allo strumento, inseriscili in una chiamata di funzione update() dedicata anziché generare 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 del ruolo "model".
- I turni precompilati del modello non sono supportati e devono essere rimossi durante l'upgrade.
- Le battute vuote nella cronologia delle conversazioni vengono eliminate 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, segui questi passaggi:

Aggiorna l'ID modello: modifica la stringa del modello nelle chiamate API in gemini-3.8-flash.
Sostituisci il parametro del budget di ragionamento: sostituisci le configurazioni di numeri interi thinking_budget con l'enum di stringhe thinking_level impostato su uno dei seguenti valori:
- HIGH: consigliato per QA visiva densa, rilevamento di movimenti in una frazione 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 domande e risposte generali sui video, riassunti delle lezioni e recupero di clip.
- LOW: consigliato per attività come ricerche rapide incentrate sulla trascrizione o estrazione di metadati di base.
Rimuovi i parametri deprecati e non supportati:
- Rimuovi temperature, top_p e top_k.
- Rimuovi candidate_count, frequency_penalty e presence_penalty.
- Rimuovi eventuali turni precompilati del modello dalle cronologie delle conversazioni.

Elenco di controllo di riepilogo per gli sviluppatori

ID modello di destinazione: gemini-3.8-flash

Utilizza thinking_level (MEDIUM per impostazione predefinita; valori validi: LOW, MEDIUM, HIGH) anziché i campi deprecati thinking_budget o temperature. MINIMAL non è supportato per questo modello.

Rimuovi i seguenti parametri non supportati: frequency_penalty, presence_penalty, candidate_count, temperature, top_p e top_k.

Rimuovi eventuali turni precompilati del modello dalle cronologie delle richieste di chat a più turni.

Assicurati che la corrispondenza di FunctionResponse sia rigorosa (id o call_id e name) e formatta le istruzioni pre-tool con \n\n.