Mit Gemini Code Assist programmieren

Da es sich bei Gemini um eine Technologie im Frühstadium handelt, kann es zu Ergebnissen kommen, die zwar plausibel erscheinen, aber faktisch falsch sind. Wir empfehlen, die gesamte Ausgabe von Gemini vor der Verwendung zu validieren. Weitere Informationen finden Sie unter Gemini für Google Cloud und Responsible AI.

In diesem Dokument wird beschrieben, wie Sie Gemini Code Assist, einen KI-gestützten Mitbearbeiter in Google Cloud, für Folgendes im Basiseditor von Cloud Workstations verwenden können:

• Sie erhalten Anleitungen, um Probleme mit Ihrem Code zu lösen.

• Generieren Sie Code für Ihr Projekt.

• Inline-Vorschläge während des Codings erhalten

Gemini verwendet Ihre Prompts oder deren Antworten nicht als Daten, um seine Modelle zu trainieren. Weitere Informationen finden Sie unter So verwendet Gemini for Google Cloud Ihre Daten.

Damit Sie alle Lizenzanforderungen für Ihren Code erfüllen können, stellt Gemini Code Assist Zitationen bereit, wenn in den Vorschlägen aus einer bestimmten Quelle in großem Umfang direkt zitiert wird. Weitere Informationen dazu, wie und wann Gemini Quellen zitiert, finden Sie unter So hilft Ihnen Gemini beim Generieren von Code und Zitieren von Quellen.

Dieses Dokument richtet sich an Entwickler aller Qualifikationsstufen. Dabei werden Vorkenntnisse in Cloud Workstations und Google Cloud-Kenntnisse vorausgesetzt. Sie können den Gemini Code Assist auch in Cloud Code for VS Code, Cloud Code for IntelliJ und im Cloud Shell-Editor nutzen.

Hinweise

1. Achten Sie darauf, dass Sie die IAM-Rolle „Cloud Workstations Admin“ für das Projekt haben, damit Sie Workstationkonfigurationen erstellen können.

   Zu IAM

2. Richten Sie Ihre Workstation ein, falls noch nicht geschehen, und wählen Sie in der Konfiguration die Option Base Editor (Code-OSS) aus.

   Wichtig: Wenn Sie Gemini Code Assist verwenden möchten, müssen Sie beim Erstellen Ihrer Workstationkonfiguration Base Editor (Code-OSS) auswählen.

Mit Google Cloud verbinden und Projekt auswählen

In diesem Abschnitt stellen Sie eine Verbindung zu Google Cloud her und wählen ein Google Cloud-Projekt aus, bei dem die Cloud AI Companion API auf Ihrer Workstation aktiviert ist.

Wenn Sie ein Google Cloud-Projekt ohne aktivierte Cloud AI Companion API auswählen, erhalten Sie eine Fehlermeldung und werden aufgefordert, sich an Ihren Administrator zu wenden. Weitere Informationen finden Sie unter Gemini Code Assist für ein Projekt einrichten.

So stellen Sie auf Ihrer Workstation eine Verbindung zu Google Cloud her:

1. Starten Sie Ihre Workstation in der Google Cloud Console.

   Workstation starten

2. Klicken Sie in der Statusleiste auf Cloud Code – Sign In (Cloud Code – Anmeldung).

   

3. Wenn Sie zur Anmeldung aufgefordert werden, klicken Sie auf Weiter zur Anmeldung.

4. Drücken Sie zum Starten des Google Cloud-Anmeldevorgangs die Strg-Taste (Windows und Linux) oder die Befehlstaste (macOS) und klicken Sie auf die URL in der Konsole.

5. Folgen Sie der Anleitung, um sich in Ihrem Konto anzumelden.

   Wenn Sie aufgefordert werden, dem Google Cloud SDK Zugriff auf Ihr Google-Konto zu gewähren und den Nutzungsbedingungen zuzustimmen, klicken Sie auf Zulassen.

   In Ihrem Browser wird ein neuer Tab mit Ihrem Bestätigungscode geöffnet, mit dem Sie sich in der Google Cloud CLI anmelden können.

