Gemini 3.1 Pro Preview vs Customtools: quale usare?

Entrambi i nomi di Gemini 3.1 Pro sono ID ufficiali di modelli Google. gemini-3.1-pro-preview è il modello normale. gemini-3.1-pro-preview-customtools è una variante progettata per usare meglio gli strumenti personalizzati quando un agente ha accesso anche a bash. Il suffisso non significa «più ragionamento» e il modello normale supporta già le chiamate a funzioni.^[1]

Per la programmazione generale, l’analisi di documenti e le domande multimodali, Preview normale è un punto di partenza ragionevole. Valuta un confronto con Customtools quando il tuo agente sceglie ripetutamente un comando shell invece della funzione personalizzata che volevi usare. Questa raccomandazione segue la distinzione documentata; l’articolo non riporta un nuovo benchmark A/B.

I due ID del modello Gemini 3.1 Pro

Copia l’identificatore completo nella configurazione. Entrambi gli ID contengono preview; Customtools è una scelta separata all’interno della stessa famiglia di rilascio.

Google elenca i due nomi insieme nella pagina del modello. Avverte inoltre che la versione Customtools può mostrare variazioni di qualità nelle richieste che non traggono beneficio da quel flusso di strumenti. Un suffisso diverso è quindi un motivo per valutare un comportamento specifico, non la prova di un miglioramento generale.^[1]

La specifica condivisa del modello indica un limite di input di 1.048.576 token, un limite di output di 65.536 token, input multimodale e output testuale. Questi limiti principali non dicono quale strumento selezionerà un agente in una determinata conversazione. Distingui identificatore del modello, definizioni degli strumenti e risultato dell’attività quando confronti i risultati.

Cosa cambia con Customtools

Google descrive una preferenza per funzioni personalizzate come view_file e search_code quando è disponibile anche bash. Questo conta quando l’applicazione ha già definito strumenti con un ambito circoscritto e output e autorizzazioni prevedibili.^[1]

Considera un ipotetico assistente di programmazione con tre scelte: una funzione che legge un file, un’altra che cerca simboli nel repository e uno strumento shell generico. L’attività è trovare la definizione di una funzione. Sia una funzione di ricerca nel repository sia un comando shell potrebbero essere utili. La domanda utile è se il modello sceglie lo strumento più adatto al flusso di lavoro previsto dall’applicazione.

È uno scenario illustrativo, non una risposta registrata di uno dei due modelli. Customtools non garantisce una chiamata specifica, non elimina la necessità di dichiarare funzioni e non sostituisce i controlli delle autorizzazioni dell’applicazione. La tua applicazione continua a decidere se eseguire una chiamata e quale risultato restituire.

La distinzione è più rilevante dopo che hai osservato un problema nella selezione degli strumenti. Se il modello normale sceglie già la funzione prevista e completa l’attività, cambiare variante aggiunge un’altra variabile senza aver prima identificato un miglioramento da misurare.

Customtools non è un livello di ragionamento

Gemini 3.1 Pro ha livelli di ragionamento separati: low, medium e high. Il valore predefinito di generateContent nativo è high; minimal non è supportato per questo modello. Sono impostazioni di generazione, non ID alternativi del modello.^[2]

Passare da low a high può modificare il budget di ragionamento usato per un’attività. Cambiare l’ID del modello in Customtools mira al comportamento di selezione degli strumenti. Se cambi entrambi contemporaneamente, una risposta diversa non può dirti quale modifica abbia contato.

Per un confronto utile, mantieni lo stesso prompt, le dichiarazioni degli strumenti, la cronologia della conversazione, il livello di ragionamento e il limite di output. Google consiglia inoltre di mantenere temperature a 1.0 per Gemini 3. Confronta se il lavoro richiesto è stato completato, quali strumenti sono stati chiamati, se gli argomenti erano validi e quanto consumo ha riportato la risposta. Sono suggerimenti di valutazione, non vantaggi misurati di una delle varianti.

Puoi usare funzioni con Preview normale

