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 l'IDE VS Code.

Avec le mode agent, vous pouvez effectuer les actions suivantes, entre autres :

  • poser des questions sur votre code ;
  • Utilisez le contexte et les outils intégrés 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.

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 l'édition de Gemini Code Assist que vous souhaitez utiliser dans votre IDE :
  2. Définissez le canal de publication 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 de haut niveau 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. Parmi les exemples d'outils, on trouve les outils intégrés tels que grep et la lecture ou l'écriture de fichiers, les serveurs MCP (Model Context Protocol) locaux ou distants et leurs fonctions exécutables, ou encore les 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

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. Pour en savoir plus, consultez Contexte du mode Agent.

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

Les commandes à barre oblique / vous permettent d'exécuter rapidement des commandes semblables à celles d'une fenêtre de terminal.

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.

Toujours autoriser les actions de l'agent

Vous pouvez autoriser automatiquement toutes les actions de l'agent.

Pour autoriser automatiquement toutes les actions de l'agent :

  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.

Créer des extensions Gemini CLI

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.

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]."

Étape suivante