Gemini Agents : l'IA qui code, vérifie et s'auto-gère dans le cloud

UN AGENT QUI CODE ET S'AUTO-CORRIGE, C'EST POSSIBLE MAINTENANT

Imagine un assistant qui analyse ton code, installe les bonnes bibliothèques, vérifie les erreurs et te donne un rapport parfait. C'est exactement ce que propose la nouvelle version des Managed Agents dans l'API Gemini. Ces agents ne se contentent pas de répondre à tes questions : ils exécutent des tâches complexes dans un espace isolé du cloud, sans risquer de toucher à ton ordinateur. Pour commencer, il suffit d'ajouter une compétence à ton terminal avec une simple commande : npx skills add google-gemini/gemini-skills --skill gemini-interactions-api.

INSTALLER L'OUTIL POUR COMMANDER TES AGENTS

Avant de lancer un agent, il faut préparer ton environnement. Deux étapes suffisent : installer le kit de Développement avec npm install @google/genai et choisir un agent prêt à l'emploi, comme antigravity-preview-05-2026. Cet agent est spécialisé dans l'automatisation des tâches de développement. Une fois configuré, tu peux lui donner des ordres précis, comme auditer toutes les dépendances d'un projet ou générer un rapport de migration.

GEMINI 3.6 FLASH : LE NOUVEAU MOTEUR PAR DÉFAUT

Depuis cette mise à jour, les Managed Agents utilisent par défaut le modèle Gemini 3.6 Flash. Pas besoin de changer ton code : l'agent bascule automatiquement sur cette version améliorée. Tu peux cependant choisir un autre modèle si tu préfères, comme Gemini 3.5 Flash-Lite pour réduire les coûts. Pour cela, il suffit d'ajouter un paramètre dans ta configuration : model: "gemini-3.5-flash-lite".

COMMENT FONCTIONNE UN AGENT GEMINI EN PRATIQUE

Prenons un exemple concret. Tu veux que ton agent audite toutes les dépendances de ton projet, mette à jour les paquets obsolètes et lance les tests. Voici comment tu écris ta demande :

const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "Audit all dependencies in package.json, upgrade outdated packages, and verify the build by running npm test.",
  environment: "remote",
  agent_config: {
    type: "antigravity",
    model: "gemini-3.5-flash-lite",
  },
});

console.log(interaction.output_text);

L'agent va alors :

• Lire ton fichier package.json
• Identifier les bibliothèques à mettre à jour
• Exécuter npm install pour installer les nouvelles versions
• Lancer npm test pour vérifier que tout fonctionne

Le résultat est affiché directement dans ta console. Simple, non ?

LES HOOKS : DES SCRIPTS PERSONNALISÉS POUR CONTRÔLER TES AGENTS

Les hooks sont des scripts que tu peux attacher à ton agent pour qu'il exécute des actions avant ou après chaque outil qu'il utilise. Par exemple, tu peux bloquer l'exécution d'un script dangereux ou formater automatiquement le code généré. Pour cela, crée un fichier .agents/hooks.json dans ton environnement. Voici un exemple de configuration :

{
  "security-gate": {
    "pretoolexecution": [
      {
        "matcher": "codeexecution|writefile",
        "hooks": [
          {
            "type": "command",
            "command": "python3 /.agents/hooks-scripts/gate.py",
            "timeout": 10
          }
        ]
      }
    ]
  },
  "auto-format": {
    "posttoolexecution": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "python3 /.agents/hooks-scripts/auto_lint.py",
            "timeout": 15
          }
        ]
      }
    ]
  }
}

Dans cet exemple :

• security-gate bloque l'exécution des commandes code_execution et write_file si elles ne passent pas un test de sécurité.
• auto-format formate automatiquement le code après chaque outil exécuté.

Tu peux cibler plusieurs outils avec des expressions régulières, ou tout bloquer avec un simple "matcher": "*".

UN CAS CONCRET : VÉRIFIER DES LOGOS POUR UNE BANQUE D'INVESTISSEMENT

Prenons l'exemple d'une banque d'investissement qui utilise un agent pour générer des présentations. Chaque diapositive doit contenir des logos d'entreprises, avec des règles strictes : bonne taille, fond transparent, nom visible et contraste élevé. Avant les hooks, c'était impossible car l'agent travaillait dans un espace isolé du cloud. Désormais, un hook posttoolexecution déclenche une vérification automatique après que l'agent a écrit la liste des entreprises. Le script :

• Récupère les logos candidats
• Vérifie leur qualité pixel par pixel
• Confirme leur validité avec l'API de vision de Gemini
• Génère un manifeste des fichiers approuvés

Résultat : seules les images conformes sont autorisées dans la présentation finale.

GRATUIT POUR TESTER, PAYANT POUR PRODUIRE

