Mit Gemini Code Assist programmieren

• Geben Sie eine Anleitung, wie Sie Probleme mit Ihrem Code beheben können.

• Code für Ihr Projekt generieren

• Sie erhalten Inline-Vorschläge, während Sie programmieren.

Weitere Informationen dazu, wie und wann Gemini for Google Cloud Ihre Daten verwendet

Mit der Codeanpassung erhalten Sie Codevorschläge basierend auf der privaten Codebasis Ihrer Organisation direkt von Gemini Code Assist. Weitere Informationen zum Konfigurieren der Codeanpassung

Dieses Dokument richtet sich an Entwickler aller Erfahrungsstufen. Es wird davon ausgegangen, dass Sie mit Cloud Workstations vertraut sind und Google Cloud kennen. Alternativ können Sie Gemini Code Assist auch in Cloud Code für VS Code, Cloud Code für IntelliJ und Cloud Shell-Editor ausprobieren.

Hinweise

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

   IAM aufrufen

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

3. Bevor Sie die Funktionen von Gemini Code Assist in Ihrer Codedatei testen, prüfen Sie, ob die Programmiersprache Ihrer Datei unterstützt wird. Weitere Informationen zu unterstützten Programmiersprachen finden Sie unter Unterstützte Programmiersprachen.

Verbindung zu Google Cloud herstellen und ein Projekt auswählen

In diesem Abschnitt stellen Sie eine Verbindung zu Google Cloud her und wählen ein Google Cloud-Projekt mit aktivierter Gemini for Google Cloud API auf Ihrer Workstation aus.

Wenn Sie ein Google Cloud-Projekt auswählen, für das die Gemini for Google Cloud API nicht aktiviert ist, erhalten Sie eine Benachrichtigung, in der Sie die Möglichkeit haben, die API über die IDE zu aktivieren. Wählen Sie im Benachrichtigungsfenster API aktivieren aus, um die API für Ihr Projekt zu aktivieren. Weitere Informationen finden Sie unter Gemini Code Assist für ein Projekt einrichten.

So stellen Sie eine Verbindung zwischen der Workstation und Google Cloud her:

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

   Workstation starten

2. Klicken Sie in der Statusleiste auf Cloud Code – Anmelden.

   

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

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

5. Wenn Sie aufgefordert werden, Cloud Workstations zu erlauben, die externe Website zu öffnen, klicken Sie auf Öffnen.

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

   Wenn Sie aufgefordert werden, zu bestätigen, dass Sie diese App von Google heruntergeladen haben, klicken Sie auf Anmelden.

   Im Browser wird ein neuer Tab mit Ihrem Bestätigungscode geöffnet, mit dem Sie sich in Cloud Code anmelden können.

7. Kopieren Sie den Bestätigungscode und fügen Sie ihn in das Terminal unter Autorisierungscode eingeben ein. Drücken Sie dann die Eingabetaste (für Windows und Linux) oder die Return-Taste (für macOS).

   Sie sind jetzt mit Google Cloud verbunden.

So wählen Sie ein Google Cloud-Projekt mit aktivierter Gemini for Google Cloud API aus:

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

   

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

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

   Gemini ist einsatzbereit.

   

Mit Gemini Code Assist chatten

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

So beginnen Sie mit dem Chatten mit Gemini:

1. Öffnen Sie die Codedatei.

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

3. Geben Sie im Bereich Gemini Code Assist den Prompt Explain this code to me ein und klicken Sie auf send Senden.

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

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

Chatprotokoll zurücksetzen

Gemini Code Assist verwendet den Chatverlauf als zusätzlichen Kontext, um auf Ihre Prompts zu reagieren.

Wenn Ihr Chatverlauf nicht mehr für Ihr Vorhaben relevant ist, können Sie ihn zurücksetzen. Klicken Sie dazu im Bereich Gemini Code Assist auf delete Chat zurücksetzen.

Code mit Prompts generieren

In den folgenden Abschnitten erfahren Sie, wie Sie mit Gemini Code Assist Code mit dem Beispielprompt Function to create a Cloud Storage bucket in Ihrer Codedatei generieren. Sie können auch einen Teil Ihres Codes auswählen und dann über die Chatfunktion Gemini Code Assist um Hilfe bitten. Außerdem können Sie Codevorschläge erhalten und annehmen oder ablehnen, während Sie programmieren.

Gemini Code Assist in einer Codedatei auffordern

