Utiliser le chat agentique comme programmateur à deux

Ce document explique comment configurer et utiliser le mode agent de Gemini Code Assist en tant que programmateur en binôme dans votre environnement de développement intégré (IDE).

Le mode Agent est disponible dans VS Code.

Voici quelques exemples d'utilisation de Gemini Code Assist en mode agent :

  • poser des questions sur votre code ;
  • Utilisez les outils et le contexte intégrés en mode agent pour améliorer le contenu généré.
  • Configurez les serveurs MCP pour étendre les capacités de l'agent.
  • Obtenez des solutions pour les tâches complexes en plusieurs étapes.
  • Générez du code à partir de documents de conception, de problèmes et de commentaires TODO.
  • Contrôlez le comportement de l'agent en commentant, modifiant et approuvant les plans et l'utilisation des outils pendant l'exécution.

Fonctionnement du mode Agent

En mode agent, votre requête est envoyée à l'API Gemini avec une liste d'outils disponibles. L'API Gemini traite la requête et renvoie une réponse. La réponse peut être une réponse directe ou une demande d'utilisation d'un outil disponible.

Lorsqu'un outil est demandé, l'agent se prépare à l'utiliser et vérifie s'il est autorisé à l'utiliser sans autorisation explicite. Pour les demandes d'outils qui modifient le système de fichiers ou effectuent des opérations de mutation sur des ressources, Gemini vous demandera d'autoriser l'opération, sauf si vous avez configuré Gemini pour toujours autoriser le ou les outils. Les demandes d'outils en lecture seule peuvent ne pas demander d'autorisation avant d'effectuer la tâche. Lorsque vous êtes invité à autoriser l'utilisation d'un outil, vous pouvez choisir d'autoriser ou de refuser l'opération. L'agent peut également vous proposer d'autoriser systématiquement un outil ou un serveur, ou d'autoriser des opérations similaires.

Une fois l'autorisation d'utiliser l'outil accordée, l'agent l'utilise pour effectuer l'action requise, et le résultat de l'action est renvoyé à l'API Gemini. Gemini traite le résultat de l'action de l'outil et génère une autre réponse. Ce cycle d'action et d'évaluation se poursuit jusqu'à ce que la tâche soit terminée.

Pour les tâches complexes, Gemini peut afficher un plan détaillé que vous devrez approuver. Vous pouvez affiner le plan et poser des questions dans le chat avant de commencer le processus. Une fois que le plan vous convient, vous pouvez l'approuver. L'agent commence à travailler sur la première tâche et vous demandera des précisions ou des autorisations si nécessaire lors de l'exécution du plan.

Contexte du mode Agent

Le contexte permet à un agent de générer de meilleures réponses pour une requête donnée. Le contexte peut être extrait des fichiers de votre IDE, des fichiers de vos dossiers système locaux, des réponses de l'outil et des détails de votre requête.

Selon votre IDE et vos paramètres, différents contextes peuvent être disponibles pour l'agent.

Les méthodes suivantes pour obtenir du contexte sont généralement disponibles pour Gemini Code Assist en mode agent :

  • Informations dans votre espace de travail IDE.
  • Réponses d'outils intégrés tels que grep, terminal, lecture de fichier ou écriture de fichier.
  • Réponses de la recherche Google
  • Contenu provenant d'une URL donnée dans une requête ou par un outil.
  • Les fichiers de contexte que vous créez au format Markdown sont limités à tous vos projets, à un projet spécifique ou à des instructions spécifiques pour un composant, un module ou une sous-section particulière de votre projet. Les fichiers contextuels peuvent contenir des instructions, des consignes ou du contexte dont vous souhaitez que Gemini tienne compte lors des interactions en mode agent.

Mémoire du mode Agent

Le mode Agent de Gemini Code Assist exploite le service de découverte de la mémoire de la CLI Gemini pour trouver et charger les fichiers GEMINI.md qui fournissent du contexte à l'agent. Le service de découverte de mémoire recherche les fichiers de manière hiérarchique, en commençant par le répertoire de travail actuel et en remontant jusqu'à la racine du projet et votre répertoire personnel. Il effectue également des recherches dans les sous-répertoires.

Vous pouvez disposer de fichiers de contexte globaux, au niveau du projet et au niveau du composant. Ils sont tous combinés pour fournir au modèle les informations les plus pertinentes.

Vous pouvez utiliser la commande /memory show pour afficher le contenu combiné de tous les fichiers GEMINI.md chargés et la commande /memory refresh pour les recharger.

Extensions Gemini CLI

Dans VS Code, vous pouvez utiliser les extensions de la CLI Gemini pour configurer et étendre les fonctionnalités du mode agent Gemini Code Assist.

L'agent recherche les extensions à deux emplacements :

  • WORKSPACE/.gemini/extensions où WORKSPACE est votre espace de travail actuel.
  • ~/.gemini/extensions où ~ est votre répertoire d'accueil.

