Gli agenti gestiti sull'API Gemini ti offrono un'interfaccia di agente 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.
Guida rapida
Effettua la tua prima chiamata con un agente, trasmetti in streaming le risposte e crea un agente personalizzato.
Agente Antigravity
Funzionalità, strumenti, input multimodale e prezzi per l'agente predefinito.
Agent in AI Studio
Playground visivo per la prototipazione di agenti senza scrivere codice.
Agenti gestiti disponibili
- Agente antigravità: agente gestito per uso generico basato su Gemini 3.5 Flash. Esegue il codice, gestisce i file e cerca sul web all'interno di una sandbox Linux sicura ospitata da Google. Puoi 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).
API e strumenti 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. Le credenziali possono essere inserite in modo sicuro tramite le trasformazioni delle intestazioni del proxy in uscita e non vengono mai esposte 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 di cui vuoi concedere l'ambito completo.
- Ruota le credenziali in base a una pianificazione regolare.
Per informazioni dettagliate sulla configurazione delle trasformazioni delle intestazioni, vedi Credenziali.
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 a 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à.
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 maggiori informazioni sull'immagine di base dell'ambiente, consulta Software preinstallato. |
| Max agents | Puoi avere fino a 1000 agenti gestiti. |
Framework degli agenti
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 flussi di lavoro 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 creare e orchestrare agenti di IA interoperabili.
- SDK Antigravity: crea agenti AI autonomi utilizzando gli stessi strumenti, lo stesso ciclo di agenti e la stessa gestione del contesto che alimentano Google Antigravity, programmabile in Python.