Coder avec Gemini Code Assist

Ce document explique comment utiliser Gemini Code Assist, un collaborateur optimisé par l'IA disponible dans Google Cloud, pour effectuer les opérations suivantes dans Cloud Code:

  • Fournir des conseils pour vous aider à résoudre les problèmes liés à votre code

  • Générez du code pour votre projet.

  • Recevez des suggestions intégrées pendant le codage.

Découvrez comment et quand Gemini pour Google Cloud utilise vos données.

Pour vous aider à respecter les exigences de licence pour votre code, Gemini Code Assist fournit des citations de la source lorsque ses suggestions citent directement et largement une source spécifique. Pour savoir comment et quand Gemini cite ses sources, consultez Comment Gemini vous aide à générer du code et à cite ses sources.

Ce document s'adresse aux développeurs de tous niveaux. Nous partons du principe que vous avez une connaissance pratique d'IntelliJ et que vous connaissez Google Cloud. Si vous préférez, vous pouvez également explorer Gemini Code Assist dans Cloud Workstations, Cloud Code pour VS Code et l'éditeur Cloud Shell.

Avant de commencer

  1. Installez le plug-in Gemini Code Assist/Cloud Code si ce n'est pas déjà fait. Gemini Code Assist est intégré à Cloud Code pour intégrer le collaborateur optimisé par l'IA dans votre IDE local.
  2. Facultatif: si vous choisissez de cloner un exemple pour les tâches de ce document, installez Git. Git est nécessaire pour copier des exemples sur votre ordinateur.

Se connecter à Google Cloud et sélectionner un projet

Dans cette section, vous allez vous connecter à Google Cloud et sélectionner un projet Google Cloud avec l'API Cloud AI Companion activée dans votre IDE.

Si vous sélectionnez un projet Google Cloud sur lequel l'API Cloud AI Companion n'est pas activée, vous recevez une notification d'erreur et vous êtes invité à contacter votre administrateur. Pour en savoir plus, consultez Configurer Gemini Code Assist pour un projet.

Pour vous connecter à Google Cloud dans votre IDE, procédez comme suit:

  1. Lancez votre IDE.

  2. Cliquez sur Tools > Google Cloud Code > Sign in to Google Cloud Platform (Outils > Google Cloud Code > Se connecter à Google Cloud Platform).

  3. Suivez les instructions pour vous connecter à votre compte Google.

  4. Lorsqu'un message vous demandant si vous avez téléchargé Cloud Code depuis Google s'affiche, cliquez sur Sign In (Se connecter).

    Vous êtes désormais connecté à Google Cloud.

Ensuite, pour sélectionner un projet Google Cloud dans lequel l'API Cloud AI Companion est activée, procédez comme suit:

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

    Bouton de la barre d'état Gemini.

  2. Dans le menu Gemini Code Assist, sélectionnez Paramètres.

  3. Dans le champ Cloud Project (Projet Cloud), cliquez sur more_horiz Sélectionner un projet Google Cloud, puis sélectionnez un projet dans lequel l'API Cloud AI Companion est activée.

    Gemini est prêt à l'emploi.

Pour tester les fonctionnalités de Gemini Code Assist, ouvrez une application ou créez un exemple d'application dans la section suivante.

Facultatif: Créer un exemple d'application

Si vous préférez utiliser une application existante pour tester les fonctionnalités de Gemini Code Assist, vous pouvez ignorer cette section. Sinon, pour créer un exemple d'application, procédez comme suit:

  1. Dans votre IDE, cliquez sur File > New > Project (Fichier > Nouveau > Nouveau > Projet).

  2. Dans le volet gauche de la fenêtre New Project (Nouveau projet), sélectionnez Cloud Code : Kubernetes.

  3. Sélectionnez l'un des exemples de Guestbook qui correspond à votre langue préférée, puis cliquez sur Next (Suivant).

  4. Saisissez un nom de projet et choisissez son emplacement.

  5. Cliquez sur Créer.

    Cloud Code clone le modèle Python (Flask) et ouvre le projet que vous venez de créer afin de l'utiliser.

Discuter avec Gemini Code Assist

Dans cette section, vous allez apprendre à ouvrir le volet Gemini Code Assist et à discuter avec Gemini Code Assist pour obtenir une explication de votre code existant.

Pour commencer à discuter avec Gemini, procédez comme suit:

  1. Créez un fichier de code ou utilisez un fichier de code existant. Si vous utilisez l'exemple Python (Flask), vous pouvez effectuer cette tâche dans votre fichier front.py: dans la fenêtre d'outil Projet, accédez à src > frontend et ouvrez le fichier front.py.

  2. Dans la barre d'état, cliquez sur Gemini Code Assist, puis sélectionnez Ouvrir le chat.

    Le bouton Gemini dans la barre d'état Cloud Code affiche l'option "Ouvrir une discussion".

  3. Dans la fenêtre de chat Gemini Code Assist, saisissez la requête Explain this code to me et cliquez sur Envoyer.

    Gemini utilise le code de votre fichier de code comme référence à votre requête et répond en expliquant votre code.

