Mit Gemini Code Assist programmieren

In diesem Dokument wird beschrieben, wie Sie Gemini Code Assist, ein KI-gestütztes Tool zur Zusammenarbeit in Google Cloud, verwenden können, um im Basiseditor von Cloud Workstations Folgendes zu tun:

• Anleitungen, die Ihnen bei der Lösung von Problemen mit Ihrem Code helfen.

• Generieren Sie Code für Ihr Projekt.

• Sie erhalten während der Programmierung Inline-Vorschläge.

Informationen dazu, wie und wann Gemini für Google Cloud Ihre Daten verwendet

Damit Sie die Lizenzanforderungen für Ihren Code erfüllen können, bietet Gemini Code Assist Quellenangaben an, wenn die Vorschläge direkt und ausführlich aus einer bestimmten Quelle zitieren. Weitere Informationen dazu, wie und wann Gemini Quellen zitiert, finden Sie unter So hilft Ihnen Gemini dabei, Code zu generieren und Quellen zu zitieren.

Dieses Dokument richtet sich an Entwickler aller Qualifikationsstufen. Dabei wird davon ausgegangen, dass Sie Arbeitskenntnisse zu Cloud Workstations und Google Cloud haben. Sie können sich auch Gemini Code Assist in Cloud Code for VS Code, Cloud Code for IntelliJ und Cloud Shell Editor ansehen.

Hinweise

1. Sie benötigen die IAM-Rolle „Cloud Workstations Admin“ für das Projekt, 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 Basiseditor (Code-OSS) aus.

   Wichtig:Wenn Sie Gemini Code Assist verwenden möchten, müssen Sie beim Erstellen der Workstationkonfiguration Basiseditor (Code-OSS) auswählen.
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.

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 auswählen, bei dem die Cloud AI Companion API nicht aktiviert ist, erhalten Sie eine Benachrichtigung mit der Option, 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.

Tipp:Sie können die Umgebungsvariable GEMINI_DEFAULT_PROJECT in der Workstationkonfiguration definieren, um das Cloud AI Companion API-Projekt automatisch auf allen Workstations festzulegen.

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.

   

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 (unter Windows und Linux) oder die Befehlstaste (macOS) und klicken Sie dann in der Console auf die URL.

5. Wenn Sie aufgefordert werden, Cloud Workstations das Öffnen der externen Website zu erlauben, klicken Sie auf Open (Öffnen).

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

   Wenn Sie gefragt werden, ob Sie diese App von Google heruntergeladen haben, klicken Sie auf Anmelden.

   Im Browser wird ein neuer Tab mit Ihrem Bestätigungscode für die Anmeldung in Cloud Code geöffnet.

7. Kopieren Sie den Bestätigungscode und fügen Sie ihn dort an der Stelle, an der Autorisierungscode eingeben steht, in Ihr Terminal ein. Drücken Sie dann die Eingabetaste (Windows und Linux) oder die Eingabetaste (für macOS).

   Sie sind jetzt mit Google Cloud verbunden.

Gehen Sie dann so vor, 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 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.

   

Mit Gemini Code Assist chatten

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, alle Ausgaben von Gemini zu validieren, bevor Sie sie verwenden. Weitere Informationen finden Sie unter Gemini für Google Cloud und verantwortungsbewusste Anwendung von KI.

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.

Gehen Sie so vor, um mit Gemini zu chatten:

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 Senden Senden.

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

   Wenn Sie auf einen bestimmten Codeblock anstatt auf den gesamten Code in der Datei verweisen 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 für zusätzlichen Kontext beim Antworten auf Ihre Prompts.

Wenn Ihr Chatverlauf für Ihre Ziele nicht mehr relevant ist, können Sie den Chatverlauf 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 beenden.

Code mit Prompts generieren

In den folgenden Abschnitten erfahren Sie, wie Sie Gemini Code Assist verwenden, um Code mit dem Beispiel-Prompt Function to create a Cloud Storage bucket in Ihrer Codedatei zu generieren. Sie können auch einen Teil Ihres Codes auswählen und Gemini Code Assist dann über die Chatfunktion um Hilfe bitten. Während des Codings können Sie Codevorschläge erhalten und annehmen oder ablehnen.

Gemini Code Assist in einer Codedatei auffordern

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

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

   Neben dem Prompt-Text in Ihrer Codedatei generiert Gemini Code Assist den Code in Form von Ghost-Text.

3. 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 mit folgenden Schritten ändern:

1. Klicken Sie auf 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 Bearbeiten Keybinding ändern.

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

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

   Du kannst jetzt die neu zugewiesene Tastenkombination verwenden, um Code mit Gemini zu generieren.

Gemini Code Assist mit ausgewähltem Code per Chat auffordern

Gemini Code Assist kann basierend auf dem von Ihnen ausgewählten Code Aufgaben ausführen oder Ihre Fragen beantworten. Gehen Sie so vor, um Code zu erhalten, der auf einer Eingabeaufforderung 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 des Bereichs 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 Ihren ausgewählten Code als Referenz und antwortet auf Ihren Prompt.

Beim Programmieren Inline-Vorschläge erhalten

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

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

   Gemini schlägt Code in Form von Geistertext vor.

2. Drücken Sie die Tabulatortaste, um den Codevorschlag von Gemini Code Assist zu übernehmen. Wenn Sie den Vorschlag ignorieren möchten, drücken Sie Esc oder fahren Sie mit der Eingabe 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 das Menü Menü aus und gehen Sie dann zu Datei > Einstellungen > Einstellungen.