6. Kopieren Sie den Bestätigungscode und fügen Sie ihn im Terminal an der Stelle Enter authorization code ein. Drücken Sie dann die Eingabetaste (Windows und Linux) oder die Eingabetaste (macOS).

   Sie sind jetzt mit Google Cloud verbunden.

Führen Sie als Nächstes die folgenden Schritte aus, um ein Google Cloud-Projekt auszuwählen, für das die Cloud AI Companion API aktiviert ist:

1. Klicken Sie in der Statusleiste von Gemini Code Assist auf Gemini Code Assist.

   

2. Wählen Sie im Menü Gemini Code Assist (Gemini Code Assist) die Option Gemini Code Assist-Projekt auswählen aus.

3. Wählen Sie ein Google Cloud-Projekt aus, für das die Cloud AI Companion API aktiviert ist.

   Gemini ist einsatzbereit.

   

Öffnen Sie im nächsten Abschnitt eine Anwendung oder erstellen Sie eine Beispielanwendung, um die Funktionen von Gemini Code Assist zu testen.

Optional: Beispielanwendung erstellen

Wenn Sie zum Testen der Funktionen von Gemini Code Assist eine vorhandene Anwendung bevorzugen, können Sie diesen Abschnitt überspringen. Andernfalls erstellen Sie mit den folgenden Schritten eine Beispielanwendung:

1. Öffnen Sie auf Ihrer Workstation die Befehlspalette: Drücken Sie entweder Strg + Umschalttaste + P (Windows und Linux) oder Befehlstaste + Umschalt + P (unter macOS) und führen Sie dann Cloud Code: New Application aus.

2. Wählen Sie Kubernetes-Anwendung aus.

3. Wählen Sie die Anwendungsvorlage Python (Flask): Guestbook aus.

4. Geben Sie einen Namen für Ihre Beispielanwendung ein und klicken Sie auf OK, um sie zu speichern.

   Eine Benachrichtigung bestätigt, dass Ihre Anwendung erstellt wurde, und ein neues Fenster wird geöffnet, in dem Ihre Anwendung geladen ist.

Mit Gemini Code Assist chatten

In diesem Abschnitt erfahren Sie, wie Sie den Bereich Gemini Code Assist öffnen und mit dem Gemini Code Assist chatten, um eine Erklärung zu Ihrem vorhandenen Code zu erhalten.

Gehen Sie folgendermaßen vor, um mit Gemini zu chatten:

1. Erstellen Sie eine neue Codedatei oder verwenden Sie eine vorhandene. Wenn Sie das Python-Beispiel () verwenden, können Sie diese Aufgabe in der Datei front.py ausführen: Gehen Sie zu Explorer > src > frontend und öffnen Sie die Datei front.py.

2. Klicken Sie in der Aktivitätsleiste Ihrer Workstation auf chat_spark Gemini Code Assist.

3. Geben Sie im Bereich Gemini Code Assist (Gemini Code Assist) die Eingabeaufforderung Explain this code to me ein und klicken Sie auf Senden Senden.

   Gemini verwendet den Code in Ihrer Codedatei als Verweis auf Ihren Prompt und antwortet mit einer Erklärung Ihres Codes.

   Wenn Sie auf einen bestimmten Codeblock statt auf den gesamten Code in der Datei verweisen möchten, können Sie den Block in Ihrer Codedatei auswählen und dann Gemini dazu auffordern.

Chatprotokoll zurücksetzen

Gemini Code Assist verwendet das Chatprotokoll, um zusätzlichen Kontext beim Beantworten Ihrer Prompts zu erhalten.

Wenn Ihr Chatprotokoll für Ihre Ziele nicht mehr relevant ist, können Sie es zurücksetzen. Klicken Sie dazu im Bereich Gemini Code Assist auf Löschen Chat zurücksetzen.

Hinweis: Der Chatverlauf wird automatisch zurückgesetzt, wenn Sie den Arbeitsbereich wechseln oder die Workstation verlassen.

Code mit Prompts generieren