L'agent charge toutes les extensions des deux emplacements, mais si une extension portant le même nom existe dans les deux, celle du répertoire de l'espace de travail prévaut. Chaque extension est un répertoire contenant un fichier gemini-extension.json. Ce fichier contient la configuration de l'extension.

Pour en savoir plus, consultez Extensions de la CLI Gemini.

Limites

Les limites suivantes s'appliquent lorsque vous utilisez le mode Agent :

  • L'agent ne peut pas appeler les outils Gemini Code Assist. Vous devez quitter le mode Agent pour utiliser ces outils.
  • L'agent ne peut pas utiliser la personnalisation du code. Vous devez quitter le mode Agent pour utiliser la personnalisation du code.
  • Les projets comportant plusieurs racines ne sont pas compatibles avec le mode Agent. Si vous utilisez le mode agent dans un projet comportant plusieurs répertoires racine, l'agent n'a accès qu'au premier répertoire racine qu'il rencontre.
  • Les journaux Gemini pour Google Cloud ne sont pas compatibles avec le mode agent.

Avant de commencer

  1. Configurez Gemini Code Assist.
  2. Définissez le version disponible de Gemini Code Assist sur la version Insiders :
    1. Ouvrez la palette de commandes (Cmd+Shift+P), puis sélectionnez Ouvrir les paramètres utilisateur JSON.
    2. Ajoutez la ligne suivante au fichier JSON de vos paramètres utilisateur : 
      "geminicodeassist.updateChannel": "Insiders",

Utiliser le mode Agent

En mode agent, vous pouvez demander à Gemini d'atteindre des objectifs généraux et d'effectuer des tâches complexes.

Pour profiter pleinement du mode Agent, suivez les bonnes pratiques concernant les requêtes et fournissez autant de détails que possible.

Pour passer en mode agent :

VS Code

  1. Pour ouvrir le chat Gemini Code Assist, dans la barre d'activité de votre IDE, cliquez sur spark Gemini Code Assist.
  2. Cliquez sur le bouton Agent pour passer en mode Agent. Le bouton bascule est mis en surbrillance lorsqu'il est en mode agent et en gris lorsqu'il est en mode chat normal.
  3. Dans le chat Gemini Code Assist, saisissez votre requête.

Gemini vous fournit une réponse à votre requête ou vous demande l'autorisation d'utiliser un outil.

Pour arrêter l'agent, cliquez sur Arrêter.

Pour utiliser le chat Gemini Code Assist standard, cliquez sur Nouveau chat pour créer un chat.

Le mode agent de Gemini Code Assist est optimisé par la CLI Gemini.

IntelliJ

Cette fonctionnalité n'est pas disponible dans Gemini Code Assist pour IntelliJ ni dans les autres IDE JetBrains.

Configurer des outils pour le mode agent

Les outils sont une vaste catégorie de services qu'un agent peut utiliser pour le contexte et les actions dans sa réponse à votre requête. Par exemple, il peut s'agir d'outils intégrés tels que grep et la lecture ou l'écriture de fichiers, de serveurs MCP (Model Context Protocol) locaux ou à distance, ou d'implémentations de services personnalisés.

Configurer les serveurs MCP

Pour contrôler les serveurs disponibles en mode agent, ajoutez-les à votre fichier JSON de paramètres Gemini en suivant la documentation du serveur.

VS Code

  1. Installez toutes les dépendances requises par votre serveur MCP.
  2. Ouvrez le fichier JSON de vos paramètres Gemini situé dans ~/.gemini/settings.json, où ~ correspond à votre répertoire d'accueil.

  3. Ajoutez des serveurs MCP locaux ou distants à votre fichier JSON de paramètres Gemini en suivant les instructions du serveur.

    L'exemple suivant ajoute le serveur MCP Cloudflare distant et installe les serveurs GitHub et GitLab sur la machine locale.

    {
    "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
      }
    },
    "gitlab": {
      "command": "npx",
      "args": [
          "-y",
          "@modelcontextprotocol/server-gitlab"
      ]
    },
        "cloudflare-observability": {
            "command": "npx",
            "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
        },
        "cloudflare-bindings": {
            "command": "npx",
            "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
        }
    }
}

  4. Ouvrez la palette de commandes et sélectionnez Développeur : Recharger la fenêtre.

Vos serveurs MCP configurés sont disponibles pour l'agent en mode agent.

IntelliJ

Cette fonctionnalité n'est pas disponible dans Gemini Code Assist pour IntelliJ ni dans les autres IDE JetBrains.

Authentification du serveur MCP

Pour les serveurs MCP qui nécessitent une authentification, vous pouvez les ajouter à votre fichier JSON des paramètres Gemini.

L'exemple suivant ajoute un jeton d'accès personnel pour GitHub :

{
//other settings...

"github": {
  "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
  "args": ["stdio"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
  }
},

// other settings...
}

Où ACCESS_TOKEN est le jeton d'accès de l'utilisateur.

Créer un fichier de contexte

