Gli agenti gestiti nell'API Gemini ti offrono un harness dell'agente configurabile. Una singola chiamata API esegue il provisioning di una 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 all'agente, trasmetti le risposte in streaming e crea un agente personalizzato.
Agente Antigravity
Funzionalità, strumenti, input multimodale e prezzi per l'agente predefinito.
Agenti in AI Studio
Playground visivo per la prototipazione di agenti senza scrivere codice.
Agenti gestiti disponibili
- Agente Antigravity: agente gestito per uso generico basato su Gemini 3.6 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 es. Gemini 3.6 Flash, Gemini 3.5 Flash o Gemini 3.5 Flash-Lite)
utilizzando
agent_config, ed estenderlo con le tue istruzioni, skill e dati 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 restrizioni. Utilizza una lista consentita network per limitare il traffico in uscita a domini specifici o pattern con caratteri jolly. Per i dettagli sulla 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. 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 sei disposto a concedere l'ambito completo.
- Utilizza service account o chiavi API con privilegi minimi.
- Prediligi i token di breve durata rispetto alle chiavi di lunga durata.
- Fornisci solo le credenziali di cui sei disposto a concedere l'ambito completo.
- Ruota le credenziali a intervalli regolari.
Per i dettagli 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 con pagamento a consumo basato sui token del modello Gemini e sull'utilizzo degli strumenti. Una singola interazione può attivare più loop 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à. |
| Arresto delle VM | 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, vedi Software preinstallato. |
| Numero massimo di agenti | 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 stateful e complessi e sistemi multi-agente utilizzando strutture di grafici.
- LlamaIndex: collega gli agenti Gemini ai tuoi dati privati per workflow ottimizzati per RAG.
- CrewAI
- Vercel AI SDK: crea interfacce utente e agenti basati sull'AI in JavaScript/TypeScript.
- Google ADK: An open-source framework for building and orchestrating interoperable AI agents.
- Antigravity SDK: Crea agenti AI autonomi utilizzando gli stessi strumenti, loop dell'agente e gestione del contesto che alimentano Google Antigravity, programmabile in Python.