In den folgenden Abschnitten wird beschrieben, wie Sie mit Gemini Code Assist Code mit der Beispiel-Eingabeaufforderung # Function to create a Cloud Storage bucket in einer Python-Datei generieren können. Sie können auch einen Teil Ihres Codes auswählen und dann Gemini Code Assist über die Chatfunktion um Hilfe bitten und Codevorschläge erhalten und annehmen oder ablehnen, während Sie programmieren.

Gemini-Codeassistent in einer Codedatei abfragen

1. Erstellen Sie eine neue Codedatei oder verwenden Sie eine vorhandene. Wenn Sie das Python-Beispiel () verwenden, können Sie dies in der Datei front.py tun: Gehen Sie zu Explorer > src > frontend und öffnen Sie die Datei front.py.

2. Geben Sie in der Codedatei in einer neuen Zeile # Function to create a Cloud Storage bucket ein und drücken Sie dann die Eingabetaste (Windows und Linux) oder die Eingabetaste (macOS).

3. Drücken Sie zum Generieren von Code Strg + Eingabetaste (Windows und Linux) oder Strg + Eingabetaste (macOS).

   Neben dem Prompt-Text in der Python-Datei generiert Gemini Code Assist den Code in Form von Ghost-Text.

4. Optional: Um den generierten Code zu übernehmen, drücken Sie die Tabulatortaste.

Optional: Tastenkombination zum Generieren von Code ändern

Wenn das Standard-Tastenkürzel zum Generieren von Code nicht wie im vorherigen Abschnitt beschrieben funktioniert, können Sie es so ändern:

1. Klicken Sie in Ihrer Workstation auf Menü Menü und gehen Sie dann zu Datei > Einstellungen > Tastenkombinationen.

2. Suchen Sie in der Liste der Tastenkombinationen nach Cloud Code: Code generieren.

3. Klicken Sie auf Cloud Code: Code generieren und dann auf Tastenbindung ändern bearbeiten.

4. Geben Sie im angezeigten Dialogfeld eine eigene Tastenkombination ein.

5. Drücken Sie die Eingabetaste (Windows und Linux) oder die Eingabetaste (macOS).

   Sie können jetzt die neu zugewiesene Tastenkombination verwenden, um mit Gemini Code zu generieren.

Gemini Code Assist über den Chat mit dem ausgewählten Code anfordern

Gemini Code Assist kann basierend auf dem von Ihnen ausgewählten Code Aufgaben ausführen oder Ihre Fragen beantworten. So generieren Sie Code, der auf einer Aufforderung mit ausgewähltem Code basiert:

1. Öffnen Sie auf Ihrer Workstation eine Datei in Ihrem Projekt, die Code enthält, oder verwenden Sie dieselbe Codedatei, die Sie in den vorherigen Schritten verwendet haben.

2. Klicken Sie in der Aktivitätsleiste auf chat_spark Gemini Code Assist, um den Bereich Gemini Code Assist zu öffnen.

3. Wählen Sie in der Codedatei einen Codeblock aus.

4. Geben Sie in das Textfeld im Bereich Gemini Code Assist eine Eingabeaufforderung für den ausgewählten Code ein.

   Wählen Sie beispielsweise eine Funktion in Ihrem Code aus und geben Sie die Eingabeaufforderung Write a unit test for this function ein:

   

   Gemini verwendet Ihren ausgewählten Code als Referenz und antwortet auf Ihren Prompt.

Inline-Vorschläge beim Programmieren erhalten

Während Sie Code schreiben, macht Gemini Code Assist Inline-Codevorschläge, die Sie akzeptieren oder ignorieren können. Gehen Sie folgendermaßen vor, um diese Funktion auszuprobieren:

1. Erstellen Sie eine neue Codedatei oder verwenden Sie eine vorhandene. Wenn Sie das Python-Beispiel () verwenden, können Sie dies in der Datei front.py tun: Gehen Sie zu Explorer > src > frontend und öffnen Sie die Datei front.py.

2. Beginnen Sie in einer neuen Zeile in Ihrer Codedatei mit dem Schreiben einer Funktion. Wenn Sie beispielsweise in einer Python-Datei arbeiten, schreiben Sie def.

   Gemini schlägt Code in Form von Geistertext vor.

