Coder avec Gemini Code Assist pour les particuliers

Ce document explique comment effectuer les opérations suivantes dans VS Code ou IntelliJ, ainsi que dans d'autres IDE JetBrains compatibles, à l'aide de Gemini Code Assist, un outil de collaboration optimisé par l'IA :

  • Générez du code pour votre projet avec la transformation de code.
  • Recevez des complétions de code pendant que vous codez.
  • Utilisez les actions intelligentes.

Si vous utilisez Gemini Code Assist Enterprise, vous pouvez utiliser la personnalisation du code, qui vous permet d'obtenir des suggestions de code reposant sur le codebase privé de votre entreprise directement depuis Gemini Code Assist Enterprise. Découvrez comment configurer la personnalisation du code.

Dans ce document, qui s'adresse aux développeurs de tous niveaux, nous partons du principe que vous disposez de connaissances pratiques sur VS Code ou IntelliJ, ainsi que d'autres IDE JetBrains compatibles. Vous pouvez également utiliser Gemini dans Android Studio.

Avant de commencer

VS Code

  1. Configurez Gemini Code Assist pour les particuliers, Gemini Code Assist Standard ou Gemini Code Assist Enterprise, si ce n'est pas déjà fait.

  2. Avant de tester les fonctionnalités de Gemini Code Assist dans votre fichier de code, assurez-vous que le langage de programmation de votre fichier est compatible. Pour en savoir plus sur les langages de programmation compatibles, consultez Langages de programmation compatibles.

  3. Si vous préférez utiliser votre IDE derrière un proxy, consultez Connexions réseau dans Visual Studio Code.

IntelliJ

  1. Configurez Gemini Code Assist pour les particuliers, Gemini Code Assist Standard ou Gemini Code Assist Enterprise, si ce n'est pas déjà fait.

  2. Avant de tester les fonctionnalités de Gemini Code Assist dans votre fichier de code, assurez-vous que le langage de programmation de votre fichier est compatible. Pour en savoir plus sur les langages de programmation compatibles, consultez Langages de programmation compatibles.

  3. Si vous préférez utiliser votre IDE derrière un proxy, consultez Proxy HTTP.

Générer du code avec des prompts

Les sections suivantes vous montrent comment utiliser Gemini Code Assist pour générer du code avec l'exemple de prompt Function to create a Cloud Storage bucket dans votre fichier de code. Vous pouvez aussi sélectionner une portion de votre code, puis solliciter l'aide de Gemini Code Assist via la fonctionnalité de chat. Ensuite, acceptez ou rejetez les suggestions de code proposées pendant que vous codez.

Écrire un prompt à Gemini Code Assist afin de transformer du code

La transformation de code vous permet d'utiliser des commandes ou des prompts en langage naturel depuis le menu de sélection rapide pour demander des modifications. Cette fonctionnalité fournit également une vue diff permettant de visualiser les modifications en attente pour votre code. Pour demander à Gemini Code Assist de transformer du code, procédez comme suit :

VS Code

  1. Dans votre fichier de code, sur une nouvelle ligne, appuyez sur Ctrl+I (sous Windows et Linux) ou sur Cmd+I (sous macOS) afin d'ouvrir le menu Sélection rapide de Gemini Code Assist.

  2. Dans le menu, à l'aide de la commande /generate, saisissez /generate function to create a Cloud Storage bucket, puis appuyez sur Entrée (sous Windows et Linux) ou sur Retour (sous macOS).

    Gemini Code Assist génère du code avec la commande /generate.

    À partir de votre prompt, Gemini Code Assist produit une suggestion de code, présentée dans la vue diff.

    Gemini Code Assist ouvre une vue diff pour afficher le code généré.

  3. Facultatif : Pour accepter ces modifications, cliquez sur Accepter.

