Coder avec Gemini Code Assist

Ce document explique comment utiliser Gemini Code Assist, un service dans Google Cloud, pour vous aider à effectuer les tâches suivantes Éditeur de base Cloud Workstations:

• 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 sources lorsque ses suggestions citer directement et longuement le contenu d'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. Cela suppose que vous avez une connaissance pratique Cloud Workstations et vous connaissez Google Cloud. Si vous préférez, vous pouvez aussi explorer Gemini Code Assist dans Cloud Code pour VS Code, Cloud Code pour IntelliJ Éditeur Cloud Shell.

Avant de commencer

1. Assurez-vous de disposer du rôle Administrateur Cloud Workstations un rôle IAM sur le projet afin de pouvoir créer des de configuration.

   <ph type="x-smartling-placeholder"></ph> Accéder à IAM

2. Configurer votre station de travail, si ce n'est pas déjà fait, et veillez à sélectionner Éditeur de base (Code-OSS) dans la configuration.

   <ph type="x-smartling-placeholder">
   </ph> Important:Pour utiliser Gemini Code Assist, vous devez sélectionner Éditeur de base (Code-OSS) lorsque vous créez la configuration de votre station de travail.
3. Avant de tester les fonctionnalités de Gemini Code Assist dans votre code assurez-vous que le langage de codage de votre fichier est compatible. Pour en savoir plus, sur les langages de programmation pris en charge, consultez Langages de programmation compatibles

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 station de travail.

Si vous sélectionnez un projet Google Cloud sans l'API Cloud AI Companion est activée, vous recevez une notification l'option permettant d'activer l'API depuis l'IDE. Sélectionnez Activer l'API dans le pour activer l'API pour votre projet. Pour plus d'informations, consultez Configurer Gemini Code Assist pour un projet.

<ph type="x-smartling-placeholder">

</ph> Conseil:Vous pouvez définir l'environnement GEMINI_DEFAULT_PROJECT. dans la configuration de votre station de travail pour définir automatiquement Projet d'API Cloud AI Companion sur toutes les stations de travail.

Pour vous connecter à Google Cloud votre station de travail, procédez comme suit:

1. Dans la console Google Cloud, lancez votre station de travail.

   Lancer la station de travail

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

   

3. Lorsqu'un message vous invite à vous connecter, cliquez sur Continuer pour confirmer.

4. Pour lancer le flux de connexion Google Cloud, appuyez sur Ctrl (pour Windows et Linux) ou sur Commande (pour macOS), puis cliquez sur l'URL dans la console.

5. Si vous êtes invité à autoriser Cloud Workstations à ouvrir le fichier site Web, cliquez sur Ouvrir.

6. Pour vous connecter à votre compte, suivez les instructions.

   Si vous êtes invité à vous assurer que vous avez téléchargé cette application depuis Google, cliquez sur Connectez-vous.

   Un nouvel onglet s'ouvre dans votre navigateur et affiche votre code de validation pour vous connecter. dans Cloud Code.

7. Copiez le code de validation et collez-le à l'emplacement indiqué sur votre terminal. Saisissez le code d'autorisation, puis appuyez sur Entrée (pour les systèmes Windows et Linux) ou Return (pour macOS).

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

Ensuite, pour sélectionner un projet Google Cloud incluant l'API Cloud AI Companion, , 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 Sélectionner un projet Gemini Code Assist.

3. Sélectionnez un projet Google Cloud avec le rôle API Cloud AI Companion activée.

   Gemini est prêt à l'emploi.

   

Discuter avec Gemini Code Assist

Comme il s'agit d'une technologie qui en est encore à ses débuts, Gemini pour Google Cloud produits peuvent générer des résultats qui semblent plausibles, mais qui sont en fait incorrects. Nous vous recommandons valider tous les résultats 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 le fichier de code.

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

3. Dans le volet Gemini Code Assist, saisissez la requête Explain this code to me, puis cliquez sur Envoyer Envoyer.

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

   Pour faire référence à un bloc de code spécifique au lieu de tout le code du fichier, vous sélectionnez le bloc dans votre fichier de code, puis demandez à 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éinitialiser le chat.

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

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

Les sections suivantes vous expliquent comment utiliser Gemini Code Assist pour : Générez du code avec l'exemple d'invite 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 ; 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. Dans votre fichier de code, sur une nouvelle ligne, saisissez le commentaire Function to create a Cloud Storage bucket, puis appuyez sur Entrée (pour Windows et Linux). ou Return (pour macOS).

