Coder avec Gemini Code Assist

Ce document explique comment utiliser Gemini Code Assist, un service dans Google Cloud pour vous aider à 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.

• recevoir des suggestions intégrées pendant que vous codez ;

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 longuement une source spécifique. Pour en savoir plus sur la façon dont et lorsque 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 posséder une connaissance pratique de VS Code et connaissent Google Cloud. Si vous préférez, vous pouvez également découvrir l'assistance de code Gemini dans Cloud Workstations, Cloud Code pour IntelliJ et l'éditeur Cloud Shell.

Avant de commencer

1. Avant de tester les fonctionnalités de Gemini Code Assist dans votre fichier de code, assurez-vous que le langage de codage de votre fichier est compatible. Pour plus d'informations sur les langages de programmation pris en charge, consultez Langages de programmation compatibles

2. Installez l'extension Gemini Code Assist + Cloud Code si ce n'est pas déjà fait. Cloud Code s'intègre Gemini Code Assist dans votre IDE.

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

Se connecter à Google Cloud et sélectionner un projet

Dans cette section, vous allez vous connecter à Google Cloud et sélectionner Projet Google Cloud avec l'API Gemini pour Google Cloud activée dans votre IDE.

Si vous sélectionnez un projet Google Cloud sans Gemini pour l'API Google Cloud est activé, vous recevez une notification l'option permettant d'activer l'API depuis l'IDE. Sélectionnez Enable the API (Activer l'API) dans la fenêtre de notification pour activer l'API pour votre projet. Pour en savoir plus, consultez la section Configurer Gemini Code Assist pour un projet.

Si vous préférez suivre le tutoriel Coder avec Gemini Code Assist directement dans votre IDE, cliquez sur Lancer VS Code et suivez les étapes du tutoriel pour vous connecter à Google Cloud et activer Gemini Code Assist.

Lancer VS Code

Sinon, procédez comme suit:

1. Lancez votre IDE.

2. Dans la barre d'état, cliquez sur Cloud Code - Connexion.

   

3. Lorsque vous êtes invité à autoriser Cloud Code à ouvrir le site Web externe, cliquez sur Ouvrir :

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

5. Lorsque vous êtes invité à indiquer si vous avez téléchargé Cloud Code depuis Google, cliquez sur Se connecter.

   Remarque :Si vos tentatives de connexion n'expirent pas, consultez la Le délai d'expiration des tentatives de connexion n'est pas dépassé pour en savoir plus sur le dépannage.

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

Pour sélectionner un projet Google Cloud pour lequel l'API Gemini pour Google Cloud est activée, procédez comme suit :

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

   

2. Dans le menu Gemini Code Assist, sélectionnez Select Gemini Code project (Sélectionner un projet Gemini Code).

3. Sélectionnez un projet Google Cloud pour lequel l'API Gemini pour Google Cloud est activée.

   Gemini est prêt à être utilisé.

   

Discuter avec Gemini Code Assist

En tant que nouvelle technologie, il se peut que les produits Gemini pour Google Cloud génèrent des résultats qui semblent plausibles, mais qui sont en fait incorrects. Nous vous recommandons de valider toutes les sorties des produits Gemini pour Google Cloud avant de les utiliser. Pour en savoir plus, consultez la page Gemini pour Google Cloud et l'IA responsable.

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

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

1. Ouvrez votre fichier de code.

2. Dans la barre d'activité IDE, cliquez sur spark Gemini Code Assist.

3. Dans le volet 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 en fournissant une explication de votre code.

   Pour faire référence à un bloc de code spécifique au lieu de l'ensemble du code du fichier, vous pouvez sélectionner le bloc dans votre fichier de code, puis demander à Gemini.

Réinitialiser l'historique des discussions

Gemini Code Assist utilise l'historique des discussions pour fournir plus de contexte lorsque vous répondez à vos requêtes.

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

Remarque :L'historique des discussions est automatiquement réinitialisé lorsque vous changez d'espace de travail ou quittez votre IDE.

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

Les sections suivantes vous expliquent comment utiliser l'assistance de code Gemini pour générer du code avec l'invite exemple 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, et recevoir des suggestions de code, puis les accepter ou les refuser pendant que vous codez.

Inviter Gemini Code Assist dans un fichier de code

1. Dans votre fichier de code, sur une nouvelle ligne, appuyez sur Ctrl+I (pour Windows et Linux) ou sur Commande+I (pour macOS) pour ouvrir le menu Sélection rapide de l'assistance de code Gemini.

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.

Facultatif: Inviter Gemini Code Assist dans un fichier de code avec un commentaire

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 :

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 sur 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 la requête dans votre fichier de code, Gemini Code Assist génère le code sous forme de texte fantôme.

3. Facultatif : Pour accepter le code généré, appuyez sur la touche 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 en suivant ces étapes:

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

2. Dans la liste des raccourcis clavier, faites défiler la page jusqu'à Cloud Code : générer du code.

3. Cliquez sur Cloud Code: Générer le code, puis sur edit Modifier la combinaison de touches.

4. Dans la boîte de dialogue qui s'affiche, saisissez votre propre raccourci.

