Tutoriel des sous-agents Antigravity : cartes, syntaxe @ et corrections navigateur
Reddit se demande pourquoi Antigravity n'aurait pas de sous-agents — il en a. La doc liste research, browser et self, la v2.16.0 transforme chaque invocation en carte en direct, et le CLI 1.2.9 permet d'écrire aux sous-agents avec @. Douze étapes vérifiées, plus la liste des correctifs pour un sous-agent navigateur qui ne fonctionne pas.
L'essentiel
- Les sous-agents d'Antigravity existent déjà : research, browser et self sont livrés d'origine, et un sur mesure est à un fichier Markdown près. Les posts « il n'y a pas de sous-agents » sont périmés — mais la douleur était réelle : avant la v2.16.0, ils tournaient de façon invisible.
- La v2.16.0 (22 septembre 2026) transforme chaque invocation de sous-agent en carte en direct : statut en cours, en attente ou terminé, un contrôle au survol pour l'arrêter, et la navigation vers sa conversation en un clic.
- Le CLI 1.2.9 (23 septembre 2026) ajoute la syntaxe @ : tapez @, choisissez un sous-agent en cours ou terminé dans l'autocomplétion, et votre message atterrit directement dans sa conversation. Un sous-agent inactif se réveille avec son contexte intact.
- « Le sous-agent navigateur ne fonctionne pas », c'est le plus souvent le bouton Browser Tools, une politique de serveurs d'outils de l'organisation, ou un nom d'outil mal orthographié qui bloque l'exécution — la liste des cinq vérifications ci-dessous couvre tout.
How to better understand, follow, and collaborate with the agent
Vidéo:Google Antigravity1:32
The Liftoff Series - Developing with parallel agents
Vidéo:Google Antigravity1:17
How to Use Antigravity Subagents Like a Pro (Step-by-Step Guide)
Vidéo:The Next Signal13:59
Antigravity changelog & subagents docs
Source officielle:antigravity.google
Les deux vidéos officielles datent d'avant la 2.16.0 : elles montrent l'interface de lancement, sans cartes de sous-agents. Nous ne les utilisons que pour illustrer le système d'artefacts qui fonctionne toujours de la même façon (plan d'implémentation, liste de tâches, walkthrough) ; les faits de comportement s'appuient sur la documentation officielle des sous-agents et le changelog sur antigravity.google. La troisième vidéo contient une incrustation webcam — aucune image n'en a été extraite, elle sert uniquement de référence factuelle.
Images issues de « How to better understand, follow, and collaborate with the agent » et « The Liftoff Series - Developing with parallel agents » de Google Antigravity, plus une image de « Turn Antigravity Into AN AI Autonomous Engineering Team! » de WorldofAI (YouTube). Faits recoupés avec « How to Use Antigravity Subagents Like a Pro » de The Next Signal et antigravity.google/changelog. Les horodatages renvoient directement aux vidéos sources.
Utiliser les sous-agents Antigravity en 12 étapes
Trouver le système de sous-agents
- 1
Ouvrez l'Agent Manager
Lancez Antigravity et ouvrez l'Agent Manager — la tour de contrôle où vivent chaque conversation et chaque agent d'arrière-plan. Dans l'IDE, c'est un panneau dédié ; dans le terminal, tapez /agents pour la même liste de contrôle en direct des exécutions actives, terminées, tuées ou échouées.
Le panneau d'aperçu de l'Agent Manager : une Inbox, un bouton Start conversation et des dossiers pour deux workspaces.Voir à 0:54 - 2
Sachez qui travaille pour vous : research, browser, self
Antigravity embarque trois sous-agents natifs : research pour l'exploration de la base de code et la navigation dans les fichiers, browser pour piloter un Chrome isolé, et self — un clone direct de l'agent appelant. Les sous-agents personnalisés sont des fichiers Markdown avec frontmatter YAML. Le parent les invoque tous via l'outil invoke_subagent.
- 3
Briefez le parent avec une tâche délégable
Démarrez une conversation dans le workspace qui correspond au travail et décrivez le résultat, pas le fichier à modifier — « renseigne ceci et rédige-le », « construis et teste cette fonctionnalité ». Le travail en plusieurs parties est exactement ce qui pousse l'agent à répartir une tâche entre sous-agents.
Une nouvelle conversation dans le workspace Space Research, avec le mode Planning et la puce de modèle réglés avant l'envoi.Voir à 0:38 - 4
Lisez le plan d'implémentation avant tout code
Le parent rédige d'abord un artefact plan d'implémentation — objectif, changements proposés, plan de vérification. Les sous-agents n'héritent pas de l'historique de conversation du parent ; ce plan est donc le contrat qui garde chaque agent engendré aligné. Objection maintenant : c'est le moment le moins cher pour changer de cap.
Un artefact plan d'implémentation avec Proposed Changes et Verification Plan — avant qu'existe la moindre ligne de code.Voir à 0:22
Voir les sous-agents à l'œuvre
- 5
Suivez la liste de tâches en direct
Dès que le travail démarre, le plan devient une liste de tâches qui se coche en temps réel — planning, implementation, polish, verification. Les sous-agents la mettent à jour à chaque étape ; jetez-y un œil avant d'interrompre avec une question, la progression y répond généralement.
La liste de tâches en pleine exécution : planning et implementation cochés, polish et verification encore ouverts.Voir à 0:42 - 6
Suivez chaque agent actif depuis l'Inbox
Depuis la v2.16.0 (22 septembre 2026), les invocations de sous-agents s'affichent en cartes dédiées avec statut en direct en cours, en attente ou terminé, un contrôle au survol pour les arrêter, et la navigation vers leur conversation en un clic. L'Inbox agrège les exécutions de tous les workspaces — les agents parallèles occupent des lignes parallèles, chacun avec son statut.
Trois conversations en parallèle, chacune avec son statut et son workspace.Voir à 0:50 - 7
Entrez dans la conversation propre au sous-agent
Chaque sous-agent garde sa propre conversation, à un clic de sa carte ou de la barre latérale du manager. Ouvrez-la pour lire le fil privé du sous-agent et répondre directement — écrire à un sous-agent inactif le réveille automatiquement, avec tout le contexte de ses tours précédents.
La barre latérale de l'Agent Manager regroupe les conversations par workspace ; le spinner signale l'exécution en cours.Voir à 9:40 - 8
Vérifiez le walkthrough — preuve à l'appui
Quand le travail s'achève, l'agent génère un artefact walkthrough rapportant ce qu'il a fait, et le travail navigateur arrive avec captures d'écran ou enregistrement d'écran comme preuve. Lisez-le avant d'accepter : c'est le moyen le plus rapide de repérer l'écart entre « fini » et « bien fini ».
Le walkthrough liste les points terminés à côté d'un enregistrement de démo de l'application finie.Voir à 0:50
Piloter, paralléliser, vérifier
- 9
Pilotez en commentant les artefacts
Inutile de repartir du prompt zéro. Laissez un commentaire directement sur un plan d'implémentation, un walkthrough ou des lignes de code précises — l'agent lit la boucle de retour et s'ajuste. Les artefacts deviennent la source de vérité partagée entre vous et l'agent.
Un commentaire tapé directement dans le paragraphe d'objectif du plan d'implémentation.Voir à 1:06 - 10
Sélectionnez une zone de capture pour un feedback au pixel près
Pour le travail visuel, tracez une sélection sur n'importe quelle capture d'écran d'un artefact et commentez exactement cette région — « cette marge », « échange ces couleurs ». Le sous-agent reçoit des coordonnées plutôt qu'une description vague, ce qui supprime des allers-retours entiers.
Une région sélectionnée au glisser sur la capture du navigateur, avec un commentaire en ligne attaché.Voir à 1:17 - 11
Gardez un second workspace prêt pour le parallèle
Le changement de contexte tue le flux. Gardez un second workspace préchargé dans l'Agent Manager, déléguez la tâche qui s'invite à un agent d'arrière-plan là-bas, et votre propre workspace reste intact — l'agent ne revient que quand il a besoin d'une revue ou d'une approbation.
Le sélecteur de workspace liste Playground, Space Flight Booking et Space Research.Voir à 0:34 - 12
Laissez le sous-agent navigateur tester l'UI
Invoquez le sous-agent navigateur avec la commande slash /browser — la doc est explicite : c'est sa seule porte. Il manœuvre un Chrome isolé dans un profil séparé, capture des captures d'écran et des enregistrements d'actions en artefacts, et éprouve votre application comme un ingénieur QA. Si /browser ne fait rien, soupçonnez le réglage Browser Tools ou la politique de serveurs d'outils de votre organisation.
L'enregistrement du sous-agent navigateur se joue dans le walkthrough — le mode sombre vérifié sur la vraie page.Voir à 0:46
Où vivent les sous-agents : Agent Manager, CLI et la syntaxe @
Les sous-agents tournent sur les deux surfaces. Dans l'IDE, ce sont les cartes et artefacts de l'Agent Manager ; dans le terminal, le /agents du CLI ouvre la même tour de contrôle en liste de contrôle en direct — flèches pour surligner une exécution, Entrée pour sa vue détaillée avec pensées privées, appels d'outils et sorties, Alt+J pour sauter au prochain sous-agent en attente d'approbation, et k pour annuler celui qui est surligné.
La syntaxe @ est d'abord une affaire de CLI, arrivée avec le CLI 1.2.9 (23 septembre 2026) : tapez @ dans le prompt, l'autocomplétion liste les sous-agents en cours et terminés, et votre message part droit dans la conversation de ce sous-agent. Écrire à un sous-agent inactif le réveille avec son contexte intact. L'indice « Ask anything, @ to mention, / for workflows » du composeur de l'IDE est l'ancienne mention @ qui tire du contexte dans un prompt — lié, mais ce n'est pas le même mécanisme.
Sous le capot, le parent appelle invoke_subagent avec un rôle et un prompt initial, plus un mode de workspace : inherit (même workspace), branch (worktree Git isolé) ou share (répertoire partagé). L'imbrication est plafonnée à 10 niveaux, et depuis la v2.6.0, arrêter un sous-agent arrête aussi tout ce qu'il a engendré. Vous voulez vos propres spécialistes ? Notre tutoriel sur les agents personnalisés Antigravity couvre le format Markdown + frontmatter YAML.
Le sous-agent navigateur ne fonctionne pas ? Réglez-le en cinq vérifications
La plupart des signalements « le sous-agent navigateur ne marche pas » se résument à l'un des cinq ci-dessous. Procédez de haut en bas.
- 1Mettez à jour d'abord. Les cartes de sous-agents avec statut en cours/en attente/terminé n'existent que depuis la v2.16.0 (22 septembre 2026) ; sur les builds antérieurs, les sous-agents tournaient en arrière-plan, invisibles. Mettez l'application de bureau à jour — et le CLI en 1.2.9 ou plus — avant de conclure que quoi que ce soit est cassé.
- 2Vérifiez le bouton Browser Tools. Les outils navigateur d'Antigravity peuvent être désactivés entièrement depuis la section Browser des User Settings. Si /browser ne fait rien ou que l'agent prétend ne pas pouvoir utiliser de navigateur, confirmez que le bouton est activé — la doc officielle documente l'interrupteur mais ne publie aucune matrice de dépannage plus poussée.
- 3Une fenêtre Chrome vide et inconnue, c'est voulu. Le sous-agent navigateur manœuvre un profil Chrome séparé pour protéger vos données personnelles : n'attendez ni extensions, ni connexions, ni favoris. Si une tâche exige une session connectée, dites à l'agent comment gérer les identifiants au lieu d'attendre votre profil.
- 4Machines gérées : la v2.6.0 a corrigé « l'outil d'inspection navigateur intégré bloqué à tort quand votre organisation restreint les serveurs d'outils autorisés à tourner ». Si des actions navigateur sont bloquées sur un appareil géré par l'entreprise, cette entrée de changelog — ou une exception de politique — est la coupable probable.
- 5Blocages sans sortie : la doc officielle des sous-agents signale un problème connu où un nom d'outil non mappé ou mal orthographié dans la liste d'outils d'un sous-agent peut faire pendre le processus en pleine exécution. Un sous-agent coincé sur en cours sans aucun appel d'outil correspond à cette signature — vérifiez l'orthographe de chaque nom d'outil (une correction par validation de schéma est promise).
Toujours bloqué ? La doc officielle ne publie pas de matrice de dépannage plus large. Reproduisez le problème avec l'enregistrement du walkthrough joint, puis utilisez Provide Feedback dans l'application — et notez que les fils communautaires sur le même symptôme reviennent toujours aux cinq causes ci-dessus.