2. Pour générer du code, appuyez sur Ctrl+Entrée (pour Windows et Linux). 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 le 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. Sur votre poste de travail, cliquez sur menu Menu, puis accédez à Fichier > Préférences > Raccourcis clavier.

2. Dans la liste des raccourcis clavier, recherchez Cloud Code: Générer du code.

3. Cliquez sur Cloud Code: Générer le code, puis sur edit Modifier le raccourci clavier.

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.

Saisir le code sélectionné dans Gemini Code Assist dans une requête dans 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 des tâches, cliquez sur spark. 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. répond à votre requête.

Obtenez 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 essayer cette fonctionnalité, suivez 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 Tabulation. Sinon, pour ignorer la suggestion, appuyez sur Esc 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. Sur votre poste de travail, sélectionnez menu Menu, puis accédez à Fichier > Préférences > 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 appuyer sur Ctrl+Entrée (pour Windows et Linux) ou Ctrl+Retour (pour macOS) pour déclencher manuellement des suggestions intégrées.

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

Gemini fournit des informations lorsqu'il cite directement à partir d'une autre source, comme le code Open Source existant. Pour plus pour en savoir plus, consultez Comment et quand Gemini cite ses sources.

Pour éviter que le code correspondant aux sources citées ne soit suggéré, vous pouvez modifier le paramètre cloudcode.duetAI.recitation.maxCitedLength sur 0 dans un Fichier settings.json:

"cloudcode.duetAI.recitation.maxCitedLength": 0

Utiliser les actions intelligentes

Pour gagner en productivité tout en limitant les changements de contexte, Gemini Code Assist propose directement des actions intelligentes basées sur l'IA dans votre éditeur de code. Lorsque vous sélectionnez votre code dans votre éditeur de code, vous pouvez afficher et faites votre choix parmi une liste d'actions adaptées à votre contexte.

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 ampoule Afficher les actions sur le 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 sélectionnée.

Aperçu: Utiliser les transformations de code

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Gemini Code Assist propose des transformations de code, ce qui permet de sélectionner une partie de votre fichier de code et de demander des modifications code existant par le biais d'invites en langage naturel, à l'aide d'une zone de texte intégrée.

Les transformations de code vous permettent d'effectuer les opérations suivantes:

• Générer des lignes de commentaire pour documenter votre code
• Résoudre les problèmes de code
• Améliorer la lisibilité du code
• Rendre le code plus efficace

Vous pouvez également consulter les sources contextuelles d'une réponse générée dans Gemini: le volet Chat.

Saisir une requête Gemini Code Assist à l'aide de la zone de texte intégrée

La zone de texte intégrée vous permet d'interagir avec Gemini Code Assist directement dans votre fichier de code.

Pour ouvrir la zone de texte intégrée et envoyer une requête à Gemini, procédez comme suit : étapes:

1. Dans votre fichier de code, appuyez sur Ctrl+I (pour les systèmes Windows et Linux) ou Commande+I (sous macOS).

2. Saisissez une requête, par exemple Write a function to create a Cloud Storage bucket, et appuyez sur Entrée (pour Windows et Linux) ou sur Retour (sous macOS).

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

Afficher les différences du code refactorisé

Avec l'affichage des différences intégrée dans la zone de texte intégrée, vous pouvez voir les modifications suggestions de Gemini et votre code d'origine. Vous pouvez ensuite accepter ou supprimer les modifications suggérées.

Pour afficher les différences du code refactorisé à partir de la zone de texte intégrée, exécutez la procédez comme suit:

1. Dans votre fichier de code, sélectionnez une fonction et ouvrez la zone de texte intégrée en appuyant sur Ctrl+I (pour Windows et Linux) ou Cmd+I (pour macOS).

2. Saisissez une requête, telle que Add comments, puis appuyez sur Entrée (pour Windows et Linux) ou Return (pour macOS).

   Quand Gemini génère les modifications de code la vue diff s'affiche.

   

3. Pour accepter ou supprimer les modifications, cliquez sur Accepter ou Supprimer.

Afficher les sources de contexte d'une réponse générée

