Google ha introdotto Tool Retrieval in anteprima il 19 novembre, cambiando come si espongono grandi librerie di funzioni a Gemini. Gli sviluppatori possono rinviare gli schemi dei parametri finché il modello ne ha bisogno, anziché inviarli tutti a ogni richiesta.

L’annuncio colloca la funzione nell’Interactions API. Google punta a ridurre i token di input e mantenere accurata la scelta degli strumenti mentre la libreria cresce. Risparmio e affidabilità reali dipendono dal carico applicativo.

I nomi restano visibili mentre gli schemi attendono

Per attivare la ricerca server si aggiunge tool_search e si impostano le funzioni scelte con defer_loading: true. Il modello vede ancora nomi e descrizioni, mentre gli schemi dei parametri restano fuori dal contesto fino alla richiesta.

Scelta una funzione, il modello la richiede per nome. L’API carica lo schema e il modello genera la chiamata nella stessa richiesta. Ricerca, risultato e chiamata finale compaiono in interaction.steps, dove gli sviluppatori possono esaminarli.

L’esempio Google usa gemini-4-hydrogen per chiedere un rimborso di 40 dollari sull’ordine danneggiato A-1042. Il modello recupera issue_refund e produce ordine e importo come argomenti. L’applicazione deve ancora eseguire il rimborso e restituire function_result: recuperare lo schema non trasferisce denaro né autorizza transazioni.

Questo confine conta per gli strumenti sensibili. Migliorare la scoperta non sostituisce permessi, verifiche o regole aziendali.

La ricerca server non richiede un indice proprio

La modalità gestita dal server non impone di ospitare un indice di ricerca. Gli strumenti frequenti possono restare dichiarati integralmente e le funzioni occasionali essere differite. Nomi e descrizioni rimangono quindi importanti anche senza grandi schemi nel contesto iniziale.

La funzione supporta anche server MCP remoti. Con defer_loading: true su un mcp_server, gli strumenti si caricano al bisogno senza elencarli singolarmente.

Google afferma che il sistema funziona con la cache del prefisso: gli schemi differiti non entrano all’inizio del prompt, ma vengono aggiunti più avanti nella conversazione. Il prefisso memorizzato resta così stabile tra i turni. Gli schemi caricati successivamente non diventano gratuiti.

La ricerca client mantiene il controllo del registro

Le applicazioni con un registro, un indice di embedding o filtri di permessi per utente possono scegliere l’esecuzione client. Dichiarano tool_search con "execution": "client", una funzione di ricerca e i suoi parametri.

Quando il modello chiede una ricerca, l’applicazione la esegue e restituisce gli schemi corrispondenti tramite function_result. L’esempio di continuazione usa previous_interaction_id per collegare il seguito all’interazione esistente.

Ogni ricerca aggiunge un viaggio di andata e ritorno perché la consultazione avviene nell’applicazione. In cambio, non serve dichiarare tutti gli strumenti all’inizio. Un’integrazione collegata durante il dialogo può introdurne di nuovi e il registro applicativo decide i candidati restituiti.

Il compromesso è diverso dalla ricerca server. Il controllo sulla scoperta aggiunge una fase applicativa, con relativa latenza e gestione degli errori.

Il risparmio dipende dagli schemi mai caricati

Tool Retrieval non ha un costo separato. I token di input e output seguono le tariffe normali del modello scelto. tool_search aggiunge un piccolo blocco fisso di input e ogni schema caricato viene fatturato come input per il resto della conversazione.

Il risparmio deriva dagli schemi che non entrano mai nel contesto. Una grande libreria con pochi strumenti rilevanti offre più opportunità di una conversazione che carica quasi tutto. Google raccomanda misurazioni sul traffico reale e non indica una percentuale universale.

La preview supporta Gemini 3.6 e successivi, inclusi tutti i Gemini 4, nell’Interactions API. Non va estesa a ogni interfaccia API. Le prossime prove utili sono consumi di token, selezione degli strumenti e latenza della ricerca client dell’applicazione nelle condizioni supportate.

Articoli correlati
Fonti

Esplora la directory degli strumenti →