VS Code

  1. Créez un fichier nommé GEMINI.md dans un emplacement correspondant au champ d'application du contexte. Le tableau suivant détaille les emplacements des fichiers de contexte pour différentes portées :

    Champ d'application Emplacement
    Tous vos projets ~/.gemini/GEMINI.md
    Un projet spécifique Votre répertoire de travail ou tout répertoire parent jusqu'à la racine de votre projet (identifiée par un dossier .git) ou votre répertoire personnel.
    Un composant, un module ou une sous-section spécifique d'un projet Sous-répertoires de votre répertoire de travail.

    Le système de mémoire de l'agent est créé en chargeant des fichiers de contexte à partir de plusieurs emplacements. Le contexte des fichiers plus spécifiques, comme ceux des composants ou modules spécifiques, remplace ou complète le contenu des fichiers de contexte plus généraux, comme le fichier de contexte global à l'adresse ~/.gemini/GEMINI.md.

  2. Rédigez les règles, les informations du guide de style ou le contexte que vous souhaitez que l'agent utilise au format Markdown, puis enregistrez le fichier. Pour en savoir plus, consultez l'exemple de fichier de contexte sur GitHub.

IntelliJ

Cette fonctionnalité n'est pas disponible dans Gemini Code Assist pour IntelliJ ni dans les autres IDE JetBrains.

Utiliser des commandes

Pour afficher les commandes de l'interface de ligne de commande Gemini disponibles en mode agent Gemini Code Assist, saisissez / dans le chat Gemini.

Vous pouvez utiliser les commandes Gemini CLI suivantes en mode agent :

  • /tools : affiche la liste des outils disponibles dans votre session en mode Agent. Voici quelques sous-commandes :
    • desc ou descriptions : affiche des descriptions détaillées de chaque outil.
    • nodesc ou nodescriptions : masque les descriptions des outils et n'affiche que leurs noms.
  • /memory : gère le contexte pédagogique de l'agent chargé à partir des fichiers GEMINI.md. Voici quelques sous-commandes :
    • show : affiche le contenu complet et concaténé de la mémoire actuelle chargée à partir de tous les fichiers GEMINI.md disponibles.
    • refresh : recharge la mémoire à partir de tous les fichiers GEMINI.md dans les emplacements disponibles. Pour savoir comment les fichiers GEMINI.md contribuent à la mémoire hiérarchique de l'agent, consultez la documentation sur la configuration de la CLI Gemini.
  • /mcp : liste les serveurs MCP (Model Context Protocol) configurés, leur état de connexion, les détails du serveur et les outils disponibles. Voici quelques exemples de sous-commandes :
    • desc ou descriptions : affiche des descriptions détaillées des serveurs et outils MCP.
    • nodesc ou nodescriptions : masque les descriptions des serveurs MCP et n'affiche que les noms des serveurs MCP.
    • schema : affiche le schéma JSON complet des paramètres configurés du serveur MCP.
  • /stats : affiche des statistiques et la durée détaillées des sessions en mode agent.

Pour en savoir plus sur les commandes de la CLI Gemini, consultez Commandes de la CLI Gemini. Notez que toutes les commandes de l'interface de ligne de commande Gemini ne sont pas disponibles en mode agent.

Mode Yolo

Vous pouvez utiliser le mode Yolo pour autoriser automatiquement toutes les actions de l'agent.

Pour configurer le mode "yolo" :

  1. Ouvrez le fichier JSON des paramètres utilisateur de VS Code :

    1. Ouvrez la palette de commandes (ctrl/command+Shift+P).
    2. Sélectionnez Préférences : Ouvrir les paramètres utilisateur (JSON).

  2. Ajoutez les éléments suivants au fichier JSON des paramètres utilisateur de VS Code :

    //other settings...

"geminicodeassist.agentYoloMode": "true",
//other settings...

  3. Ouvrez la palette de commandes et sélectionnez Développeur : Recharger la fenêtre.

Le mode Agent utilise le mode YOLO et ne vous demandera pas votre autorisation avant d'effectuer des actions lorsque vous lui enverrez une requête.

Requêtes supplémentaires

Essayez les requêtes suivantes avec vos propres informations :

  • "Que fait ce dépôt ? Aide-moi à comprendre l'architecture."
  • "Que fait cette [classe/fonction] ?"
  • "Ajoute une fonctionnalité à cette base de code : "[lien-ou-chemin-vers-la-base-de-code]"."
  • "Refactorise les fonctions [A] et [B] pour utiliser la méthode commune [C]."
  • "Corrige le problème GitHub [lien vers le problème GitHub]."
  • "Crée une application pour [objectif] avec une UI qui permet à l'utilisateur de [tâche] dans [environnement]."
  • "Migre les versions de bibliothèque de ce dépôt de [X] à [Y]."
  • "Optimise les performances de ce code Go pour qu'il s'exécute plus rapidement."
  • "Utilise [nom de l'API] pour développer cette fonctionnalité."
  • "Implémente un algorithme pour effectuer [X], [Y] et [Z]."

Étapes suivantes