3. Drücken Sie die Tabulatortaste, um den Codevorschlag von Gemini Code Assistant anzunehmen. Wenn Sie den Vorschlag ignorieren möchten, drücken Sie die Esc oder fahren Sie mit dem Schreiben des Codes fort.

Optional: Inline-Vorschläge deaktivieren

Wenn Sie Inline-Vorschläge in Gemini Code Assist deaktivieren möchten, gehen Sie so vor:

1. Wählen Sie auf Ihrer Workstation Menü Menü aus und gehen Sie dann zu Datei > Einstellungen > Einstellungen.

2. Gehen Sie im Dialogfeld Einstellungen auf dem Tab Nutzer zu Erweiterungen > Cloud Code.

3. Scrollen Sie zu der Liste Cloudcode: Gemini Code Assist: Inlinespireration: Automatisch aktivieren und wählen Sie Aus aus.

   Dadurch werden die Inline-Vorschläge deaktiviert. Sie können weiterhin Strg + Eingabetaste (Windows und Linux) oder Strg + Eingabetaste (macOS) drücken, um Inline-Vorschläge manuell auszulösen.

Codevorschläge deaktivieren, die mit zitierten Quellen übereinstimmen

Gemini stellt Zitationsinformationen bereit, wenn direkt aus einer anderen Quelle zitiert wird, z. B. aus vorhandenem Open-Source-Code. Weitere Informationen finden Sie unter Wie und wann Gemini Quellen zitiert.

Wenn Sie verhindern möchten, dass Code, der mit zitierten Quellen übereinstimmt, vorgeschlagen wird, können Sie die Einstellung cloudcode.duetAI.recitation.maxCitedLength in einer settings.json-Datei zu 0 ändern:

"cloudcode.duetAI.recitation.maxCitedLength": 0

Intelligente Aktionen verwenden

Damit Sie produktiver arbeiten und gleichzeitig den Kontextwechsel minimieren können, bietet Gemini Code Assist KI-gestützte intelligente Aktionen direkt in Ihrem Code-Editor. Wenn Sie Ihren Code im Codeeditor auswählen, können Sie Aktionen aus einer Liste von Aktionen anzeigen und auswählen, die für Ihren Kontext relevant sind.

So verwenden Sie intelligente Aktionen in Ihrem Code:

1. Wählen Sie in der Codedatei einen Codeblock aus.

2. Klicken Sie neben dem ausgewählten Codeblock auf Glühbirne Codeaktionen anzeigen.

   

3. Wählen Sie eine Aktion aus, z. B. Einheitentests generieren.

   Gemini generiert eine Antwort auf Basis der von Ihnen ausgewählten Aktion.

Vorschau: Codetransformationen verwenden

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Gemini Code Assist bietet Codetransformationen. Damit können Sie einen Teil Ihrer Codedatei auswählen und über ein Inline-Textfeld über Aufforderungen in natürlicher Sprache Änderungen an Ihrem vorhandenen Code anfordern.

Mit Codetransformationen können Sie Folgendes tun:

• Kommentarzeilen generieren, um Ihren Code zu dokumentieren
• Fehler bei Code beheben
• Die Lesbarkeit von Code verbessern
• Code effizienter machen

Sie können die Kontextquellen einer generierten Antwort auch im Bereich Gemini: Chat ansehen.

Gemini-Codeassistent über das Inline-Textfeld aufrufen

Über das Inline-Textfeld können Sie direkt in Ihrer Codedatei mit Gemini CodeAssist interagieren.

So öffnen Sie das Inline-Textfeld und fordern Gemini auf:

1. Drücken Sie in der Codedatei Strg + I (Windows und Linux) oder Befehlstaste + I (macOS).

2. Geben Sie eine Eingabeaufforderung wie Write a function to create a Cloud Storage bucket ein und drücken Sie die Eingabetaste (Windows und Linux) oder die Eingabetaste (macOS).

   Gemini Code Assist generiert den Code basierend auf Ihrer Aufforderung.

Unterschied des refaktorierten Codes ansehen

