Coder avec Gemini Code Assist Standard et Enterprise

Ce document explique comment utiliser Gemini Code Assist Standard et Enterprise, un collaborateur optimisé par l'IA dans votre IDE, pour vous aider à effectuer les opérations suivantes dans VS Code ou IntelliJ, ainsi que dans d'autres IDE JetBrains compatibles :

• Générez du code pour votre projet grâce à la transformation de code.
• Recevez des suggestions 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 basées sur la base de code privée de votre organisation directement depuis Gemini Code Assist Enterprise. Découvrez comment configurer la personnalisation du code.

Ce document s'adresse aux développeurs de tous niveaux. Il suppose que vous avez une connaissance pratique de VS Code ou IntelliJ, ainsi que d'autres IDE JetBrains compatibles, et que vous êtes familiarisé avec Google Cloud. Si vous préférez, vous pouvez également explorer Gemini Code Assist dans l'éditeur Cloud Shell, les Cloud Workstations et Android Studio.

Remarque : Le comportement de la génération, de la saisie semi-automatique et de la transformation de code n'est pas déterministe lorsqu'il est utilisé simultanément avec d'autres plug-ins qui implémentent les mêmes raccourcis et/ou utilisent la même API de plate-forme pour traiter ces actions.

Avant de commencer

VS Code

1. Configurez Gemini Code Assist Standard ou 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 Standard ou 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 requêtes

Les sections suivantes vous montrent comment utiliser Gemini Code Assist pour générer du code avec l'exemple de requête Function to create a Cloud Storage bucket dans votre fichier de code. Vous pouvez également sélectionner une partie de votre code, puis demander de l'aide à Gemini Code Assist via la fonctionnalité de chat. Vous pouvez ensuite accepter ou refuser les suggestions de code pendant que vous codez.

Demander à Gemini Code Assist de transformer du code

La transformation de code vous permet d'utiliser des commandes ou des requêtes en langage naturel dans le menu "Quick Pick" pour demander des modifications à votre code. Elle vous fournit également une vue diff pour afficher les modifications en attente de 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 (pour Windows et Linux) ou Cmd+I (pour macOS) pour 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 (pour Windows et Linux) ou sur Retour (pour macOS).

   

   Gemini Code Assist génère le code en fonction de votre requête dans une vue Diff.

   

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

IntelliJ

1. Dans votre fichier de code, sur une nouvelle ligne, appuyez sur Alt+\ (pour Windows et Linux) ou sur Cmd+\ (pour macOS) pour ouvrir le menu Quick Pick 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 (pour Windows et Linux) ou Retour (pour macOS).

   

   Gemini Code Assist génère le code en fonction de votre requête dans une vue Diff.

   

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 : corrigez 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 : ajoutez de la documentation à votre code. Exemple : /doc this function.
   • /simplify : simplifiez votre code. Exemple : /simplify if statement in this code.

Demander à Gemini Code Assist d'ajouter un commentaire dans un fichier de code

Si vous préférez, vous pouvez également demander à Gemini Code Assist d'ajouter un commentaire dans votre fichier de code en procédant comme suit :

VS Code

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

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

   À côté du texte de votre requête 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 du code, appuyez sur Alt+G (pour Windows et Linux) ou sur Option+G (pour 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 le modifier.

Obtenir des suggestions 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 ignorer. Pour obtenir des suggestions 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 la forme d'une 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, pointez 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.

   

Facultatif : Désactiver la saisie automatique de code

La saisie semi-automatique du code est activée par défaut. Si vous souhaitez désactiver la saisie semi-automatique de code, procédez comme suit :

VS Code

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

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

3. Faites défiler la page jusqu'à la liste Duet AI : suggestions intégrées : activer le mode automatique, puis sélectionnez Désactivé.

   Cela désactive les suggestions intégrées. Vous pouvez toujours appuyer sur Ctrl+Entrée (pour Windows et Linux) ou Ctrl+Retour (pour 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 : actif, puis sélectionnez Activer la saisie de code par IA.

Cela 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.

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.

   

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 sélectionnez une action intelligente, comme Générer des tests unitaires.

   Si vous sélectionnez l'action intelligente, Gemini Code Assist génère automatiquement une réponse à la requête dans la fenêtre d'outil Gemini Code Assist.

Utiliser le correctif rapide de transformation du code

Si votre code contient une erreur, Gemini Code Assist vous permet d'appliquer un correctif 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, pointez sur la ligne d'erreur ondulée, sélectionnez Quick Fix (Correction rapide), puis /fix.

   

2. Une fois la correction rapide appliquée, une vue diff apparaît. 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.

   

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

Exclure des fichiers du contexte local

Par défaut, Gemini Code Assist exclut les fichiers de l'utilisation locale dans le contexte de la complétion de code, de la génération de code, de la transformation de code et 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

Remarque : Il n'est pas possible de désactiver les suggestions de code qui correspondent aux sources citées dans IntelliJ et d'autres IDE JetBrains.

Gemini Code Assist fournit des informations sur les citations lorsqu'il cite 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 :

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

2. Dans l'onglet 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.

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 grand fichier ouvert.

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

• Vim : impossible d'accepter ou de fermer 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 ignorer 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 : comportement incohérent lorsque vous appuyez sur Échap pour fermer les suggestions

  Lorsque vous appuyez sur Échap, les suggestions de l'IDE et de Gemini Code Assist sont ignorées. Ce comportement est différent de celui sans Vim, où appuyer sur Échap redéclenche Gemini Code Assist.

• Les tentatives de connexion expirent sans cesse

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

   "cloudcode.beta.forceOobLogin": true
  

• Les avertissements concernant la récitation de la licence ne persistent pas d'une session à l'autre

  Si les avertissements concernant la récitation de la 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 l'assistance au codage Gemini, 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 utiliser l'outil grpc-health-probe pour tester la connectivité. 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
  

• L'option "Activer Gemini Code Assist" s'affiche toujours après la sélection du projet Gemini Code Assist

  Si vous avez sélectionné votre projet en suivant les instructions de ce guide, qui incluent l'activation de l'API Gemini pour Google Cloud, il peut y avoir un problème avec le serveur LS.

  Pour en savoir plus sur votre problème, procédez comme suit :

  1. Dans la barre d'état, cliquez sur spark Gemini Code Assist, puis sélectionnez Envoyer des commentaires.

  2. Cliquez sur Afficher pour l'un des fichiers journaux afin d'en savoir plus et de résoudre le problème.

IntelliJ

Aucun problème connu n'a été identifié pour 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 Quick Pick (Sélection rapide), sélectionnez Send feedback (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 sollicité 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 sélectionner les fichiers journaux.

5. Cliquez sur Envoyer des commentaires.

Étapes suivantes

• Découvrez comment rédiger des requêtes plus efficaces.
• Découvrez comment Gemini pour Google Cloud utilise vos données.
• En savoir plus sur les tarifs de Gemini Code Assist
• En savoir plus sur la conformitéGoogle Cloud