1. Geben Sie in Ihrer Codedatei in einer neuen Zeile den Kommentar Function to create a Cloud Storage bucket ein und drücken Sie dann die Eingabetaste (Windows und Linux) oder den Zeilenschalter (macOS).

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

   Neben dem Prompttext in Ihrer Codedatei generiert Gemini Code Assist den Code in Form von Ghosttext.

3. Optional: Drücken Sie die Tabulatortaste, um den generierten Code zu akzeptieren.

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 auf Ihrer Workstation auf das Dreistrich-Menü menu Menü und dann auf Datei > Einstellungen > Tastenkürzel.

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

3. Klicken Sie auf Cloud Code: Code generieren und dann auf edit Tastenkombination ändern.

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

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

   Sie können jetzt mit der neu zugewiesenen Tastenkombination Code mit Gemini generieren.

Gemini Code Assist über den Chat mit ausgewähltem Code auffordern

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

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

2. Wählen Sie in Ihrer Codedatei einen Codeblock aus.

3. Geben Sie im Textfeld Gemini Code Assist einen Prompt für den ausgewählten Code ein.

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

   

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

Inline-Vorschläge beim Programmieren erhalten

Während Sie Code schreiben, macht Gemini Code Assist Vorschläge für Inline-Code, die Sie entweder akzeptieren oder ignorieren können. So testen Sie diese Funktion:

1. Schreiben Sie in Ihrer Codedatei in einer neuen Zeile eine Funktion. Wenn Sie sich beispielsweise in einer Python-Datei befinden, geben Sie def ein.

   Gemini schlägt Code in Form von Ghosttext vor.

2. Drücken Sie die Tabulatortaste, um den Codevorschlag von Gemini Code Assist zu akzeptieren. Andernfalls können Sie den Vorschlag ignorieren, indem Sie Esc drücken oder mit dem Schreiben des Codes fortfahren.

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 menu Menü und dann Datei > Einstellungen > Einstellungen aus.

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

3. Scrollen Sie zu der Liste Cloudcode: Gemini Code Assist: Inline-Vorschläge: Auto aktivieren und wählen Sie Aus aus.

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

Optional: Dateien mit einer .aiexclude-Datei aus dem Kontext ausschließen

Sie können Dateien ausschließen, die von Gemini Code Assist für den Kontext berücksichtigt werden sollen, indem Sie eine .aiexclude-Datei erstellen. Die Syntax einer .aiexclude-Datei ähnelt der einer .gitignore-Datei, mit folgenden Unterschieden:

• Eine leere oder nicht vorhandene .aiexclude-Datei blockiert keine Dateien in ihrem Verzeichnis und in allen Unterverzeichnissen.
• Eine .aiexclude-Datei unterstützt keine Negation, bei der Muster mit einem Ausrufezeichen (!) vorangestellt werden.
• Eine .aiexclude-Datei stimmt gierig mit dem Zeichen * überein. Dabei werden Verzeichnisse und Dateien ohne Unterscheidung abgeglichen. In dieser .aiexclude-Datei wird bei Ordnern oder Dateien nicht zwischen ** und * unterschieden.

Derzeit wird nur eine einzelne .aiexclude-Datei unterstützt. Wenn Sie die .aiexclude-Datei konfigurieren möchten, erstellen Sie im Stammverzeichnis des Arbeitsbereichs eine Datei mit dem Namen .aiexclude. Wenn Sie diese Datei außerhalb des Stammverzeichnisses des Arbeitsbereichs platzieren oder umbenennen möchten, können Sie den Pfad in den VS Code-Einstellungen unter „Context Exclusion File“ festlegen. Der in dieser Einstellung angegebene Pfadwert wird relativ zum Stammordner des geöffneten Arbeitsbereichs aufgelöst.

Beispiele

Die folgenden Beispiele zeigen, wie Sie eine .aiexclude-Datei konfigurieren:

• Blockieren Sie alle Dateien mit dem Namen apikeys.txt im Arbeitsbereichsverzeichnis oder darunter:

  apikeys.txt
  

• So blockieren Sie alle Dateien mit der Dateiendung .key im Arbeitsbereichsverzeichnis oder darunter:

  *.key
  

• Blockieren Sie nur die Datei „apikeys.txt“ im selben Verzeichnis wie die Datei „.aiexclude“, aber keine Unterverzeichnisse:

  /apikeys.txt
  