Wenn die diff-Ansicht in das Inline-Textfeld integriert ist, können Sie die von Gemini vorgeschlagenen Änderungen und Ihren ursprünglichen Code sehen. Sie können die vorgeschlagenen Änderungen dann akzeptieren oder verwerfen.

Führen Sie die folgenden Schritte aus, um den Unterschied des refaktorierten Codes über das Inline-Textfeld anzuzeigen:

1. Wählen Sie in Ihrer Codedatei eine Funktion aus und öffnen Sie das Inline-Textfeld durch Drücken von Strg + I (unter Windows und Linux) oder Befehlstaste + I (unter macOS).

2. Geben Sie eine Eingabeaufforderung wie Add comments ein und drücken Sie die Eingabetaste (Windows und Linux) oder die Eingabetaste (macOS).

   Wenn Gemini die Codeänderungen an die ausgewählte Funktion generiert, wird die Ansicht „Unterschiede“ angezeigt.

   

3. Klicken Sie auf Akzeptieren oder Verwerfen, um die Änderungen zu akzeptieren oder zu verwerfen.

Kontextquellen einer generierten Antwort ansehen

Die Kontextanzeigefunktion listet Ihre Projektdateien (die Kontextquellen) auf, die als Referenz zum Generieren von Antworten auf Ihre Prompts verwendet wurden. Wenn Sie wissen, welche Dateien als Referenzen verwendet wurden, können Sie Ihre Prompts optimieren und spezifischere Antworten erhalten. Kontextquellen werden jedes Mal angezeigt, wenn Sie den Gemini-Chat verwenden.

Scrollen Sie im Bereich Gemini: Chat bis zum Snippet Kontextquellen, um die Kontextquellen der generierten Antwort zu sehen. Erweitern Sie das Snippet, um alle Kontextquellen zu sehen.

Intelligente Befehle verwenden

Intelligente Befehle sind Befehle, mit denen Sie im Inline-Textfeld bestimmte Aktionen in Ihrem Code ausführen können.

So rufen Sie eine Erläuterung der gesamten Codedatei mit dem intelligenten Befehl /explain auf:

1. Öffnen Sie in der Codedatei das Inline-Textfeld. Drücken Sie dazu Strg + I (Windows und Linux) oder Befehlstaste + I (macOS).

2. Drücken Sie /, um die Liste der intelligenten Befehle und deren Beschreibungen aufzurufen.

3. Wählen Sie /explain aus.

   Gemini generiert eine Erklärung der gesamten Codedatei im Inline-Textfeld.

4. Optional: Wenn Sie die generierte Antwort im Bereich Gemini: Chat ansehen möchten, klicken Sie auf In Chat ansehen.

Prompt-Verlauf ansehen

Mit dem Zugriff auf den Verlauf der Aufforderungen sparen Sie Zeit, wenn Sie dieselben Aufforderungen in einer großen Codedatei eingeben müssen.

Öffnen Sie zum Aufrufen des Prompt-Verlaufs in der Codedatei das Inline-Textfeld. Drücken Sie dazu Strg + I (Windows und Linux) oder Befehlstaste + I (macOS) und dann Strg + Aufwärtspfeil (Windows und Linux) oder Befehlstaste + Aufwärtspfeil (macOS). So können Sie Ihre älteren Eingabeaufforderungen durchgehen und bei Bedarf wiederverwenden.

Bessere Lesbarkeit von Code für englischsprachige Nutzer

Wenn du kein englisches Muttersprachler bist und Übersetzungsanwendungen verwendest, kannst du über das Inline-Textfeld Kommentare in anderen Sprachen generieren.

So konvertieren Sie englische Kommentare in eine andere Sprache oder fügen neue Kommentare in einer anderen Sprache hinzu:

1. Wählen Sie in der Codedatei den Code aus, dem Sie Kommentare hinzufügen möchten.

2. Öffnen Sie das Inline-Textfeld mit der Tastenkombination Strg + I (Windows und Linux) oder Befehlstaste + I (macOS).

3. Geben Sie eine Eingabeaufforderung wie Add spanish comments ein und drücken Sie die Eingabetaste (Windows und Linux) oder die Eingabetaste (macOS).

   Gemini generiert Kommentare in der Sprache, die Sie in Ihrem Prompt angegeben haben, und zeigt die Unterschiede dieser Vorschläge an.