IntelliJ

  1. Dans votre fichier de code, sur une nouvelle ligne, appuyez sur Alt+\ (sous Windows et Linux) ou sur Cmd+\ (sous macOS) afin d'ouvrir le menu Sélection rapide de Gemini Code Assist.

  2. Dans le menu, à l'aide de la commande /generate, saisissez /generate function to create a Cloud Storage bucket, puis appuyez sur Entrée (sous Windows et Linux) ou sur Retour (sous macOS).

    Fonction de génération de transformation de code dans Gemini Code Assist pour IntelliJ

    À partir de votre prompt, Gemini Code Assist produit une suggestion de code, présentée dans la vue diff.

    Vue diff de la transformation du code dans Gemini Code Assist pour IntelliJ

  3. Facultatif : Pour accepter ces modifications, cliquez sur Accepter les modifications.

    Vous pouvez utiliser les commandes de transformation de code suivantes dans votre IDE :

    • /fix : corriger les problèmes ou les erreurs dans votre code. Exemple : /fix potential NullPointerExceptions in my code.
    • /generate : générer du code. Exemple : /generate a function to get the current time.
    • /doc : ajouter de la documentation à votre code. Exemple : /doc this function.
    • /simplify : simplifier votre code. Exemple : /simplify if statement in this code.

Envoyer un prompt à Gemini Code Assist en ajoutant un commentaire dans un fichier de code

Si vous préférez, vous pouvez également envoyer un prompt à Gemini Code Assist en ajoutant un commentaire dans un fichier de code. Pour ce faire, procédez comme suit :

VS Code

  1. Sur une nouvelle ligne, saisissez le commentaire Function to create a Cloud Storage bucket, puis appuyez sur Entrée (sous Windows et Linux) ou Retour (sous macOS).

  2. Pour générer le code, appuyez sur Ctrl+Entrée (sous Windows ou Linux) ou sur Ctrl+Retour (sous macOS).

    À côté du texte de votre prompt dans votre fichier de code, Gemini Code Assist génère le code sous la forme de texte fantôme.

  3. Facultatif : Pour accepter le code généré, appuyez sur Tabulation.

IntelliJ

  1. Dans votre fichier de code, sur une nouvelle ligne, saisissez le commentaire Function to create a Cloud Storage bucket.

  2. Pour générer le code, appuyez sur Alt+G (sous Windows et Linux) ou sur Option+G (sous macOS). Vous pouvez également effectuer un clic droit à côté du commentaire et sélectionner Générer le code.

    Gemini Code Assist génère le code sous votre commentaire, sous la forme de texte fantôme.

  3. Facultatif : Pour accepter le code généré, appuyez sur Tabulation.

Facultatif : Modifier le raccourci clavier pour générer du code

Si le raccourci clavier par défaut pour générer du code ne fonctionne pas comme indiqué dans la section précédente, vous pouvez modifier le raccourci clavier.

Obtenir des complétions de code

Lorsque vous écrivez du code, Gemini Code Assist propose des suggestions de code intégrées, également appelées complétions de code, que vous pouvez accepter ou rejeter. Pour obtenir des complétions de code, procédez comme suit :

VS Code

  1. Dans votre fichier de code, sur une nouvelle ligne, commencez à écrire une fonction. Par exemple, si vous êtes dans un fichier Python, écrivez def.

    Gemini Code Assist suggère du code sous forme de texte fantôme.

  2. Pour accepter la suggestion de code de Gemini Code Assist, appuyez sur Tabulation. Sinon, pour l'ignorer, appuyez sur Échap ou continuez à écrire votre code.

IntelliJ

  1. Dans votre fichier de code, sur une nouvelle ligne, commencez à écrire une fonction. Par exemple, si vous êtes dans un fichier Python, écrivez def.

    Gemini Code Assist suggère du code sous forme de suggestion intégrée.

  2. Pour accepter la suggestion de code de Gemini Code Assist, appuyez sur Tabulation. Sinon, pour l'ignorer, appuyez sur Échap ou continuez à écrire votre code.

  3. Facultatif : Si vous préférez utiliser une autre touche de raccourci pour accepter la suggestion intégrée, placez le pointeur sur la suggestion intégrée et cliquez sur le menu déroulant Tabulation qui s'affiche. Ensuite, sélectionnez le raccourci de votre choix ou cliquez sur Personnalisé pour saisir votre propre raccourci.

    Gemini affiche un menu déroulant pour modifier le raccourci permettant d'accepter une suggestion intégrée.

