Assistente AI nell'editor di codice di Earth Engine

Il riquadro Chiedi dell'editor di codice di Earth Engine utilizza Gemini per aiutarti a scrivere, comprendere, eseguire il debug e ottimizzare gli script. Funge da assistente AI conversazionale integrato direttamente nell'editor di codice per semplificare l'analisi geospaziale e lo sviluppo di script.

Interfaccia e strumenti

Il riquadro dell'assistente AI si trova nel riquadro di destra dell'editor di codice di Earth Engine. Per aprirlo, fai clic sulla scheda Chiedi accanto alle schede Ispezione, Console e Attività.

Il riquadro Chiedi include diversi controlli e strumenti per aiutarti a gestire la tua interazione con l'AI.

Pulsanti e controlli

  • Invia / Interrompi: invia il prompt all'assistente. Il pulsante si trasforma in un'icona di interruzione durante la generazione, che ti consente di annullare la richiesta. Puoi anche utilizzare il tasto enter / return per inviare.
  • Nuova chat: cancella la cronologia della conversazione e avvia una nuova sessione.
  • Guida: apre una finestra di dialogo con informazioni sulla funzionalità, sulla fatturazione e sui termini.
  • Selezione del modello: un menu a discesa che ti consente di scegliere il modello Gemini da utilizzare. Alcuni modelli potrebbero non funzionare a seconda del livello della chiave API. La tua selezione verrà salvata per la sessione successiva.
  • Attivazione/disattivazione degli strumenti: un menu che ti consente di attivare o disattivare strumenti specifici da utilizzare con l'assistente. La tua selezione verrà salvata per la sessione successiva.
  • Copia (blocchi di codice): copia il codice generato negli appunti.
  • Inserisci (blocchi di codice): inserisce il codice generato nell'editor di script. Se l'editor non è vuoto, viene visualizzata una finestra di dialogo che evidenzia le modifiche da esaminare.
  • Rigenera: nella parte inferiore dell'ultima risposta viene visualizzato un pulsante di riprova per eseguire di nuovo il prompt.
  • Contatore token: mostra il numero di token utilizzati nella sessione di conversazione corrente. Utilizzalo per monitorare l'utilizzo rispetto ai limiti della chiave API.

Opzioni dello strumento

Puoi attivare i seguenti strumenti per migliorare le risposte dell'assistente. Tieni presente che l'attivazione degli strumenti aggiunge un contesto extra (ad esempio documentazione o risultati di ricerca) alle tue richieste, il che potrebbe comportare un maggiore utilizzo di token.

  • Documenti: esegue ricerche nella documentazione pubblica di Earth Engine per fornire codice e spiegazioni accurati.
  • Ricerca per set di dati: cerca i set di dati nel Data Catalog di Earth Engine.
  • Ricerca Google: basa le risposte sui risultati della Ricerca Google per fornire informazioni aggiornate dal web. Tieni presente che lo strumento Ricerca Google non può essere utilizzato contemporaneamente a Documenti o allo strumento di ricerca per set di dati. Se attivi la Ricerca Google, gli altri strumenti non saranno disponibili nell'interfaccia utente.

Prerequisiti

Per effettuare richieste al modello, questa funzionalità utilizza la tua chiave API Gemini.

Come ottenere una chiave API Gemini

Puoi creare o visualizzare le chiavi API Gemini nel tuo progetto Cloud in Google AI Studio.

  1. Vai a Chiavi API di Google AI Studio.
  2. Fai clic su Crea chiave API e seleziona un'opzione per creare la chiave.

Per saperne di più sulle chiavi API Gemini, consulta la documentazione sulle chiavi API Gemini.

Configurare la chiave API nell'editor di codice

Una volta ottenuta la chiave API, devi aggiungerla all'editor di codice:

  1. Nel riquadro Chiedi, fai clic sull'icona a forma di chiave nella casella di immissione della chat.
  2. Incolla la chiave API nella finestra di dialogo visualizzata.
  3. (Facoltativo) Seleziona la casella per salvare la chiave per le sessioni future e fai clic su Ok.

Contesto automatico