Réinitialiser l'historique des discussions

Gemini Code Assist utilise l'historique des discussions pour obtenir plus de contexte lorsqu'il répond à vos requêtes.

Si l'historique des discussions n'est plus pertinent, vous pouvez le réinitialiser: dans le volet Gemini Code Assist, cliquez sur supprimer Réinitialiser le chat.

Générer du code avec des requêtes

Les sections suivantes vous expliquent 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 un fichier Python. Vous pouvez également recevoir, et accepter ou refuser des suggestions de code, pendant que vous codez.

Saisir une requête Gemini Code Assist dans un fichier de code

  1. Créez un fichier de code ou utilisez un fichier de code existant. Si vous utilisez l'exemple Python (Flask), vous pouvez le faire dans votre fichier front.py : dans le volet Project (Projet), accédez à python-guestbook > src > frontend et ouvrez le fichier front.py.

  2. Dans votre fichier de code, sur une nouvelle ligne, saisissez # Function to create a Cloud Storage bucket, puis appuyez sur Entrée (pour Windows et Linux) ou sur Retour (pour macOS).

  3. Pour générer du code, appuyez sur Alt+Maj+\ (pour Windows et Linux) ou Option+Maj+\ (macOS). Vous pouvez également cliquer sur spark Gemini Code Assist dans la marge de votre fichier de code.

    La marge de Cloud Code affiche l'icône Générer le code avec Gemini.

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

  4. Facultatif: Pour accepter le code généré, appuyez sur la touche Tabulation. Si vous préférez accepter une seule ligne du code généré, appuyez sur Maj+Entrée.

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

Si le raccourci clavier par défaut permettant de générer du code ne fonctionne pas comme indiqué dans la section précédente, vous pouvez modifier le raccourci clavier en procédant comme suit:

  1. Dans votre IDE, cliquez sur File (Fichier) (pour Windows et Linux) ou sur IntelliJ IDEA (pour macOS), puis accédez à Settings > Keymap > Plugins > Google Cloud Code (Paramètres > Mappage du clavier > Plugins > Plugins > Google Cloud Code).

  2. Dans la liste des raccourcis clavier, faites défiler la page jusqu'à Générer le code.

  3. Effectuez un clic droit sur Generate code (Générer le code), puis sélectionnez Add Keyboard Shortcut (Ajouter un raccourci clavier).

  4. Dans la boîte de dialogue Raccourcis clavier, double-cliquez sur le raccourci clavier actuel, puis saisissez votre propre raccourci.

  5. Cliquez sur OK.

  6. Cliquez sur Apply (Appliquer), puis sur OK.

    Vous pouvez désormais utiliser le raccourci clavier que vous venez d'attribuer pour générer du code avec Gemini Code Assist.

Pour en savoir plus sur la modification des raccourcis dans votre IDE, consultez Configurer les raccourcis clavier.

Obtenez des suggestions intégrées pendant que vous codez

Lorsque vous écrivez du code, Gemini Code Assist propose des suggestions de code intégrées que vous pouvez accepter ou ignorer. Pour essayer cette fonctionnalité, procédez comme suit:

  1. Créez un fichier de code ou utilisez un fichier de code existant. Si vous utilisez l'exemple Python (Flask), vous pouvez le faire dans votre fichier front.py : dans le volet Project (Projet), accédez à python-guestbook > src > frontend et ouvrez le fichier front.py.

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

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

  3. Pour accepter la suggestion de code de Gemini Code Assist, appuyez sur Tabulation. Sinon, pour ignorer la suggestion, appuyez sur Esc ou poursuivez l'écriture de votre code.

Tester d'autres exemples de requêtes

Après avoir lu la section Générer du code avec des invites de ce document, essayez certains des exemples d'invites suivants.

Dans le volet de chat de Gemini Code Assist, saisissez l'une des requêtes suivantes:

  • Explain this code to me.
  • Write unit tests for my code.
  • Help me debug my code.
  • Make my code more readable.

Problèmes connus

Les sections suivantes décrivent les problèmes connus de Gemini Code Assist.

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

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

IdeaVim: le plug-in n'affiche pas la suggestion Gemini Code Assist lorsque vous appuyez sur Esc pour ignorer la suggestion d'IntelliJ

Lorsque vous utilisez le plug-in IdeaVim dans IntelliJ, si vous appuyez sur Esc pour ignorer la suggestion d'IntelliJ, le mode de commande VIM est activé et la suggestion Gemini Code Assist n'est pas affichée.

Gemini Code Assist fonctionne comme prévu en mode insertion.

IdeaVim: impossible d'accepter les suggestions de génération de code, sauf en mode d'insertion.

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

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

Pour ignorer la suggestion, appuyez sur Esc.

Laisser un commentaire

Pour laisser des commentaires sur votre expérience, procédez comme suit:

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

  2. Saisissez vos commentaires dans le champ en haut du formulaire.

  3. Si vous souhaitez partager vos journaux Gemini Code Assist, veillez à sélectionner les options de journalisation.

  4. Cliquez sur Envoyer des commentaires.

Étapes suivantes