KI‑Assistent im Earth Engine-Code-Editor

Im Bereich „Fragen“ des Earth Engine-Code-Editors wird Gemini verwendet, um Sie beim Schreiben, Verstehen, Debuggen und Optimieren Ihrer Skripts zu unterstützen. Es fungiert als konversationeller KI-Assistent, der direkt in den Code-Editor integriert ist, um Ihre räumliche Analyse und Skriptentwicklung zu optimieren.

Oberfläche und Tools

Der Bereich des KI-Assistenten befindet sich im rechten Bereich des Earth Engine-Code-Editors. Klicken Sie zum Öffnen auf den Tab Fragen neben den Tabs Inspector, Console und Tasks.

Der Bereich „Fragen“ enthält mehrere Steuerelemente und Tools, mit denen Sie Ihre Interaktion mit der KI verwalten können.

Schaltflächen und Steuerelemente

  • Senden / Beenden: Sendet Ihren Prompt an den Assistenten. Die Schaltfläche wechselt zu einem Stoppsymbol, während die Generierung läuft. So können Sie die Anfrage abbrechen. Sie können auch die Eingabetaste (enter) oder die Eingabetaste (return) verwenden, um die Anfrage zu senden.
  • Neuer Chat: Löscht den Unterhaltungsverlauf und startet eine neue Sitzung.
  • Hilfe: Öffnet ein Dialogfeld mit Informationen zur Funktion, Abrechnung und zu den Nutzungsbedingungen.
  • Modellauswahl: Ein Drop-down-Menü, in dem Sie auswählen können, welches Gemini Modell verwendet werden soll. Je nach Stufe Ihres API-Schlüssels funktionieren einige Modelle möglicherweise nicht. Ihre Auswahl wird für die nächste Sitzung gespeichert.
  • Tool-Umschalter: Ein Menü, in dem Sie bestimmte Tools aktivieren oder deaktivieren können, die der Assistent verwenden soll. Ihre Auswahl wird für die nächste Sitzung gespeichert.
  • Kopieren (Codeblöcke): Kopiert den generierten Code in die Zwischenablage.
  • Einfügen (Codeblöcke): Fügt den generierten Code in den Skript editor ein. Wenn der Editor nicht leer ist, wird ein Dialogfeld mit den Unterschieden angezeigt, in dem die Änderungen zur Überprüfung hervorgehoben sind.
  • Neu generieren: Unten in der letzten Antwort wird eine Schaltfläche zum Wiederholen angezeigt, mit der Sie den Prompt noch einmal ausführen können.
  • Tokenzähler: Zeigt die Anzahl der Token an, die in der aktuellen Unterhaltungssitzung verwendet wurden. So können Sie die Nutzung im Vergleich zu den Limits Ihres API-Schlüssels im Blick behalten.

Tooloptionen

Sie können die folgenden Tools aktivieren, um die Antworten des Assistenten zu verbessern. Wenn Sie Tools aktivieren, wird Ihren Anfragen zusätzlicher Kontext (z. B. Dokumentation oder Suchergebnisse) hinzugefügt, was zu einer höheren Tokennutzung führen kann.

  • Docs: Durchsucht die öffentliche Earth Engine-Dokumentation , um genauen Code und Erklärungen zu liefern.
  • Datensatzsuche: Durchsucht Datensätze im Earth Engine Data Catalog.
  • Google Suche: Antworten werden anhand von Google-Suchergebnissen fundiert, um aktuelle Informationen aus dem Web bereitzustellen. Das Tool „Google Suche“ kann nicht gleichzeitig mit dem Tool „Docs“ oder „Datensatzsuche“ verwendet werden. Wenn Sie die Google Suche aktivieren, werden die anderen Tools automatisch auf der Benutzeroberfläche deaktiviert.

Vorbereitung

Für Anfragen an das Modell wird Ihr eigener Gemini API-Schlüssel verwendet.

Gemini API-Schlüssel abrufen

Sie können Gemini API-Schlüssel in Google AI Studio unter Ihrem Cloud-Projekt erstellen oder ansehen.

  1. Rufen Sie die Google AI Studio API-Schlüssel auf.
  2. Klicken Sie auf API-Schlüssel erstellen und wählen Sie eine Option aus, um Ihren Schlüssel zu erstellen.

Weitere Informationen zu Gemini API-Schlüsseln finden Sie in der Dokumentation zu Gemini API-Schlüsseln.

API-Schlüssel im Code-Editor konfigurieren

Sobald Sie Ihren API-Schlüssel haben, müssen Sie ihn dem Code-Editor hinzufügen:

  1. Klicken Sie im Bereich „Fragen“ im Eingabefeld für den Chat auf das Schlüsselsymbol.
  2. Fügen Sie Ihren API-Schlüssel in das angezeigte Dialogfeld ein.
  3. Optional können Sie das Kästchen aktivieren, um den Schlüssel für zukünftige Sitzungen zu speichern, und auf OK klicken.

Automatischer Kontext