Tu peux commencer à utiliser les agents sans payer, grâce à un niveau gratuit. Il suffit de créer un projet sans facturation active et d'utiliser une clé API. Attention cependant : les tâches complexes consomment beaucoup de jetons (tokens). Pour éviter les mauvaises surprises, tu peux limiter la consommation totale avec maxtotaltokens. Par exemple, pour un budget de 10 000 jetons :

const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "Audit all modules in this repo and generate a migration report.",
  agent_config: {
    type: "antigravity",
    maxtotaltokens: 10000,
  },
  environment: "remote",
});

Si l'agent atteint la limite, il s'arrête proprement et renvoie un statut "incomplete". Tu peux reprendre l'exécution plus tard en utilisant previousinteractionid avec un nouveau budget.

PLANIFIER TES TÂCHES COMME UN PRO

Besoin d'exécuter une tâche régulièrement ? Les déclencheurs planifiés (scheduled triggers) sont faits pour ça. Tu définis une tâche, un agent, un environnement et une fréquence (par exemple, tous les lundis à 8h). L'agent s'exécute automatiquement, sans que tu aies à intervenir. Chaque exécution réutilise le même espace de travail, donc les fichiers restent disponibles d'une fois sur l'autre.

Tu peux aussi gérer tes environnements à distance avec l'API Environments. Par exemple, lister tous tes espaces de travail, inspecter leur état ou les supprimer quand tu as fini. Plus besoin d'attendre 7 jours pour que le cloud nettoie tout seul.

POURQUOI C'EST UNE RÉVOLUTION POUR LES DÉVELOPPEURS

Ces mises à jour transforment les agents en travailleurs autonomes :

• Ils exécutent des tâches complexes sans surveillance
• Ils s'auto-vérifient grâce aux hooks
• Ils respectent un budget de jetons
• Ils s'exécutent à heure fixe

Plus besoin de configurer des serveurs externes ou de gérer des orchestrations manuelles. Tout se passe dans le cloud, de manière sécurisée et contrôlée. Les développeurs peuvent enfin se concentrer sur l'essentiel : écrire du code, pas sur la logistique.

COMMENT DÉMARRER AVEC LES MANAGED AGENTS

Pour créer ton premier agent, commence par installer le SDK JavaScript/TypeScript avec npm install @google/genai. Si tu préfères Python ou cURL, consulte la documentation de l'agent Antigravity. Ensuite, choisis un agent existant comme antigravity-preview-05-2026 ou crée ton propre agent avec des règles personnalisées.

Tu peux aussi explorer les définitions d'agents personnalisés, les configurations d'environnement, les règles réseau et les modèles de streaming avancés dans la documentation officielle. Une fois que tu maîtrises les bases, tu pourras automatiser presque n'importe quelle tâche de développement.

LES MODÈLES SUPPORTÉS PAR LES AGENTS

Les agents de Gemini API supportent plusieurs modèles, selon tes besoins :

• Gemini 3.6 Flash : le modèle par défaut, rapide et efficace
• Gemini 3.5 Flash-Lite : une version allégée pour réduire les coûts
• D'autres modèles peuvent être ajoutés selon les besoins

Tu peux aussi forcer un modèle spécifique en ajoutant model: "nom-du-modèle" dans ta configuration d'agent.

LES ÉVÉNEMENTS QUI DÉCLENCHENT LES HOOKS

Les hooks s'activent à deux moments précis :

• pretoolexecution : avant que l'agent n'exécute un outil (comme exécuter du code ou écrire un fichier)
• posttoolexecution : après que l'agent a utilisé un outil

Tu peux attacher plusieurs hooks à un même événement, ou cibler des outils spécifiques avec des expressions régulières. Par exemple, matcher: "codeexecution|writefile" cible uniquement l'exécution de code et l'écriture de fichiers.

LES RÈGLES DE SÉCURITÉ DANS LES HOOKS

Chaque hook peut avoir un timeout pour limiter le temps d'exécution. Par exemple, un script de sécurité peut avoir un timeout de 10 secondes, tandis qu'un script de formatage peut prendre jusqu'à 15 secondes. Si un hook échoue, l'agent peut décider de bloquer l'exécution ou de continuer selon ta configuration.

Pour en savoir plus sur la gestion des erreurs et les définitions HTTP des hooks, consulte la documentation officielle.

LES ENVIRONNEMENTS D'EXÉCUTION : UN SANDBOX ISOLÉ POUR TES AGENTS

Chaque agent travaille dans un sandbox (un espace isolé) dans le cloud. Cela signifie :

• Pas de risque pour ton ordinateur local
• Tous les fichiers et outils nécessaires sont disponibles
• L'exécution est sécurisée et contrôlée

Tu peux même récupérer l'état de ton environnement après une interruption, grâce à previousinteractionid.