2. Gehen Sie auf dem Tab Nutzer des Dialogfelds Einstellungen zu Erweiterungen > Cloud Code.

3. Scrollen Sie zur Liste Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto (Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto) (Automatisch aktivieren) und wählen Sie Off (Aus) aus.

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

Codevorschläge deaktivieren, die mit den zitierten Quellen übereinstimmen

Gemini liefert Zitationsinformationen, wenn es direkt mit der Länge aus einer anderen Quelle zitiert, z. B. vorhandenem Open-Source-Code. Weitere Informationen finden Sie unter Wie und wann Gemini Quellen zitiert.

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

"cloudcode.duetAI.recitation.maxCitedLength": 0

Intelligente Aktionen verwenden

Damit Sie produktiver arbeiten und gleichzeitig weniger Kontextwechsel vermeiden können, bietet Gemini Code Assist KI-gestützte intelligente Aktionen direkt in Ihrem Code-Editor. Wenn Sie den Code in Ihrem Code-Editor auswählen, können Sie eine 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 Ihrer Codedatei einen Codeblock aus.

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

   

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

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

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, mit denen Sie einen Teil Ihrer Codedatei auswählen und Änderungen an Ihrem vorhandenen Code über Prompts in natürlicher Sprache und mithilfe eines Inline-Textfelds anfordern können.

Mit Codetransformationen haben Sie folgende Möglichkeiten:

• Kommentarzeilen generieren, um den Code zu dokumentieren
• Code mit Problemen beheben
• Verbesserung der Lesbarkeit von Code
• Code effizienter gestalten

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

Gemini Code Assist über das Inline-Textfeld auffordern

Über das Inline-Textfeld kannst du direkt in deiner Codedatei mit Gemini Code Assist 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 (Mac).

2. Geben Sie einen Prompt 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 Ihrem Prompt.

Unterschied von refaktoriertem Code ansehen

Mit der Ansicht „Unterschiede“ im Inline-Textfeld siehst du die von Gemini vorgeschlagenen Änderungen und deinen ursprünglichen Code. Sie können die vorgeschlagenen Änderungen annehmen oder verwerfen.

Führen Sie die folgenden Schritte aus, um die Unterschiede des refaktorierten Codes über das Inline-Textfeld anzusehen:

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

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

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

   

3. Wenn Sie die Änderungen akzeptieren oder verwerfen möchten, klicken Sie auf Akzeptieren oder Verwerfen.

Kontextquellen einer generierten Antwort ansehen

Mit der Kontextanzeigefunktion werden die Projektdateien (die Kontextquellen) aufgelistet, 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 du Gemini Chat verwendest.

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

Intelligente Befehle verwenden

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

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

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

2. Drücken Sie /, um die Liste intelligenter Befehle und die zugehörigen 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

Durch den Zugriff auf den Prompt-Verlauf sparen Sie Zeit, wenn Sie dieselben Prompts in einer großen Codedatei eingeben müssen.

Öffnen Sie in Ihrer Codedatei das Inline-Textfeld, um auf den Prompt-Verlauf zuzugreifen. Dazu drücken Sie Strg + I (unter Windows und Linux) oder Befehlstaste + I (für macOS) und dann Strg + Aufwärtspfeil (für Windows und Linux) oder Befehlstaste + Aufwärtspfeil (für macOS). So können Sie Ihre älteren Prompts durchgehen und bei Bedarf wiederverwenden.

Verbesserung der Lesbarkeit von Code für Personen, die kein Englisch sprechen

Wenn Sie kein Englisch sprechen und Übersetzungsanwendungen benötigen, können Sie ü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 Code aus, dem Sie Kommentare hinzufügen möchten.

2. Öffnen Sie das Inline-Textfeld, indem Sie Strg + I (Windows und Linux) oder Befehlstaste + I (Mac) drücken.

3. Geben Sie einen Prompt 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 sieht sich den Unterschied dieser Vorschläge an.

4. Klicken Sie auf Akzeptieren oder Verwerfen, um die Änderungen an Ihrem Code zu akzeptieren oder zu verwerfen.

Weitere Beispiel-Prompts testen

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

Erläuterungen zu Code abrufen

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

2. Geben Sie im Bereich Gemini Code Assist den Prompt 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 generieren

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

Hilfe zum Debugging von Code

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

Code lesbarer machen

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

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 den bevorzugten Teil des Codes aus, bevor Sie Gemini auffordern.

Bekannte Probleme

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

Warnungen zu Lizenzänderungen werden nicht bei allen Sitzungen angezeigt

Wenn die Warnungen bei einer Lizenzaktualisierung nicht über mehrere Sitzungen hinweg bestehen bleiben, prüfen Sie die persistenten Logs:

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

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

Verbindungsprobleme im Ausgabefenster von Gemini Code Assist

Wenn Sie einen Verbindungsfehler oder andere Verbindungsprobleme im Ausgabefenster von Gemini Code Assist sehen, versuchen Sie Folgendes:

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

• Konfigurieren Sie die Firewall, um die Kommunikation über HTTP/2 zuzulassen, das von gRPC verwendet wird.

Mit dem grpc-health-probe-Tool können Sie die Verbindung testen. Eine erfolgreiche Prüfung führt zu folgendem Ergebnis:

$ 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 dem 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 kann Gemini Code Assist nicht in Cloud Workstations-IDEs ausgeführt werden, für die JetBrains Gateway zum Herstellen einer Verbindung 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 Schnellauswahl-Menü die Option Feedback geben aus.

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

3. Wenn Sie Ihre Skaffold- oder AI Companion-Logs teilen 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

• Weitere Informationen zum Schreiben besserer Prompts