Coder avec Gemini Code Assist

Ce document explique comment utiliser Gemini Code Assist, un collaborateur de Google Cloud basé sur l'IA, pour vous aider à effectuer les opérations suivantes dans Cloud Code:

  • Fournissez 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 que vous codez.

Gemini n'utilise pas vos requêtes ni ses réponses comme données pour entraîner ses modèles. Pour en savoir plus, consultez la section Utilisation de vos données par Gemini pour Google Cloud.

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

Ce document est destiné aux développeurs, quel que soit leur niveau de compétence. Nous partons du principe que vous connaissez bien IntelliJ et 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. Si ce n'est pas déjà fait, installez le plug-in Cloud Code. 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 présentées dans 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 dans 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'il vous est demandé si vous avez téléchargé Cloud Code depuis Google, cliquez sur Sign In (Connexion).

    Vous êtes maintenant 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 Settings (Paramètres).

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

    Gemini est prêt à être utilisé.

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 Genmini Code Assist, vous pouvez ignorer cette section. Pour créer un exemple d'application, procédez comme suit:

  1. Dans votre IDE, cliquez sur File > New > Project (Fichier > 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 livre d'or correspondant à votre langue, puis cliquez sur Next (Suivant).

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

  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 cet outil 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 de l'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 Open chat (Ouvrir le chat).

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

  3. Dans la fenêtre de chat Gemini Code Assist, saisissez l'invite Explain this code to me, puis cliquez sur Send (Envoyer).

    Gemini utilise le code de votre fichier de code comme référence à votre requête et répond avec une explication de votre code.

Réinitialiser l'historique des discussions

Gemini Code Assist utilise l'historique des discussions pour vous fournir plus de contexte lorsqu'il répond à vos invites.

Si l'historique de vos discussions ne correspond plus à votre objectif, vous pouvez le réinitialiser: dans le volet Gemini Code Assist, cliquez sur delete Reset Chat (Supprimer la discussion).

Générer du code avec des invites

Les sections suivantes expliquent comment utiliser Gemini Code Assist pour générer du code avec l'exemple d'invite # 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.

Demander Gemini Code Assist dans un fichier de code

  1. Créez un fichier de code ou utilisez un fichier 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, puis 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 la forme d'un texte fantôme.

  4. Facultatif: Pour accepter le code généré, appuyez sur 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 du code

Si le raccourci clavier par défaut pour générer le 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 Fichier (pour Windows et Linux) ou sur IntelliJ IDEA (pour macOS), puis accédez à Settings > Keymap (Paramètres > Mappage de clavier) > Plugins > Google Cloud Code.

  2. Faites défiler la liste des raccourcis clavier jusqu'à Générer le code.

  3. Effectuez un clic droit sur Générer le code, puis sélectionnez 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 maintenant utiliser le raccourci clavier qui vient d'être attribué pour générer du code avec Genmini 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

Pendant que 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 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, puis ouvrez le fichier front.py.

  2. 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 suggère du code sous la forme d'un 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 continuez à écrire votre code.

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

Gemini fournit des informations sur les citations lorsqu'elles sont tirées directement d'une autre source, comme un code Open Source existant. Pour en savoir plus, consultez Comment et quand Gemini cite ses sources.

Pour empêcher la suggestion de code correspondant aux sources citées, vous pouvez définir le paramètre cloudcode.duetAI.recitation.maxCitedLength sur 0 dans un fichier settings.json:

"cloudcode.duetAI.recitation.maxCitedLength": 0

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 de requêtes suivants.

Dans le volet de chat de Gemini Code Assist, saisissez l'une des invites 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 au chat peuvent être tronquées lorsqu'elles incluent la version mise à jour d'un fichier ouvert volumineux

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

IdeaVim: le plug-in n'affiche pas la suggestion Gemini Code Assist lorsque l'utilisateur appuie 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, il passe en mode de commande VIM et n'affiche pas la suggestion Geni Code Assist.

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 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 activer le mode d'insertion, puis sur Tab pour accepter la suggestion.

Pour ignorer la suggestion, appuyez sur Esc.

Laisser un commentaire

Pour nous faire part de vos 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 Submit feedback (Envoyer des commentaires).

  2. Saisissez vos commentaires dans la zone de texte située en haut du formulaire.

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

  4. Cliquez sur Envoyer des commentaires.

Étapes suivantes