Um relevante Unterstützung zu bieten, enthält die Funktion „Fragen“ automatisch den folgenden Kontext in jeder Anfrage:

  • Der vollständige Text Ihres aktuellen Skripts im Editor.
  • Alle importierten Assets und Geometrien.
  • Der Chatverlauf der aktuellen Sitzung.

Konsolenfehler beheben

Der KI-Assistent ist direkt in die Konsole des Code-Editors integriert, damit Sie Laufzeitfehler schnell beheben können:

  1. Wenn in Ihrem Skript ein Fehler auftritt, suchen Sie auf dem Tab Console nach der roten Fehlerkarte.
  2. Klicken Sie auf der Fehlerkarte auf die Schaltfläche Fehlerbehebung.
  3. Dadurch wird automatisch der Bereich „Fragen“ geöffnet und eine automatisch generierte Prompt-Nachricht mit der Fehlermeldung und dem relevanten Kontext aus Ihrem Skript in die Warteschlange gestellt, die Sie senden können.

Beispiele für Prompts

Sie können den Assistenten bitten, Sie bei verschiedenen Aufgaben zu unterstützen, indem Sie direkt in das Chatfeld eingeben. Hier sind einige Beispiele für Anfragen, kategorisiert nach Aufgabe:

Codegenerierung und Arbeitsabläufe

  • „Schreibe ein Skript, um Sentinel-2-Bilder für das Jahr 2023 über Ostafrika zu laden, nach einer Wolkendecke von weniger als 10 % zu filtern, den Median-NDVI zu berechnen und ihn mit einer Visualisierungspalette von Weiß zu Grün der Karte hinzuzufügen.“
  • „Erstelle ein wolkenfreies Landsat 9-Composite für den Sommer 2024 in Mitteleuropa und exportiere es in meinen Cloud Storage-Bucket.“

Earth Engine-Apps

  • „Schreibe Code, um eine Earth Engine-App-Karte mit geteiltem Bildschirm zu erstellen, um Bilder aus dem Jahr 2020 und 2024 nebeneinander zu vergleichen.“
  • „Füge links einen Bereich mit einem Drop-down-Menü hinzu, um ein Jahr auszuwählen, und eine Schaltfläche, um die Karte zu aktualisieren.“
  • „Füge der Karte eine benutzerdefinierte Legende für die angezeigte Landbedeckungsklassifizierung hinzu.“

Debugging

  • „Ich erhalte die Fehlermeldung „User memory limit exceeded“. Wie kann ich das beheben?“
  • „Auf meiner Karte wird eine Ebene mit keinen Unterschieden bei den Pixelwerten angezeigt. Das ist nicht das, was ich erwartet habe. Was läuft falsch?“
  • „Warum erhalte ich bei dieser Berechnung die Fehlermeldung „Image.select: Band 'NDVI' not found“?“

Erklärung

  • „Erkläre, was ee.Reducer.mean().combine() in Zeile 15 meines Skripts macht.“
  • „Was ist der Unterschied zwischen ee.Image.clip() und ee.Image.mask()?“

Optimierung

  • „Kannst du diesen Vorgang für die Bildersammlungskarte optimieren, damit er effizienter ausgeführt wird?“
  • „Wie kann ich diesen reduceRegions-Vorgang für viele Polygone und Bilder neu schreiben, um Zeitüberschreitungen zu vermeiden?“

Abrechnung und Kosten

Für die Verwendung dieser Funktion ist ein eigener Gemini API-Schlüssel erforderlich. Die Kosten richten sich nach den Gemini API-Preisen und der Kontingentstufe Ihres Schlüssels.

  • Free Tier: Die Gemini API bietet eine kostenlose Stufe (mit Limits).
  • Kostenpflichtige Stufe: Wenn Sie einen API-Schlüssel der kostenpflichtigen Stufe verwenden, fallen Gebühren an unabhängig von Ihrer spezifischen Earth Engine-Projektregistrierung.

Weitere Informationen finden Sie unter Gemini API-Preise.

Nutzung im Blick behalten und Kosten kontrollieren

Sie können Schlüssel verwalten und Nutzung und Kosten direkt in AI Studio ansehen.

  • Prüfen Sie die Stufe, Nutzung, Limits und Ausgaben Ihres API-Schlüssels in der AI Studio-Oberfläche.
  • Legen Sie auf dem Tab „Ausgaben“ in AI Studio eine monatliche Ausgabenobergrenze fest.

Daten und Datenschutz

Ihre Daten werden gemäß den Nutzungsbedingungen für die Gemini API verarbeitet. Lesen Sie sich diese Nutzungsbedingungen in Bezug auf die Verwendung von Prompts und generierten Inhalten durch.

Feedback

Dein Feedback ist uns wichtig. Sie können jederzeit Feedback geben. Klicken Sie dazu rechts oben im Code-Editor auf die Schaltfläche „Feedback“. Wählen Sie die Option Feedback zum Code-Editor senden aus. Wir lesen dieses Feedback aktiv, um die Modellleistung zu verbessern und Funktionen zu priorisieren.