Facultatif : Désactiver la complétion de code

La complétion de code est activée par défaut. Si vous souhaitez désactiver la complétion de code, procédez comme suit :

VS Code

  1. Dans votre IDE, cliquez sur Code (pour macOS) ou File (pour Windows et Linux), puis accédez à Settings > Settings (Paramètres > Paramètres).

  2. Dans l'onglet User (Utilisateur) de la boîte de dialogue Settings (Paramètres), accédez à Extensions > Gemini Code Assist.

  3. Faites défiler la page jusqu'à la section Duet AI: Inline Suggestions: Enable Auto (Duet AI : Suggestions intégrées : Activer automatiquement), puis sélectionnez Off (Désactivé).

    Cette action désactive les suggestions intégrées. Vous pouvez toutefois toujours appuyer sur Ctrl+Entrée (sous Windows et Linux) ou sur Ctrl+Retour (sous macOS) pour déclencher manuellement les suggestions intégrées.

IntelliJ

Dans la barre d'état de votre IDE, cliquez sur spark Gemini Code Assist: Active (Gemini Code Assist : actif), puis sélectionnez Enable AI Code Completion (Activer la complétion de code à l'aide de l'IA).

Bouton de complétion de code Gemini dans la barre d'état IntelliJ.

Cette action désactive le paramètre de complétion de code, et Gemini Code Assist ne fait plus de suggestions intégrées tant que vous ne réactivez pas le paramètre.

Obtenir des suggestions plus pertinentes avec le contexte du dépôt distant

Vous pouvez obtenir des suggestions de code plus pertinentes et adaptées au contexte en demandant à Gemini Code Assist de se concentrer sur des dépôts distants spécifiques. En utilisant le symbole @ dans le chat, vous pouvez sélectionner un ou plusieurs dépôts à utiliser comme source principale de contexte pour vos requêtes. Cela est utile lorsque vous travaillez sur une tâche qui est principalement liée à un ensemble spécifique de microservices, de bibliothèques ou de modules.

Pour utiliser un dépôt distant comme contexte, procédez comme suit dans le chat de votre IDE :

  1. Commencez votre requête par le symbole @. Une liste des dépôts distants indexés disponibles s'affiche.
  2. Dans la liste, sélectionnez le dépôt que vous souhaitez utiliser pour le contexte. Vous pouvez également commencer à saisir le nom du dépôt pour filtrer la liste.
  3. Après avoir sélectionné le dépôt, rédigez le reste de votre requête.

Gemini Code Assist donnera ensuite la priorité au dépôt sélectionné lors de la génération d'une réponse.

Exemples de requêtes

Cette section inclut des exemples de la façon dont vous pouvez obtenir des suggestions plus pertinentes avec le contexte du dépôt distant.

  • Comprendre un dépôt
    • @REPOSITORY_NAME What is the overall structure of this repository?
    • @REPOSITORY_NAME I'm a new team member. Can you give me an overview of this repository's purpose and key modules?
  • Générer et modifier du code
    • @REPOSITORY_NAME Implement an authentication function similar to the one in this repository.
    • @REPOSITORY_NAME Refactor the following code to follow the conventions in the selected repository.
    • Use the library-x in @REPOSITORY_A_NAME-A and implement the function-x
  • Test
    • @UNIT_TEST_FILE_NAME Generate unit tests for module-x based on the examples in the selected file.

En utilisant des dépôts distants comme source de contexte ciblée, vous pouvez obtenir des suggestions plus précises et pertinentes de Gemini Code Assist, ce qui peut vous aider à coder plus rapidement et plus efficacement.

Utiliser les actions intelligentes

Pour vous aider à être plus productif tout en réduisant au maximum les changements de contexte, Gemini Code Assist propose des actions intelligentes optimisées par l'IA, directement dans votre éditeur de code. Lorsque vous sélectionnez votre code dans cet éditeur, vous pouvez afficher une liste d'actions en rapport avec votre contexte et sélectionner l'action souhaitée.