4. Klicken Sie auf Akzeptieren oder Verwerfen, um diese Änderungen am Code zu akzeptieren oder zu verwerfen.

Andere Beispiel-Prompts testen

Nachdem Sie den Abschnitt Code mit Aufforderungen generieren in diesem Dokument gelesen haben, versuchen Sie es mit einigen der folgenden Beispiel-Prompts.

Code-Erklärung erhalten

1. Wählen Sie in Ihrer Codedatei eine Funktion aus, die erklärt werden soll.

2. Geben Sie im Bereich Gemini Code Assist die Eingabeaufforderung Explain this code to me ein.

   Gemini verwendet Ihren ausgewählten Code als Referenz und antwortet mit einer Erklärung der ausgewählten Funktion.

Testpläne erstellen

1. Wählen Sie in der Codedatei den Code aus, für den Sie Unittests hinzufügen möchten.
2. Geben Sie im Bereich Gemini Code Assist die Eingabeaufforderung Write unit tests for my code ein.

Hilfe zum Debuggen von Code

1. Wählen Sie in der Codedatei den Code aus, den Sie debuggen möchten.
2. Geben Sie im Bereich Gemini Code Assist die Eingabeaufforderung Help me debug my code ein.

Ihren Code lesbarer machen

1. Wählen Sie in Ihrer Codedatei den Code aus, der lesbarer werden soll.

2. Geben Sie im Bereich Gemini Code Assist die Eingabeaufforderung Make my code more readable ein.

   Wenn Sie sich auf einen bestimmten Teil Ihres Codes konzentrieren möchten, wählen Sie den bevorzugten Teil des Codes aus, bevor Sie Gemini aufrufen.

Bekannte Probleme

In den folgenden Abschnitten werden die bekannten Probleme von Gemini CodeAssist beschrieben.

Warnungen zu Lizenzanträgen bleiben nicht über mehrere Sitzungen hinweg erhalten.

Wenn die Warnungen zur Lizenzangabe nicht über mehrere Sitzungen hinweg bestehen, sehen Sie in den nichtflüchtigen Logs nach:

1. Klicken Sie auf Menü Menü > Ansicht > Ausgabe.

2. Wählen Sie Gemini Code Assist – Citations aus.

Verbindungsprobleme im Ausgabefenster von Gemini Code Assist

Wenn im Ausgabefenster des Gemini Code Assist ein Verbindungsfehler oder andere Verbindungsprobleme angezeigt werden, versuchen Sie Folgendes:

• Konfigurieren Sie die Firewall so, dass der Zugriff auf oauth2.googleapis.com und cloudaicompanion.googleapis.com möglich ist.

• Konfigurieren Sie Ihre Firewall so, dass die Kommunikation über HTTP/2 zugelassen wird, das von gRPC verwendet wird.

Sie können die Verbindung mit dem grpc-health-probe-Tool testen. Eine erfolgreiche Prüfung führt zu folgender Ausgabe:

$ 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

Eine fehlgeschlagene Prüfung führt zu folgender Ausgabe:

timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

Führen Sie vor grpc-health-probe folgenden Befehl aus, um weitere Details zu erhalten:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

Gemini Code Assist und JetBrains Gateway

Gemini Code Assist wird nicht über JetBrains Gateway ausgeführt. Daher wird Gemini Code Assist nicht in Cloud Workstations-IDEs ausgeführt, für die JetBrains Gateway erforderlich ist.

Feedback geben

So geben Sie uns Feedback:

1. Klicken Sie in der Statusleiste auf Gemini Code Assist und wählen Sie dann im Quick Pick-Menü die Option Send feedback aus.

2. Füllen Sie im Formular die Felder Titel und Kommentare aus.

3. Wenn Sie Ihre Skaffold- oder AI Companion-Logs freigeben möchten, müssen Sie die Option Skaffold-Logs senden oder AI Companion-Logs senden auswählen.

4. Klicken Sie auf Feedback geben.

Nächste Schritte

• Informationen zum Verfassen besserer Prompts