Panoramica sugli agenti

Gli agenti gestiti nell'API Gemini ti offrono un'interfaccia di test configurabile. Una singola chiamata API esegue il provisioning di un sandbox Linux in cui l'agente ragiona, esegue il codice, gestisce i file e naviga sul web in modo autonomo.

Agenti gestiti disponibili

• Agente antigravità: agente gestito di uso generale creato con Gemini 3.8 Flash. Esegue il codice, gestisce i file e cerca sul web all'interno di una sandbox Linux sicura ospitata da Google. Puoi configurare il modello sottostante (ad esempio Gemini 3.7 Flash, Gemini 3.6 Flash o Gemini 3.5 Flash) utilizzando agent_config ed estenderlo con istruzioni, competenze e dati personalizzati per creare un agente personalizzato.
• Deep Research: agente di ricerca autonomo che pianifica, esegue e sintetizza attività di ricerca in più fasi per casi d'uso come analisi di mercato, due diligence e revisioni della letteratura.

Sicurezza e best practice

Ogni agente viene eseguito in un ambiente sandbox isolato a livello di sistema operativo. Per impostazione predefinita, la sandbox ha accesso alla rete in uscita senza restrizioni. Puoi limitare o disattivare l'accesso alla rete utilizzando una lista consentita.

Accesso alla rete

Per impostazione predefinita, gli ambienti hanno accesso alla rete in uscita senza limitazioni. Utilizza una network lista consentita per limitare il traffico in uscita a domini specifici o pattern jolly. Per i dettagli della configurazione, vedi Lista consentita di rete (AI Studio) o Regole di rete (API).

Strumenti e API esterni

Puoi collegare strumenti e API esterni per estendere l'agente. Utilizza solo strumenti provenienti da fonti attendibili e limita le autorizzazioni al minimo necessario. Archivia i secret come credenziali gestite e fai riferimento a questi tramite ID, in modo che il proxy di uscita li inserisca al momento della richiesta e non vengano mai esposti all'interno della sandbox. L'agente può utilizzare qualsiasi credenziale a cui ha accesso, quindi fornisci solo le credenziali di cui vuoi concedere l'ambito completo.

• Utilizza service account o chiavi API con privilegi minimi.
• Preferisci i token di breve durata alle chiavi di lunga durata.
• Fornisci solo le credenziali per cui vuoi concedere l'ambito completo.
• Ruota le credenziali in base a una pianificazione regolare.

Per i tipi di credenziali e le operazioni di gestione, vedi Credenziali. Puoi anche impostare le intestazioni in linea in una regola della lista consentita. Consulta la sezione Configurazione di rete.

Supervisione umana

Verifica sempre gli output (codice generato, trasformazioni dei dati, modifiche alla configurazione) prima di eseguirne il deployment, soprattutto per le attività che modificano i dati o interagiscono con sistemi esterni.

Prezzi

Gli agenti gestiti utilizzano un modello con pagamento a consumo basato sui token del modello Gemini e sull'utilizzo degli strumenti. Una singola interazione può attivare più cicli di ragionamento, in genere consumando da 100.000 a 3 milioni di token. Il calcolo dell'ambiente non viene fatturato durante l'anteprima. Consulta i costi stimati per le suddivisioni per attività. Gli agenti gestiti sono disponibili anche nel Livello senza costi con un limite di frequenza e una quota di utilizzo senza costi.

Limiti

Limite	Descrizione
Durata dell'ambiente	Gli ambienti vengono eliminati definitivamente dopo 7 giorni di inattività.
VM Spin-down	Le VM vengono arrestate dopo un breve periodo di inattività per risparmiare risorse. La richiesta successiva ripristina lo stato (con un avvio a freddo).
Software preinstallato	Ambiente basato su Ubuntu con Python 3.12 e Node.js 22. Per ulteriori informazioni sull'immagine di base dell'ambiente, consulta Software preinstallato.
Max agents	Puoi avere fino a 1000 agenti gestiti.

Framework dell'agente

Puoi anche creare agenti con Gemini utilizzando questi framework e SDK:

• LangChain / LangGraph: crea flussi di applicazioni complessi e con stato e sistemi multi-agente utilizzando strutture di grafici.
• LlamaIndex: collega gli agenti Gemini ai tuoi dati privati per workflow migliorati con RAG.
• CrewAI: orchestra agenti AI autonomi collaborativi che interpretano ruoli.
• Vercel AI SDK: crea interfacce utente e agenti basati sull'AI in JavaScript/TypeScript.
• Google ADK: un framework open source per la creazione e l'orchestrazione di agenti AI interoperabili.
• Antigravity SDK: crea agenti AI autonomi utilizzando gli stessi strumenti, lo stesso loop dell'agente e la stessa gestione del contesto che alimentano Google Antigravity, programmabile in Python.