Présentation des agents

Les agents gérés de l'API Gemini vous offrent un harnais d'agent configurable. Un seul appel d'API provisionne un bac à sable Linux dans lequel l'agent raisonne, exécute du code, gère des fichiers et navigue sur le Web de manière autonome.

Agents gérés disponibles

  • Agent Antigravity : à usage général agent géré basé sur Gemini 3.7 Flash. Exécute du code, gère des fichiers et effectue des recherches sur le Web dans un bac à sable Linux sécurisé hébergé par Google. Vous pouvez configurer le modèle sous-jacent (par exemple, Gemini 3.7 Flash, Gemini 3.6 Flash ou Gemini 3.5 Flash) à l'aide de agent_config, et l'étendre avec vos propres instructions, compétences et données pour créer un agent personnalisé.
  • Deep Research : agent de recherche autonome qui planifie, exécute et synthétise des tâches de recherche en plusieurs étapes pour des cas d'utilisation tels que l'analyse de marché, la diligence raisonnable et les revues de littérature.

Sécurité et bonnes pratiques

Chaque agent s'exécute dans un environnement de bac à sable isolé au niveau du système d'exploitation. Par défaut, le bac à sable dispose d'un accès réseau sortant illimité. Vous pouvez limiter ou désactiver l'accès réseau à l'aide d'une liste d'autorisation.

Accès au réseau

Par défaut, les environnements disposent d'un accès réseau sortant illimité. Utilisez une liste d'autorisation network pour limiter le trafic sortant à des domaines spécifiques ou à des modèles génériques. Pour plus d'informations sur la configuration, consultez Liste d'autorisation réseau (AI Studio) ou Règles réseau (API).

Outils et API externes

Vous pouvez connecter des outils et des API externes pour étendre l'agent. N'utilisez que des outils provenant de sources fiables et limitez les autorisations au minimum requis. Les identifiants peuvent être injectés de manière sécurisée via des transformations d'en-tête de proxy de sortie et ne sont jamais exposés dans le bac à sable. L'agent peut utiliser n'importe quel identifiant auquel il a accès. Ne fournissez donc que les identifiants dont vous êtes prêt à accorder la portée complète.

  • Utilisez des comptes de service ou des clés API basés sur le principe du moindre privilège.
  • Préférez les jetons à courte durée de vie aux clés à longue durée de vie.
  • Ne fournissez que les identifiants dont vous êtes prêt à accorder la portée complète.
  • Effectuez une rotation régulière des identifiants.

Pour en savoir plus sur la configuration des transformations d'en-tête, consultez Identifiants.

Supervision humaine

Vérifiez toujours les sorties (code généré, transformations de données, modifications de configuration) avant de les déployer, en particulier pour les tâches qui modifient des données ou interagissent avec des systèmes externes.

Tarifs

Les agents gérés utilisent un modèle de paiement à l'usage basé sur les jetons de modèle Gemini et l'utilisation des outils. Une seule interaction peut déclencher plusieurs boucles de raisonnement, consommant généralement entre 100 000 et 3 millions de jetons. Le calcul de l'environnement n'est pas facturé pendant la version Preview. Consultez les coûts estimés pour les répartitions par tâche. Les agents gérés sont également disponibles dans le niveau sans frais avec une limite de débit et un quota d'utilisation sans frais.

Limites

Limite Description
Durée de vie de l'environnement Les environnements sont définitivement supprimés après sept jours d'inactivité.
Arrêt de la VM Les VM s'éteignent après une brève période d'inactivité pour économiser des ressources. La requête suivante restaure l'état (avec un démarrage à froid).
Logiciel pré-installé Environnement basé sur Ubuntu avec Python 3.12 et Node.js 22. Pour en savoir plus sur l'image de base de l'environnement, consultez Logiciel pré-installé.
Nombre maximal d'agents Vous pouvez avoir jusqu'à 1 000 agents gérés.

Frameworks d'agents

Vous pouvez également créer des agents avec Gemini à l'aide des frameworks et SDK suivants :

  • LangChain / LangGraph : créez des flux d'applications complexes avec état et des systèmes multi-agents à l'aide de structures de graphiques.
  • LlamaIndex : connectez les agents Gemini à vos données privées pour des workflows améliorés par RAG.
  • CrewAI : orchestrez des agents d'IA autonomes collaboratifs, et de jeu de rôle.
  • SDK Vercel AI : créez des interfaces utilisateur et des agents basés sur l'IA en JavaScript/TypeScript.
  • **Google ADK** : An open-source framework for building and orchestrating interoperable AI agents.
  • SDK Antigravity : créez des agents d'IA autonomes à l'aide des mêmes outils, boucle d'agent et gestion du contexte que Google Antigravity, programmable en Python.