Pour utiliser les actions intelligentes dans votre code, procédez comme suit :

VS Code

  1. Dans votre fichier de code, sélectionnez un bloc de code.

  2. À côté du bloc de code sélectionné, cliquez sur lightbulb Afficher les actions de code.

    L'icône en forme d'ampoule des actions intelligentes s'affiche après la sélection d'un bloc de code dans VS Code.

  3. Sélectionnez une action, par exemple Générer des tests unitaires.

    Gemini Code Assist génère une réponse en fonction de l'action que vous avez sélectionnée.

IntelliJ

  1. Dans votre fichier de code, sélectionnez une ligne ou un bloc de code.

  2. Effectuez un clic droit sur le code sélectionné, puis choisissez une action intelligente, comme Générer des tests unitaires.

    Lorsque vous sélectionnez l'action intelligente, Gemini Code Assist génère automatiquement une réponse au prompt dans la fenêtre de l'outil Gemini Code Assist.

Utiliser un correctif rapide de transformation du code

Si votre code contient une erreur, Gemini Code Assist vous permet d'appliquer une correction rapide à l'aide de la transformation du code.

Pour appliquer une correction rapide dans votre fichier de code, procédez comme suit :

VS Code

  1. Dans votre fichier de code, placez le pointeur sur la ligne marquée par une ondulation signalant une erreur, sélectionnez Correction rapide, puis /fix.

    Correction rapide de la transformation du code dans l'IDE.

  2. Une fois la correction rapide appliquée, la vue diff s'affiche. Pour accepter ces modifications, cliquez sur Accepter.

IntelliJ

  1. Dans votre fichier de code, cliquez sur l'icône en forme d'ampoule rouge, qui indique une erreur dans votre code, puis sélectionnez Corriger avec Gemini.

    Option de transformation du code pour corriger un problème avec Gemini dans l'IDE.

  2. Une fois la correction appliquée, la vue diff s'affiche. Pour accepter ces modifications, cliquez sur Accepter.

Exclure des fichiers du contexte local

Par défaut, Gemini Code Assist exclut des fichiers de l'utilisation locale dans le contexte de la complétion, de la génération et de la transformation de code, ainsi que du chat, si les fichiers sont spécifiés dans un fichier .aiexclude ou .gitignore.

Pour savoir comment exclure des fichiers de l'utilisation locale, consultez Exclure des fichiers de l'utilisation de Gemini Code Assist.

Désactiver les suggestions de code qui correspondent aux sources citées

Gemini Code Assist fournit des informations de citation lorsqu'il reprend directement et longuement une autre source, comme du code Open Source existant. Pour en savoir plus, consultez Comment et quand Gemini cite ses sources.

Pour éviter que du code correspondant aux sources citées ne vous soit suggéré, procédez comme suit :

VS Code

  1. Dans la barre d'activité de votre IDE, cliquez sur Manage (Gérer) > Settings (Paramètres).

  2. Dans l'onglet User (Utilisateur) de la fenêtre des paramètres, accédez à Extensions > Gemini Code Assist.

  3. Faites défiler l'écran jusqu'à Geminicodeassist > Récitation : longueur maximale des citations.

  4. Définissez la valeur sur 0 :

Gemini Code Assist ne vous suggère plus de code correspondant aux sources citées.

IntelliJ

  1. Dans la barre d'état de votre IDE, cliquez sur spark Gemini Code Assist: Active (Gemini Code Assist : actif), puis sélectionnez Configurer Gemini.

  2. Développez la section Paramètres avancés, puis sélectionnez Bloquer les sélections qui correspondent à des sources externes citées.

  3. Cliquez sur OK.

Gemini Code Assist ne vous suggère plus de code correspondant aux sources citées.

Problèmes connus

Cette section décrit les problèmes connus de Gemini Code Assist :