La fonctionnalité d'affichage contextuel répertorie les fichiers de votre projet (les sources de contexte). qui ont été utilisés comme référence pour générer des réponses à vos requêtes. Le fait de savoir ont été utilisés comme références, ce qui vous aide à affiner vos requêtes et à obtenir plus des réponses spécifiques. Les sources de contexte s'affichent chaque fois que vous utilisez discussion Gemini.

Pour afficher les sources contextuelles de la réponse générée, dans la page Gemini: Chat faites défiler la page jusqu'à l'extrait Contextes (Sources de contexte). Développer l'extrait pour voir toutes les sources contextuelles.

Utiliser les commandes intelligentes

Les commandes intelligentes sont des commandes que vous pouvez utiliser dans la zone de texte intégrée pour effectuer des actions spécifiques à votre code.

Pour obtenir une explication de l'intégralité de votre fichier de code avec la classe intelligente /explain procédez comme suit:

1. Dans votre fichier de code, appuyez sur Ctrl+I pour ouvrir la zone de texte intégrée. (pour Windows et Linux) ou sur Cmd+I (sous macOS).

2. Appuyez sur / pour afficher la liste des commandes intelligentes et leur description.

3. Sélectionnez /explain.

   Gemini génère une explication de l'intégralité du fichier de code la zone de texte intégrée.

4. Facultatif: Si vous souhaitez afficher la réponse générée dans le chat Gemini: Chat cliquez sur Afficher dans Chat.

Afficher l'historique des requêtes

En accédant à l'historique de vos requêtes, vous gagnez du temps lorsque vous devez saisir les mêmes requête dans un fichier de code volumineux.

Pour accéder à l'historique de vos requêtes, ouvrez la zone de texte intégrée dans votre fichier de code en appuyant sur Ctrl+I (pour Windows et Linux) ou sur Cmd+I. (macOS), puis appuyez sur Ctrl+Flèche vers le haut (sous Windows et Linux). ou Cmd+Flèche vers le haut (sous macOS). Cela vous permet de faire défiler vos anciennes requêtes et les réutiliser si nécessaire.

Améliorez la lisibilité du code pour les anglophones non natifs

Si vous ne parlez pas l'anglais et que vous avez besoin d'applications de traduction, vous pouvez utiliser la zone de texte intégrée pour générer des commentaires dans d'autres langues.

Pour convertir les commentaires en anglais dans une autre langue ou ajouter de nouveaux commentaires dans une autre langue , procédez comme suit:

1. Dans votre fichier de code, sélectionnez le code auquel vous souhaitez ajouter des commentaires.

2. Ouvrez la zone de texte intégrée en appuyant sur Ctrl+I (sous Windows et Linux) ou Commande+I (sous macOS).

3. Saisissez une requête, telle que Add spanish comments, puis appuyez sur Entrée (pour Windows et Linux) ou Return (pour macOS).

   Gemini génère des commentaires dans la langue que vous avez spécifiée dans votre requête et affiche le différentiel de ces suggestions.

4. Pour accepter ou supprimer les modifications apportées à votre code, cliquez sur Accepter, ou Supprimer :

Tester d'autres exemples de requêtes

Après avoir lu les dans la section Générer du code avec des invites de cette , essayez quelques-uns 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. répond avec une explication de 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 Gemini Code Assist

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

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

1. Cliquez sur le menu Menu > 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, utilisé par gRPC.

Vous pouvez utiliser l'outil grpc-health-probe pour tester la connectivité. Une campagne « check » renvoie 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 de la vérification, le résultat suivant est renvoyé:

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

Gemini Code Assist et JetBrains Gateway

Gemini Code Assist ne s'exécute pas via JetBrains Gateway. Par conséquent, Gemini Code Assist ne s'exécute pas sur les IDE Cloud Workstations nécessitant la connexion de JetBrains Gateway.

"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 Cloud AI Companion, il peut y avoir un problème avec le serveur LS.

Pour en savoir plus sur votre problème, effectuez les actions suivantes:

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

2. Cliquez sur Show (Afficher) pour l'un des fichiers journaux afin d'afficher plus de détails et d'obtenir de l'aide. résoudre le problème.

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élection rapide, sélectionnez Envoyer des commentaires.

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

3. Si vous souhaitez partager votre application Skaffold ou AI Companion les journaux veillez à sélectionner l'option Send Skaffold logs (Envoyer les journaux Skaffold) ou Send AI Companion logs (Envoyer des journaux Companion à l'IA).

4. Cliquez sur Envoyer des commentaires.

Étape suivante

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