Assistant IA dans l'éditeur de code Earth Engine

Le panneau "Demander" de l'éditeur de code Earth Engine utilise Gemini pour vous aider à écrire, comprendre, déboguer et optimiser vos scripts. Il s'agit d'un assistant IA conversationnel intégré directement à l'éditeur de code pour simplifier votre analyse géospatiale et le développement de scripts.

Interface et outils

Le panneau de l'assistant IA se trouve dans le volet de droite de l'éditeur de code Earth Engine. Pour l'ouvrir, cliquez sur l'onglet Demander à côté des onglets Inspecteur, Console et Tâches.

Le panneau "Demander" comprend plusieurs commandes et outils qui vous aident à gérer votre interaction avec l'IA.

Boutons et commandes

  • Envoyer / Arrêter : envoie votre prompt à l'assistant. Le bouton bascule vers une icône d'arrêt pendant la génération, ce qui vous permet d'annuler la requête. Vous pouvez également utiliser la touche enter / return pour envoyer.
  • Nouvelle discussion : efface l'historique des conversations et démarre une nouvelle session.
  • Aide : ouvre une boîte de dialogue contenant des informations sur la fonctionnalité, la facturation et les conditions d'utilisation.
  • Sélection du modèle : menu déroulant qui vous permet de choisir le modèle Gemini à utiliser. Il est possible que certains modèles ne fonctionnent pas en fonction du niveau de votre clé API. Votre sélection sera enregistrée pour votre prochaine session.
  • Boutons d'activation/de désactivation des outils : menu qui vous permet d'activer ou de désactiver des outils spécifiques que l'assistant peut utiliser. Votre sélection sera enregistrée pour votre prochaine session.
  • Copier (blocs de code) : copie le code généré dans votre presse-papiers.
  • Insérer (blocs de code) : insère le code généré dans votre éditeur de script. Si l'éditeur n'est pas vide, une boîte de dialogue de différence s'affiche et met en évidence les modifications à examiner.
  • Regénérer : un bouton de nouvelle tentative s'affiche en bas de la dernière réponse pour exécuter à nouveau le prompt.
  • Compteur de jetons : affiche le nombre de jetons utilisés dans la session de conversation actuelle. Utilisez-le pour surveiller votre utilisation par rapport aux limites de votre clé API.

Options de l'outil

Vous pouvez activer les outils suivants pour améliorer les réponses de l'assistant. Notez que l'activation des outils ajoute un contexte supplémentaire (tel que la documentation ou les résultats de recherche) à vos requêtes, ce qui peut entraîner une utilisation plus importante des jetons.

  • Docs : effectue une recherche dans la documentation publique d'Earth Engine pour fournir un code et des explications précis.
  • Recherche d'ensembles de données : recherche des ensembles de données dans le catalogue de données Earth Engine.
  • Recherche Google : ancre les réponses dans les résultats de recherche Google pour fournir des informations à jour provenant du Web. Notez que l'outil Recherche Google ne peut pas être utilisé simultanément avec l'outil Docs ou Recherche d'ensembles de données. Si vous activez Recherche Google, les autres outils ne seront plus disponibles dans l'interface utilisateur.

Prérequis

Pour envoyer des requêtes au modèle, cette fonctionnalité utilise votre propre clé API Gemini.

Obtenir une clé API Gemini

Vous pouvez créer ou afficher des clés API Gemini dans votre projet Cloud dans Google AI Studio.

  1. Accédez aux clés API Google AI Studio.
  2. Cliquez sur Créer une clé API , puis sélectionnez une option pour créer votre clé.

Pour en savoir plus sur les clés API Gemini, consultez la documentation sur les clés API Gemini.

Configurer votre clé API dans l'éditeur de code

Une fois que vous disposez de votre clé API, vous devez l'ajouter à l'éditeur de code :

  1. Dans le panneau "Demander", cliquez sur l'icône de clé dans la zone de saisie du chat.
  2. Collez votre clé API dans la boîte de dialogue qui s'affiche.
  3. Vous pouvez également cocher la case pour enregistrer la clé pour les sessions futures, puis cliquer sur OK.

Contexte automatique