5. Appuyez sur Entrée (pour Windows et Linux) ou sur Retour (pour macOS).

   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 Raccourcis clavier pour Visual Studio Code

Interroger Gemini Code Assist avec le code sélectionné à l'aide du chat

Gemini Code Assist peut effectuer des tâches ou répondre à vos questions en fonction du code sélectionné. Pour générer un code basé sur un avec le code sélectionné, procédez comme suit:

1. Dans la barre d'activité, cliquez sur étincelle Gemini Code Assist pour ouvrir le volet Gemini Code Assist.

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

3. Dans le champ de texte du volet Gemini Code Assist, saisissez une requête code sélectionné.

   Par exemple, sélectionnez une fonction dans votre code et saisissez l'invite Write a unit test for this function :

   

   Gemini utilise le code sélectionné comme référence et répond à votre requête.

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

Lorsque vous écrivez du code, Gemini Code Assist intègre votre code que vous pouvez accepter ou ignorer. Pour tester cette fonctionnalité, procédez comme suit :

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 suggère du code sous la forme de texte fantôme.

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

Facultatif : Désactiver les suggestions intégrées

Si vous préférez désactiver les suggestions intégrées dans Gemini Code Assist, procédez comme suit:

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

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

3. Faites défiler l'écran jusqu'à Cloudcode: Gemini Code Assist: Suggestions intégrées: Activer. Auto, puis sélectionnez Désactivé.

   Les suggestions intégrées sont alors désactivé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.

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

Gemini fournit des informations de citation lorsqu'il cite directement et longuement une autre source, comme du code Open Source existant. Pour plus 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 modifier le paramètre cloudcode.duetAI.recitation.maxCitedLength sur 0 dans un fichier settings.json :

"cloudcode.duetAI.recitation.maxCitedLength": 0

Utiliser des 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 des actions intelligentes dans votre code, procédez comme suit:

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 génère une réponse basée sur l'action que vous avez sélectionnée.

Tester d'autres exemples de requêtes

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

Obtenir une explication du code

1. Dans votre fichier de code, sélectionnez une fonction pour laquelle vous souhaitez obtenir des explications.

2. Dans le volet Gemini Code Assist, saisissez la requête Explain this code to me.

   Gemini utilise le code sélectionné comme référence et répond en expliquant la fonction sélectionnée.

Générer des plans de test

1. Dans votre fichier de code, sélectionnez le code pour lequel vous souhaitez ajouter des tests unitaires.
2. Dans le volet Gemini Code Assist, saisissez la requête Write unit tests for my code.

Obtenir de l'aide pour déboguer du code

1. Dans votre fichier de code, sélectionnez le code que vous souhaitez déboguer.
2. Dans le volet Gemini Code Assist, saisissez la requête Help me debug my code.

Rendre votre code plus lisible

1. Dans votre fichier de code, sélectionnez le code que vous souhaitez rendre plus lisible.

2. Dans le volet Gemini Code Assist, saisissez la requête Make my code more readable.

   Si vous préférez vous concentrer sur une partie spécifique de votre code, sélectionnez la partie de code préférée avant d'interroger Gemini.

Problèmes connus

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

Les réponses dans le 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 l'invite de chat, par exemple only output the selected code..

Vim : impossible d'accepter ou d'ignorer les suggestions de génération de code en dehors du 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 sur Tabulation pour accepter la suggestion.

Vim: comportement incohérent lorsque l'utilisateur appuie sur Échap pour ignorer les suggestions

Lorsque vous appuyez sur Échap, les suggestions de l'IDE et de Gemini sont ignorées. Ce comportement est différent de celui Appuyez sur Échap pour déclencher de nouveau Gemini.

Les tentatives de connexion n'expirent pas

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 de récitation de licence ne persistent pas entre les sessions

Si les avertissements concernant la récitation de licences 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 de Gemini Code Assist

Si vous constatez une erreur de connexion ou d'autres problèmes de connectivité dans le dans la fenêtre de sortie de Gemini Code Assist, essayez ce qui 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, que gRPC utilise.

Vous pouvez utiliser l'outil grpc-health-probe pour tester la connectivité. Une campagne « check » génère le résultat suivant:

$ 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

En cas d'échec, 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

"Activer Gemini Code Assist" apparaît toujours après avoir sélectionné le projet Gemini Code Assist

Si vous avez sélectionné votre projet en suivant les instructions de cette qui implique d'activer 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'afficher plus de détails et de résoudre le problème.

Laisser un commentaire

Pour donner votre avis sur votre expérience, procédez comme suit :

1. Dans la barre d'état, cliquez sur Gemini Code Assist (Assistance au code Gemini), puis dans le menu Quick Pick (Sélection rapide), sélectionnez Send feedback (Envoyer des commentaires).

2. Dans le formulaire, renseignez les champs Titre et Commentaires.

3. Si vous souhaitez partager vos journaux Skaffold ou AI Companion, veillez à sélectionner l'option Envoyer les journaux Skaffold ou Envoyer les journaux AI Companion.

4. Cliquez sur Envoyer des commentaires.

Étape suivante

• Découvrez comment rédiger de meilleures requêtes.