LES AVANTAGES DES DÉCLENCHEURS PLANIFIÉS

Les déclencheurs planifiés offrent plusieurs bénéfices :

• Automatisation complète : plus besoin de lancer manuellement tes tâches
• Persistance des fichiers : tout reste disponible entre les exécutions
• Gestion centralisée : tu peux lister, inspecter et supprimer tes environnements à distance
• Économie de temps : idéal pour les tâches répétitives comme les sauvegardes ou les rapports

LES LIMITES À CONNAÎTRE AVANT DE SE LANCER

Même si les agents sont puissants, ils ont quelques contraintes :

• La consommation de jetons peut être élevée pour les tâches complexes
• Les hooks doivent être bien configurés pour éviter les blocages inutiles
• Les environnements ont une durée de vie limitée (7 jours par défaut)
• Certaines tâches nécessitent des modèles spécifiques

Heureusement, la plupart de ces limites peuvent être contournées avec une bonne configuration.

EXEMPLE COMPLET : UN AGENT QUI GÉNÈRE UN RAPPORT DE MIGRATION

Voici comment créer un agent qui audite tous les modules d'un dépôt et génère un rapport de migration :

const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "Audit all modules in this repo and generate a migration report.",
  agent_config: {
    type: "antigravity",
    maxtotaltokens: 10000,
  },
  environment: "remote",
});

L'agent va :

• Lister tous les modules du projet
• Identifier ceux qui nécessitent une migration
• Générer un rapport détaillé avec les étapes à suivre
• Stocker le rapport dans l'environnement pour que tu puisses le récupérer plus tard

COMMENT RÉCUPÉRER LES RÉSULTATS DE TON AGENT

Une fois ton agent terminé, tu peux récupérer ses résultats de plusieurs manières :

• En affichant interaction.output_text dans ta console
• En lisant les fichiers générés dans l'environnement
• En utilisant l'API Environments pour télécharger les artefacts

Si l'agent s'est arrêté à mi-chemin (status: "incomplete"), tu peux reprendre l'exécution en utilisant previousinteractionid avec un nouveau budget de jetons.

LES OUTILS DISPONIBLES POUR LES AGENTS

Les agents de Gemini API peuvent utiliser plusieurs outils pour accomplir leurs tâches :

• code_execution : exécuter du code dans un environnement sécurisé
• write_file : écrire des fichiers dans l'environnement
• read_file : lire des fichiers
• web_retrieval : récupérer des données depuis le web
• package_installation : installer des bibliothèques npm

Chaque outil peut être contrôlé par des hooks pour ajouter des vérifications ou des transformations.

COMMENT PERSONNALISER TON AGENT

Pour créer un agent sur mesure, tu peux :

• Choisir un modèle spécifique avec model: "nom-du-modèle"
• Ajouter des hooks pour contrôler les outils utilisés
• Définir des règles réseau pour limiter les accès
• Configurer des déclencheurs planifiés pour des exécutions automatiques

La documentation officielle propose des exemples pour chaque cas d'usage.

LES BONNES PRATIQUES POUR UTILISER LES AGENTS SANS RISQUE

Pour éviter les problèmes, voici quelques conseils :

• Commence par des tâches simples pour te familiariser avec le système
• Utilise des hooks pour bloquer les actions dangereuses
• Limite toujours le budget de jetons pour éviter les surprises
• Vérifie régulièrement l'état de tes environnements
• Sauvegarde les résultats importants en dehors du sandbox

ET DEMAIN ? QUELLE ÉVOLUTION POUR LES AGENTS GEMINI ?

Les équipes de Gemini API continuent d'améliorer les agents avec de nouvelles fonctionnalités. Parmi les pistes explorées :

• Des modèles encore plus puissants et moins coûteux
• Des hooks encore plus flexibles et faciles à configurer
• Une meilleure intégration avec d'autres outils de développement
• Des environnements encore plus sécurisés et isolés

Une chose est sûre : les agents autonomes vont devenir un standard pour les développeurs qui veulent automatiser leurs tâches sans perdre de temps en configuration.

EN RÉSUMÉ : CE QUE TU DOIS RETENIR

Les nouveaux Managed Agents de Gemini API changent la donne pour les développeurs :

• Ils exécutent des tâches complexes sans surveillance
• Ils s'auto-vérifient avec des hooks personnalisés
• Ils respectent un budget de jetons pour éviter les coûts explosifs
• Ils s'exécutent à heure fixe grâce aux déclencheurs planifiés
• Ils fonctionnent dans un sandbox isolé pour une sécurité maximale

Plus besoin de configurer des serveurs ou de gérer des orchestrations manuelles. Les agents font tout le travail à ta place, dans le cloud. Prêt à automatiser ton workflow ?