Per fornire assistenza pertinente, la funzionalità Chiedi include automaticamente il seguente contesto in ogni richiesta:

  • Il testo completo del copione corrente nell'editor.
  • Tutti gli asset e le geometrie importati.
  • La cronologia chat della sessione corrente.

Risoluzione dei problemi relativi agli errori della console

L'assistente AI è integrato direttamente nella console dell'editor di codice per aiutarti a risolvere rapidamente gli errori di runtime:

  1. Se lo script rileva un errore, cerca la scheda di errore rossa nella scheda Console.
  2. Fai clic sul pulsante Risolvi i problemi nella scheda dell'errore.
  3. Si apre automaticamente il riquadro Chiedi e viene messa in coda una richiesta generata automaticamente contenente il messaggio di errore e il contesto pertinente dello script da inviare.

Prompt di esempio

Puoi chiedere all'assistente di aiutarti con una serie di attività digitando direttamente nella casella di chat. Ecco alcuni esempi di ciò che puoi chiedere, suddivisi per attività:

Generazione di codice e workflow

  • "Scrivi uno script per caricare le immagini di Sentinel-2 per l'anno 2023 sull'Africa orientale, filtrare la copertura nuvolosa inferiore al 10%, calcolare l'NDVI mediano e aggiungerlo alla mappa con una tavolozza di visualizzazione dal bianco al verde."
  • "Crea un composito Landsat 9 senza nuvole per l'estate 2024 in Europa centrale ed esportalo nel mio bucket Cloud Storage".

App Earth Engine

  • "Scrivi il codice per creare una mappa a doppio riquadro dell'app Earth Engine per confrontare le immagini del 2020 e del 2024 affiancate."
  • "Aggiungi un riquadro a sinistra con un menu a discesa per selezionare un anno e un pulsante per aggiornare la mappa."
  • "Aggiungi una legenda personalizzata alla mappa per la classificazione della copertura del suolo visualizzata."

Debug

  • "Ricevo l'errore "Limite di memoria utente superato". Come posso risolvere il problema?"
  • "La mia mappa mostra un livello senza varianza nei valori dei pixel, non è quello che mi aspettavo. Cosa sta succedendo?"
  • "Perché ricevo l'errore 'Image.select: Band 'NDVI' not found' quando eseguo questo calcolo?"

Spiegazione

  • "Spiega cosa fa ee.Reducer.mean().combine() alla riga 15 del mio script."
  • "Qual è la differenza tra ee.Image.clip() e ee.Image.mask()?"

Ottimizzazione

  • "Puoi ottimizzare questa operazione di mappatura della raccolta di immagini per renderla più efficiente?"
  • "Come faccio a riscrivere questa operazione reduceRegions su molti poligoni e immagini per evitare il timeout?"

Fatturazione e costi

L'utilizzo di questa funzionalità richiede una chiave API Gemini. I costi sono soggetti ai prezzi dell'API Gemini e al livello di quota della tua chiave.

  • Livello senza costi: l'API Gemini offre un livello senza costi (con limiti).
  • Livello a pagamento: se utilizzi una chiave API di un livello a pagamento, verranno addebitati costi indipendentemente dalla registrazione specifica del progetto Earth Engine.

Per maggiori dettagli, consulta Prezzi dell'API Gemini.

Monitorare l'utilizzo e controllare i costi

Puoi gestire le chiavi e visualizzare l'utilizzo e i costi direttamente in AI Studio.

  • Controlla il livello, l'utilizzo, i limiti e la spesa della tua chiave API nell'interfaccia di AI Studio.
  • Imposta un limite di spesa mensile nella scheda Spesa di AI Studio.

Dati e privacy

I tuoi dati vengono gestiti in conformità ai Termini di servizio dell'API Gemini. Assicurati di rivederle in merito all'utilizzo dei prompt e dei contenuti generati.

Feedback

Aiutaci a migliorare. Condividi il tuo feedback in qualsiasi momento facendo clic sul pulsante Feedback nell'angolo in alto a destra dell'editor di codice. Utilizza l'opzione Invia feedback sull'editor di codice. Leggiamo attivamente questi feedback per migliorare le prestazioni del modello e dare la priorità alle funzionalità.