Pour fournir une assistance pertinente, la fonctionnalité "Demander" inclut automatiquement le contexte suivant dans chaque requête :

  • Le texte intégral de votre script actuel dans l'éditeur.
  • Tous les éléments et géométries importés.
  • L'historique des discussions de la session actuelle.

Résoudre les erreurs de la console

L'assistant IA est intégré directement à la console de l'éditeur de code pour vous aider à résoudre rapidement les erreurs d'exécution :

  1. Si votre script rencontre une erreur, recherchez la fiche d'erreur rouge dans l'onglet Console.
  2. Cliquez sur le bouton Résoudre les problèmes de la fiche d'erreur.
  3. Le panneau "Demander" s'ouvre automatiquement et met en file d'attente un message de prompt généré automatiquement contenant le message d'erreur et le contexte pertinent de votre script que vous pouvez envoyer.

Exemples de prompts

Vous pouvez demander à l'assistant de vous aider à effectuer diverses tâches en saisissant directement du texte dans la zone de chat. Voici quelques exemples de ce que vous pouvez demander, classés par tâche :

Génération de code et workflows

  • "Écris un script pour charger les images Sentinel-2 de l'année 2023 au-dessus de l'Afrique de l'Est, filtre les images avec une couverture nuageuse inférieure à 10%, calcule l'indice NDVI médian et ajoute-le à la carte avec une palette de visualisation allant du blanc au vert."
  • "Crée un composite Landsat 9 sans nuage pour l'été 2024 en Europe centrale et exporte-le vers mon bucket Cloud Storage."

Applications Earth Engine

  • "Écris du code pour créer une carte à volet divisé dans une application Earth Engine afin de comparer côte à côte des images de 2020 et 2024."
  • "Ajoute un panneau sur la gauche avec un menu déroulant pour sélectionner une année et un bouton pour actualiser la carte."
  • "Ajoute une légende personnalisée à la carte pour la classification de la couverture terrestre affichée."

Débogage

  • "Je reçois une erreur 'Limite de mémoire utilisateur dépassée'. Comment puis-je résoudre ce problème ?"
  • "Ma carte affiche une couche sans variance dans les valeurs de pixels. Ce n'est pas ce à quoi je m'attendais. Qu'est-ce qui ne va pas ?"
  • "Pourquoi l'erreur 'Image.select: Band 'NDVI' not found' s'affiche-t-elle lorsque j'exécute ce calcul ?"

Explication

  • "Explique ce que fait ee.Reducer.mean().combine() à la ligne 15 de mon script."
  • "Quelle est la différence entre ee.Image.clip() et ee.Image.mask() ?"

Optimisation

  • "Peux-tu optimiser cette opération de carte de collection d'images pour qu'elle s'exécute plus efficacement ?"
  • "Comment puis-je réécrire cette opération reduceRegions sur de nombreux polygones et images pour éviter le délai d'attente ?"

Facturation et coûts

Pour utiliser cette fonctionnalité, vous devez disposer de votre propre clé API Gemini. Les coûts sont soumis aux tarifs de l'API Gemini et au niveau de quota de votre clé.

  • Niveau sans frais : l'API Gemini propose un niveau sans frais (avec des limites).
  • Niveau payant : si vous utilisez une clé API de niveau payant, des frais vous seront facturés quelle que soit l'inscription spécifique de votre projet Earth Engine.

Pour en savoir plus, consultez la page Tarifs de l'API Gemini.

Surveiller l'utilisation et contrôler les coûts

Vous pouvez gérer les clés, afficher l'utilisation et les coûts directement dans AI Studio.

  • Vérifiez le niveau, l'utilisation, les limites et les dépenses de votre clé API dans l'interface AI Studio.
  • Définissez un plafond de dépenses mensuel dans l'onglet "Dépenses" d'AI Studio.

Données et confidentialité

Vos données sont traitées conformément aux Conditions d'utilisation de l'API Gemini. Veillez à les consulter concernant l'utilisation des prompts et du contenu généré.

Commentaires

Aidez-nous à l'améliorer. Vous pouvez nous faire part de vos commentaires à tout moment en cliquant sur le bouton "Commentaires" en haut à droite de l'éditeur de code. Utilisez l'option Envoyer des commentaires sur l'éditeur de code. Nous lisons activement ces commentaires pour améliorer les performances du modèle et hiérarchiser les fonctionnalités.