La specifica ufficiale del modello normale indica il supporto delle chiamate a funzioni. Non serve il suffisso Customtools per dichiarare una funzione, ricevere una chiamata a funzione, eseguirla nell’applicazione e inviare il risultato.^[1]

Usa tools[].functionDeclarations nativo per l’interfaccia della funzione. Conserva le parti di contenuto e le firme di ragionamento restituite quando continui la conversazione. Un errore causato da una firma mancante, uno schema degli argomenti non valido o una risposta di strumento composta in modo errato è un problema di protocollo; cambiare nome del modello non dimostra che sia stato risolto.

Il riferimento API di Gemini 3.1 Pro elenca i campi nativi e i relativi vincoli. Inizia con una funzione piccola e un risultato verificabile prima di aggiungere un’intera raccolta di strumenti.

Scegli in base al tuo flusso di lavoro reale

Scegli prima Preview normale quando il lavoro consiste soprattutto in generazione di testo, spiegazione di codice, estrazione da documenti o analisi multimodale. È anche un punto di partenza valido per un’applicazione che usa strumenti. Definisci che cosa rende riuscito un risultato prima di valutarlo.

Confronta Customtools quando l’applicazione combina bash e strumenti personalizzati e hai un problema concreto di selezione da riprodurre. Mantieni un breve insieme di casi rappresentativi: uno in cui la funzione circoscritta è appropriata, uno che richiede davvero la shell e uno in cui non dovrebbe essere chiamato alcuno strumento. Esamina sia l’azione selezionata sia il risultato finale.

Non giudicare una variante solo dalla frequenza con cui chiama il tuo strumento preferito. Una chiamata a funzione non necessaria resta non necessaria. Un modello utile deve selezionare un’azione appropriata, fornire argomenti validi, interpretare il risultato e rispondere alla richiesta originale.

La pagina dei prezzi di Google raggruppa entrambi gli ID nella stessa tabella dei prezzi del modello. Questo non rende intercambiabili ragionamento, scelte del livello di elaborazione o consumo di token. Controlla le tariffe attuali applicabili ed esamina il consumo effettivo quando confronti le richieste.^[3]

Quale versione collega SeedRouter?

La pagina di Gemini 3.1 Pro usa gemini-3.1-pro-preview. La variante Customtools non è collegata da questa integrazione. La pagina offre il Playground del modello normale e i prezzi aggiornati dei gruppi; il riferimento API documenta gli attuali limiti delle verifiche.

Usa l’ID esatto del modello normale nella tua applicazione. Mantieni esplicite le impostazioni di elaborazione per una valutazione controllata e verifica il risultato sulla tua attività prima di considerare una configurazione adatta alla produzione.

Domande frequenti

Entrambi i nomi del modello Gemini 3.1 Pro sono ufficiali?

Sì. Google documenta sia gemini-3.1-pro-preview sia gemini-3.1-pro-preview-customtools nella stessa pagina del modello. Il secondo è una variante specializzata, non una grafia non ufficiale.

Customtools sostituisce le normali chiamate a funzioni?

No. Le normali chiamate a funzioni sono già disponibili in Preview normale. Customtools modifica la preferenza del modello in un flusso che combina strumenti personalizzati e bash; la tua applicazione continua a dichiarare ed eseguire le funzioni.

Customtools è sempre migliore per programmare?

Google non fa questa affermazione generale. La distinzione documentata riguarda la selezione degli strumenti e la pagina del modello avverte di variazioni di qualità al di fuori del flusso previsto. Confronta il comportamento di cui la tua applicazione di programmazione ha effettivamente bisogno.

Fonti

Verificato il 17 ottobre 2026. Il confronto precedente si basa sulla documentazione, non su un nuovo benchmark di qualità eseguito.

1. Google: specifica del modello Gemini 3.1 Pro — ID ufficiali, limiti di input/output, chiamate a funzioni e distinzione di Customtools.
2. Google: guida nativa a Gemini 3 per sviluppatori — livelli di ragionamento, impostazioni native delle richieste e indicazioni su temperature.
3. Google: prezzi dell’API Gemini — tabella ufficiale dei prezzi condivisa dai due ID del modello.