VS Code

  • Les réponses du chat peuvent être tronquées lorsqu'elles incluent une version mise à jour d'un fichier ouvert volumineux

    Pour contourner ce problème, sélectionnez une section de code plus petite et incluez une directive supplémentaire dans le prompt de chat, par exemple only output the selected code..

  • Vim : impossible d'accepter ou de rejeter les suggestions de génération de code, sauf en mode insertion

    Lorsque vous utilisez le plug-in Vim en mode normal, vous ne pouvez pas accepter ni rejeter les suggestions de code.

    Pour contourner ce problème, appuyez sur i pour passer en mode insertion, puis appuyez sur Tabulation pour accepter la suggestion.

  • Vim : le comportement n'est pas cohérent lorsque vous appuyez sur Échap pour rejeter les suggestions

    Lorsque vous appuyez sur Échap, les suggestions de l'IDE et de Gemini Code Assist sont rejetées. Ce comportement est différent de celui qui se produit lorsque vous n'utilisez pas Vim, où le fait d'appuyer sur Échap redéclenche Gemini Code Assist.

  • Les tentatives de connexion expirent sans cesse

    Si vos tentatives de connexion expirent sans cesse, essayez d'ajouter le paramètre cloudcode.beta.forceOobLogin à votre fichier settings.json :

     "cloudcode.beta.forceOobLogin": true
    
  • Les avertissements de récitation de licence ne persistent pas d'une session à l'autre

    Si les avertissements de récitation de licence ne persistent pas d'une session à l'autre, consultez les journaux persistants :

    1. Cliquez sur Affichage > Sortie.

    2. Sélectionnez Gemini Code Assist – Citations.

  • Problèmes de connectivité dans la fenêtre de sortie Gemini Code Assist

    Si une erreur de connexion ou d'autres problèmes de connectivité s'affichent dans la fenêtre de sortie de Gemini Code Assist, procédez comme suit :

    • Configurez votre pare-feu pour autoriser l'accès à oauth2.googleapis.com et cloudaicompanion.googleapis.com.

    • Configurez votre pare-feu pour autoriser la communication via HTTP/2, qui est utilisé par gRPC.

    Vous pouvez tester la connectivité à l'aide de l'outil grpc-health-probe. Si la vérification réussit, le résultat suivant s'affiche :

    $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

    Si la vérification échoue, le résultat suivant s'affiche :

    timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

    Pour obtenir plus de détails, exécutez la commande suivante avant grpc-health-probe :

    export GRPC_GO_LOG_SEVERITY_LEVEL=info
    

IntelliJ

Aucun problème connu n'a été signalé concernant Gemini Code Assist pour IntelliJ et les autres IDE JetBrains compatibles.

Laisser un commentaire

Pour nous faire part de votre expérience, procédez comme suit :

VS Code

  1. Vous pouvez nous faire part de vos commentaires de l'une des manières suivantes :

    • Dans la barre d'état, cliquez sur spark Gemini Code Assist, puis dans le menu Sélection rapide, sélectionnez Envoyer des commentaires.
    • Ouvrez la palette de commandes (Ctrl/Command+Shift+P), puis sélectionnez Gemini Code Assist : Envoyer des commentaires.
  2. Dans le formulaire, remplissez les champs Titre et Commentaires.

  3. Dans le formulaire Commentaires pour Gemini Code Assist, sélectionnez une option dans les menus déroulants Catégorie de commentaires et Type.

  4. Décrivez votre expérience en détail dans le champ Commentaire.

  5. Veillez à inclure vos journaux Gemini Code Assist dans votre rapport de commentaires. Cette option est sélectionnée par défaut.

  6. Cochez ou décochez les autres options de votre choix.

  7. Cliquez sur Envoyer des commentaires.

IntelliJ

  1. Dans la barre d'état, cliquez sur spark Gemini Code Assist.

  2. Après avoir envoyé un prompt à Gemini Code Assist dans le chat, si vous n'êtes pas satisfait de la réponse, cliquez sur thumb_down Négatif, puis sélectionnez Envoyer des commentaires.

  3. Dans le champ de texte en haut du formulaire, saisissez vos commentaires.

  4. Si vous souhaitez partager vos journaux Gemini Code Assist, assurez-vous de les sélectionner.

  5. Cliquez sur Envoyer des commentaires.

Étape suivante