• Blockieren Sie alle Dateien im Verzeichnis my/sensitive/dir und in allen Unterverzeichnissen. Der Pfad sollte sich auf das Stammverzeichnis des Arbeitsbereichs beziehen.

  my/sensitive/dir/*
  

Codevorschläge deaktivieren, die mit zitierten Quellen übereinstimmen

Gemini stellt Informationen zur Quellenangabe 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 vorgeschlagen wird, der mit den zitierten Quellen übereinstimmt, können Sie die Einstellung cloudcode.duetAI.recitation.maxCitedLength in einer settings.json-Datei in 0 ändern:

"cloudcode.duetAI.recitation.maxCitedLength": 0

Intelligente Aktionen verwenden

Gemini Code Assist bietet KI-gestützte intelligente Aktionen direkt in Ihrem Code-Editor, damit Sie produktiver arbeiten und den Kontextwechsel minimieren können. Wenn Sie den Code in Ihrem Code-Editor auswählen, können Sie eine Liste der für Ihren Kontext relevanten Aktionen aufrufen und eine davon auswählen.

So verwenden Sie intelligente Aktionen in Ihrem Code:

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

2. Klicken Sie neben dem ausgewählten Codeblock auf lightbulb Codeaktionen anzeigen.

   

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

   Gemini generiert eine Antwort, die auf der von Ihnen ausgewählten Aktion basiert.

Codetransformation verwenden

Gemini Code Assist bietet eine Codetransformation, mit der Sie einen Teil Ihrer Codedatei auswählen und über ein Inline-Textfeld Änderungen an Ihrem vorhandenen Code über Prompts in natürlicher Sprache anfordern können.

Mit der Codetransformation haben Sie folgende Möglichkeiten:

• Kommentarzeilen zum Dokumentieren Ihres Codes generieren
• Probleme mit Code beheben
• Lesbarkeit des Codes verbessern
• Code effizienter machen

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

Gemini Code Assist über das Inline-Textfeld auffordern

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

So öffnen Sie das Inline-Textfeld und geben einen Prompt für Gemini ein:

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

2. Geben Sie einen Prompt ein, z. B. Write a function to create a Cloud Storage bucket, und drücken Sie die Eingabetaste (Windows und Linux) oder die Return-Taste (macOS).

   Gemini Code Assist generiert den Code anhand Ihres Prompts.

Diff-Ansicht des refaktorierten Codes

In der Diff-Ansicht, die im Inline-Textfeld integriert ist, sehen Sie die von Gemini vorgeschlagenen Änderungen und Ihren ursprünglichen Code. Sie können die vorgeschlagenen Änderungen dann akzeptieren oder verwerfen.

So rufen Sie den Diff-Vergleich des überarbeiteten Codes aus dem Inline-Textfeld auf:

1. Wählen Sie in Ihrer Codedatei eine Funktion aus und öffnen Sie das Inline-Textfeld, indem Sie die Tastenkombination Strg + I (Windows und Linux) oder Befehlstaste + I (macOS) drücken.

2. Geben Sie einen Prompt ein, z. B. Add comments, und drücken Sie die Eingabetaste (Windows und Linux) oder die Return-Taste (macOS).

   Wenn Gemini die Codeänderungen an der ausgewählten Funktion generiert, wird die Diff-Ansicht angezeigt.

   

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

Kontextquellen einer generierten Antwort aufrufen

In der Kontextanzeige werden Ihre Projektdateien (die Kontextquellen) aufgeführt, die als Referenz verwendet wurden, um Antworten auf Ihre Prompts zu generieren. Wenn Sie wissen, welche Dateien als Referenz verwendet wurden, können Sie Ihre Prompts optimieren und genauere Antworten erhalten. Kontextquellen werden jedes Mal angezeigt, wenn Sie Gemini Chat verwenden.

Wenn Sie die Kontextquellen der generierten Antwort sehen möchten, scrollen Sie im Bereich Gemini: Chat nach unten, bis Sie das Snippet Kontextquellen sehen. Maximieren Sie das Snippet, um alle Kontextquellen zu sehen.

Smart Commands verwenden

Smart-Befehle sind Befehle, die Sie im Inline-Textfeld verwenden können, um bestimmte Aktionen auf Ihren Code anzuwenden.

So erhalten Sie mit dem intelligenten Befehl /explain eine Erklärung Ihrer gesamten Codedatei:

1. Öffnen Sie in Ihrer Codedatei das Inline-Textfeld, indem Sie Strg + I (Windows und Linux) oder Befehlstaste + I (macOS) drücken.

2. Drücken Sie die /-Taste, um eine Liste der Smart-Befehle und ihre 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 Google Chat ansehen.

Promptverlauf ansehen

Wenn Sie auf Ihren Prompt-Verlauf zugreifen, sparen Sie Zeit, wenn Sie denselben Prompt in eine große Codedatei eingeben müssen.

Wenn Sie auf den Prompt-Verlauf zugreifen möchten, öffnen Sie in Ihrer 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 Prompts durchgehen und bei Bedarf wiederverwenden.

Bessere Lesbarkeit des Codes für Nicht-Muttersprachler

Wenn du keine Muttersprachlerin oder Muttersprachler des Englischen bist und Übersetzungsprogramme verwendest, kannst du über das Inline-Textfeld Kommentare in anderen Sprachen verfassen.

So wandeln Sie englischsprachige Kommentare in eine andere Sprache um oder fügen neue Kommentare in einer anderen Sprache hinzu:

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

2. Drücken Sie Strg + I (Windows und Linux) oder Befehlstaste + I (macOS), um das Inline-Textfeld zu öffnen.

3. Geben Sie einen Prompt ein, z. B. Add spanish comments, und drücken Sie die Eingabetaste (Windows und Linux) oder die Return-Taste (macOS).

   Gemini generiert Kommentare in der Sprache, die du in deinem Prompt angegeben hast, und sieht sich die Unterschiede zwischen diesen Vorschlägen an.

4. Wenn Sie diese Änderungen an Ihrem Code akzeptieren oder verwerfen möchten, klicken Sie auf Akzeptieren oder Verwerfen.

Andere Beispiel-Prompts testen

Nachdem Sie den Abschnitt Code mit Prompts generieren in diesem Dokument gelesen haben, können Sie einige der folgenden Beispielprompts ausprobieren.

Codeerklärung abrufen

1. Wählen Sie in Ihrer Codedatei eine Funktion aus, die Sie erklärt haben möchten.

2. Geben Sie im Bereich Gemini Code Assist den Prompt Explain this code to me ein.

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

Testpläne erstellen

1. Wählen Sie in Ihrer Codedatei den Code aus, für den Sie Unit-Tests hinzufügen möchten.
2. Geben Sie im Bereich Gemini Code Assist den Prompt Write unit tests for my code ein.

Hilfe beim Debuggen von Code

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

Code lesbarer gestalten

1. Wählen Sie in Ihrer Codedatei den Code aus, den Sie lesbarer gestalten möchten.

2. Geben Sie im Bereich Gemini Code Assist den Prompt Make my code more readable ein.

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

Bekannte Probleme

In den folgenden Abschnitten werden die bekannten Probleme mit Gemini Code Assist beschrieben.

Warnungen zur Lizenzwiedergabe bleiben nicht sitzungsübergreifend erhalten

Wenn Warnungen zur Lizenzwiedergabe nicht über mehrere Sitzungen hinweg bestehen, sieh dir die persistenten Protokolle an:

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

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

Verbindungsprobleme im Ausgabefenster von Gemini Code Assist

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

• Konfigurieren Sie Ihre Firewall so, dass der Zugriff auf oauth2.googleapis.com und cloudaicompanion.googleapis.com zugelassen wird.

• 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. Bei einer erfolgreichen Prüfung wird die folgende Ausgabe angezeigt:

$ 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 zur folgenden Ausgabe:

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

Führen Sie vor grpc-health-probe den folgenden Befehl aus, um weitere Informationen 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 für die Verbindung erforderlich ist.

„Gemini Code Assist aktivieren“ wird nach der Auswahl eines Gemini Code Assist-Projekts weiterhin angezeigt

Wenn Sie Ihr Projekt gemäß der Anleitung in diesem Leitfaden ausgewählt haben, einschließlich der Aktivierung der Gemini for Google Cloud API, liegt möglicherweise ein Problem mit dem LS-Server vor.

So erhalten Sie weitere Informationen zu Ihrem Problem:

1. Klicken Sie in der Statusleiste auf spark Gemini Code Assist und wählen Sie Feedback senden aus.

2. Klicken Sie bei einer der Protokolldateien auf Anzeigen, um weitere Details zu sehen und das Problem zu beheben.

Feedback geben

So geben Sie Feedback zu Ihrer Erfahrung:

1. Klicken Sie in der Statusleiste auf Gemini Code Assist und wählen Sie dann im Menü Schnellauswahl die Option Feedback senden aus.

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

3. Wenn Sie Ihre Skaffold- oder AI Companion-Protokolle freigeben möchten, wählen Sie die Option Skaffold-Protokolle senden oder AI Companion-Protokolle senden aus.

4. Klicken Sie auf Feedback geben.

Nächste Schritte

• Weitere Informationen zum Erstellen besserer Prompts