Interactions API: la nostra interfaccia principale per modelli e agenti Gemini

Oggi annunciamo che la Interactions API è diventata disponibile a livello generale e costituisce ora la nostra API principale per interagire con i modelli e gli agenti Gemini. Avevamo lanciato la beta pubblica nel dicembre 2025, e da allora è diventata il modo preferito dagli sviluppatori per creare applicazioni con Gemini.

Con questo rilascio GA, l'API ha ora uno schema stabile e abbiamo aggiunto importanti nuove funzionalità richieste dagli sviluppatori, tra cui Managed Agents, esecuzione in background, Gemini Omni (presto) e molto altro. Tutta la nostra documentazione ora utilizza di default Interactions API e stiamo collaborando con i partner dell'ecosistema per renderla l'interfaccia predefinita su SDK e librerie di terze parti.

Il modo più semplice per sviluppare con Gemini

Che tu stia chiamando un modello o eseguendo un agente, Interactions API ti porta a destinazione con poche righe di codice. Passa un ID modello per l'inferenza o un ID agente per attività autonome e imposta background=True per qualsiasi operazione a lunga esecuzione.

1from google import genai
2
3client = genai.Client()
4
5# Parla con un modello
6interaction = client.interactions.create(
7    model="gemini-3.5-flash",
8    input="Spiega l'entanglement quantistico in modo semplice.",
9)
10
11# Esegui un agente
12interaction = client.interactions.create(
13    agent="antigravity-preview-05-2026",
14    input="Traccia la crescita della generazione di energia solare a livello globale e crea delle slides in HTML.",
15    environment="remote",
16)

Novità principali da dicembre

• Managed Agents: Una singola chiamata API alloca un sandbox Linux remoto in cui un agente può ragionare, eseguire codice, navigare sul web e gestire file. L'agente Antigravity è quello predefinito e puoi definire i tuoi agenti personalizzati con istruzioni, competenze e fonti di dati.
• Esecuzione in background: Imposta background=True in qualsiasi chiamata. Il server esegue l'interazione in modo asincrono.
• Miglioramenti degli strumenti: Combina strumenti integrati, come Google Search e Google Maps, con le tue funzioni in una singola richiesta. I risultati degli strumenti ora possono restituire immagini insieme al testo.
• Deep Research aggiornamenti: Due nuove versioni dell'agente (velocità vs. profondità), pianificazione collaborativa, grafici e infografiche nativi, e grounding multimodale con immagini, PDF e audio.
• Generazione multimediale: Generazione di immagini con Nano Banana 2 e grounding con Google Image Search, musica con Lyria 3 e sintesi vocale espressiva con TTS multi-speaker.
• Da Ruoli a Passi: Schema semplificato in cui ogni azione (input_utente, pensiero, chiamata_funzione, output_modello, ecc.) è un passo tipizzato indipendente, sostituendo la vecchia struttura dei ruoli.
• Costi e ottimizzazioni per sviluppatori: I livelli Flex e Priority ti permettono di ottimizzare per costi o latenza (Flex offre una riduzione dei costi del 50%). Gli errori ora individuano il campo esatto. Le interazioni passate sono recuperabili con una conservazione di 55 giorni nel piano a pagamento.

Il nuovo standard per lo sviluppo

Interactions API è ora l'impostazione predefinita per Google AI Studio, Gemini API e tutta la nostra documentazione, che include un interruttore per passare i frammenti al formato legacy. Ti consigliamo di usare Interactions API per tutti i nuovi progetti e applicazioni.

Sebbene l'API legacy generateContent rimanga pienamente supportata e continuerà a ricevere nuovi modelli Gemini principali nel prossimo futuro, ci aspettiamo che le capacità all'avanguardia per modelli a lunga esecuzione e agenti vengano sempre più implementate esclusivamente su Interactions API. Questo perché è progettata fin dall'inizio per flussi di lavoro stateful e agentici. Abbiamo pubblicato una guida alla migrazione per aiutarti a effettuare la transizione al tuo ritmo.

Un ecosistema agent-first

La maggior parte degli sviluppatori sta ora utilizzando agenti di codifica (come Antigravity) per creare applicazioni. Per facilitare l'aggiornamento degli agenti con gli ultimi pattern API, abbiamo creato la gemini-interactions-api Skill. Questa inserisce pattern di best practice per lo sviluppo con Interactions API nel contesto del tuo agente (streaming, chiamata di funzioni, output strutturato, Deep Research e altro).

1npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

Inizia subito

Interactions API è disponibile tramite gli SDK Python e JavaScript. Se stai già sviluppando con uno dei nostri partner supportati, LiteLLM, Eigent o Agno, puoi iniziare a utilizzare le loro integrazioni API per Interactions oggi stesso.

Ottieni la tua chiave API da Google AI Studio e segui la documentazione di Interactions API per iniziare. Se stai migrando da generateContent, la nostra guida alla migrazione mappa ogni campo nel nuovo schema. Puoi anche visualizzare la specifica OpenAPI completa.

Interactions API è stata costruita grazie ai feedback degli sviluppatori, e questo focus non cambierà con la disponibilità generale. Raccontaci di cosa hai bisogno sul forum per sviluppatori.