Écrire du code dans un notebook Colab Enterprise avec l'aide de Gemini

Écrire du code dans un notebook Colab Enterprise avec l'aide de Gemini

Ce document explique comment utiliser Gemini dans Colab Enterprise, qui est un produit du portefeuille Gemini pour Google Cloud, pour vous aider à écrire du code dans un notebook Colab Enterprise.

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

Ce document est destiné aux analystes de données, aux data scientists et aux développeurs de données qui travaillent avec Colab Enterprise. Il suppose que vous savez écrire du code dans un environnement notebook.

Avant de commencer

1. Assurez-vous que Gemini dans Colab Enterprise est configuré pour votre compte utilisateur et votre projet Google Cloud .
2. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

3. Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.

   Enable the APIs

4. Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.

   Enable the APIs

Rôles requis

Pour vous assurer que votre compte utilisateur dispose des autorisations nécessaires pour écrire du code avec l'assistance Gemini dans un notebook Colab Enterprise, demandez à votre administrateur d'attribuer les rôles IAM suivants à votre compte utilisateur sur le projet:

• Utilisateur Colab Enterprise (roles/aiplatform.colabEnterpriseUser)
• Utilisateur Gemini pour Google Cloud (roles/cloudaicompanion.user)

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Votre administrateur peut également attribuer à votre compte utilisateur les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Un ou plusieurs des rôles requis incluent l'autorisation dataform.repositories.list. Les utilisateurs disposant de l'autorisation dataform.repositories.list ou du rôle Créateur de code (roles/dataform.codeCreator) dans un projet peuvent répertorier les noms des composants de code de ce projet. À l'aide de l'API Dataform ou de l'interface de ligne de commande (CLI) Dataform. Les utilisateurs sans droits d'administrateur qui utilisent BigQuery Studio ne peuvent voir que les composants de code qu'ils ont créés ou qui ont été partagés avec eux.

Configurer Gemini dans Colab Enterprise

Comme il s'agit d'une technologie encore à un stade précoce, il se peut que les produits Gemini pour Google Cloudgé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.

Pour utiliser les fonctionnalités de Gemini:

1. Dans la console Google Cloud, accédez à la page Mes notebooks de Colab Enterprise.

   Accéder à "Mes carnets"

2. Dans la barre d'outils, cliquez sur le bouton pen_spark M'aider à coder, puis sélectionnez les fonctionnalités que vous souhaitez utiliser.

   
   • La saisie semi-automatique du code suggère du code pendant que vous le saisissez.
   • La génération de code génère du code à partir d'une description de ce que vous voulez et suggère des correctifs pour les erreurs de votre code.

   Si le bouton pen_spark M'aider à coder n'est pas actif ou si aucune liste de fonctionnalités ne s'affiche lorsque vous cliquez dessus, consultez Configurer Gemini dans Colab Enterprise pour un projet.

Utiliser la complétion de code

Pour utiliser la complétion de code dans un notebook Colab Enterprise, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Mes notebooks de Colab Enterprise.

   Accéder à "Mes carnets"

2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

3. Cliquez sur le notebook que vous souhaitez ouvrir.

4. Dans la barre d'outils, cliquez sur le bouton pen_spark M'aider à coder, puis sélectionnez Complétion de code si cette option n'est pas déjà sélectionnée.

5. Dans une cellule de code de votre notebook, commencez à saisir du code. Colab Enterprise suggère une façon possible de compléter votre code en texte gris italique.

   Par exemple, si vous saisissez import p, Colab Enterprise peut suggérer une saisie de code qui importe pandas as pd, suivie d'une ligne qui lit un fichier CSV et stocke son contenu dans un dataframe pandas.
   

6. Pour accepter la suggestion de saisie du code, appuyez sur Tabulation.

Utiliser la génération de code

Pour générer du code à l'aide de Gemini pour Google Cloud:

1. Dans la console Google Cloud, accédez à la page Mes notebooks de Colab Enterprise.

   Accéder à "Mes carnets"

2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

3. Cliquez sur le notebook que vous souhaitez ouvrir.

4. Dans la barre d'outils, cliquez sur le bouton pen_spark M'aider à coder, puis sélectionnez Génération de code si ce n'est pas déjà fait.

5. Dans une cellule de code vide de votre notebook, cliquez sur generate (Générer).

6. Dans le champ pen_spark Générer, saisissez une description du code que vous souhaitez générer, puis appuyez sur Entrée.

7. Pour fermer le panneau Generate (Générer), cliquez sur Close (Fermer).

Corriger les erreurs

Preview — Error fixing

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Pour utiliser Gemini pour Google Cloud vous aider à corriger les erreurs dans votre code:

1. Dans la console Google Cloud, accédez à la page Mes notebooks de Colab Enterprise.

   Accéder à "Mes carnets"

2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

3. Cliquez sur le notebook que vous souhaitez ouvrir.

4. Dans la barre d'outils, cliquez sur le bouton pen_spark M'aider à coder, puis sélectionnez Génération de code si ce n'est pas déjà fait.

5. Dans une cellule de code de votre notebook, saisissez du code contenant une erreur, puis exécutez la cellule. Par exemple, vous pouvez saisir print(1, auquel il manque une parenthèse fermante.

   Une fois votre cellule de code exécutée, Colab Enterprise affiche un message d'erreur sous votre cellule de code. Si Gemini dans Colab Enterprise a une suggestion qui pourrait corriger votre code, un bouton Corriger l'erreur s'affiche.

6. Cliquez sur le bouton Corriger l'erreur.

   Colab Enterprise vous propose une solution au code.

7. Évaluez la suggestion, puis effectuez l'une des opérations suivantes:

   • Pour accepter la suggestion, cliquez sur  Accepter la suggestion.
   • Pour refuser la suggestion, cliquez sur  Refuser la suggestion.

Désactiver les fonctionnalités Gemini

Pour désactiver les fonctionnalités Gemini dans Colab Enterprise, procédez comme suit:

1. Dans la barre d'outils de Colab Enterprise, cliquez sur le bouton pen_spark M'aider à coder.

2. Effacez les fonctionnalités Gemini que vous souhaitez désactiver.

Résoudre les problèmes

Cette section explique comment résoudre les problèmes liés à l'utilisation de Gemini dans Colab Enterprise.

Fonctionnalités Gemini indisponibles

Lorsque vous saisissez du code dans un notebook Colab Enterprise, les suggestions de code à compléter ne s'affichent pas. Le bouton pen_spark M'aider à coder ne s'affiche pas au-dessus d'une cellule de code.

Dans les paramètres de Colab Enterprise, vous avez peut-être désactivé le paramètre Afficher les autocomplétions basées sur le contexte.

Pour résoudre ce problème, procédez comme suit :

1. Cliquez sur  Activer/Désactiver l'affichage de l'en-tête.
2. Dans le menu Outils, cliquez sur Paramètres.
3. Cliquez sur Éditeur.
4. Sélectionnez Afficher les autocomplétions basées sur le contexte.
5. Cliquez sur Enregistrer.

Étape suivante

• Consultez la présentation de Gemini pour Google Cloud.

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