Mit Gemini Code Assist programmieren

• Anleitung zur Behebung von Problemen mit Ihrem Code.

• Code für Ihr Projekt generieren

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

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

Mit der Codeanpassung können Sie direkt in Gemini Code Assist Codevorschläge auf Grundlage der privaten Codebasis Ihrer Organisation erhalten. Informationen zum Konfigurieren der Codeanpassung

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

Hinweise

1. Sie benötigen die Cloud Workstations-Administratorrolle für das Projekt, damit Sie Workstation-Konfigurationen erstellen können.

   IAM aufrufen

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

3. Bevor Sie die Funktionen von Gemini Code Assist in Ihrer Codedatei testen, müssen Sie prüfen, 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 einGoogle Cloud -Projekt aus, in dem die Gemini for Google Cloud API auf Ihrer Workstation aktiviert ist.

Wenn Sie ein Google Cloud -Projekt ohne aktivierte Gemini for Google Cloud API auswählen, 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.

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

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

   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 das Öffnen der externen Website zu erlauben, 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.

   In Ihrem 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 in das Terminal unter Autorisierungscode eingeben ein. Drücken Sie dann die Eingabetaste (für Windows und Linux) oder die Rückgabetaste (für macOS).

   Sie sind jetzt mit Google Cloudverbunden.

So wählen Sie ein Google Cloud -Projekt aus, für das die Gemini for Google Cloud 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-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 für Ihren vorhandenen Code zu erhalten.

So starten Sie eine Unterhaltung mit Gemini:

1. Öffnen Sie Ihre 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 für Ihren Prompt und antwortet mit einer Erklärung Ihres Codes.

   Wenn Sie sich auf einen bestimmten Codeblock anstelle des gesamten Codes 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, um zusätzlichen Kontext für die Beantwortung Ihrer Prompts zu erhalten.

Wenn Ihr Chatverlauf für Ihre aktuelle Aufgabe nicht mehr 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 Gemini Code Assist dann über die Chatfunktion um Hilfe bitten. Während Sie programmieren, können Sie Codevorschläge erhalten und annehmen oder ablehnen.

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 (für Windows und Linux) oder den Zeilenumbruch (für macOS).

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

   Gemini Code Assist generiert den Code in Form von Ghost-Text neben Ihrem Prompt-Text in Ihrer Codedatei.

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

Optional: Tastenkombination zum Generieren von Code ändern

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

1. Klicken Sie auf Ihrer Workstation auf das 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 (unter Windows und Linux) oder die Returntaste (unter macOS).

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

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

Gemini Code Assist kann Aufgaben ausführen oder Ihre Fragen auf Grundlage des von Ihnen ausgewählten Codes beantworten. 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 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 den 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. So probieren Sie diese Funktion aus:

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 Ghost-Text vor.

2. Drücken Sie die Tabulatortaste, um den Codevorschlag von Gemini Code Assist zu akzeptieren. Wenn Sie den Vorschlag ignorieren möchten, drücken Sie Esc oder fahren Sie mit dem Schreiben Ihres 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ü menu aus und rufen Sie dann Datei > Einstellungen > Einstellungen auf.

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

3. Scrollen Sie, bis Sie die Liste Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto (Cloudcode: Gemini Code Assist: Inline-Vorschläge: Automatisch aktivieren) finden, und wählen Sie dann Off (Aus) aus.

   Dadurch werden die Inlinevorschläge deaktiviert. Sie können weiterhin 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 als Kontext berücksichtigt werden sollen, indem Sie eine .aiexclude-Datei erstellen. Für eine .aiexclude-Datei gilt eine ähnliche Syntax wie für eine .gitignore-Datei, mit den folgenden Unterschieden:

• Eine leere oder nicht vorhandene .aiexclude-Datei blockiert keine Dateien im zugehörigen Verzeichnis und in allen Unterverzeichnissen.
• Eine .aiexclude-Datei unterstützt keine Negation, bei der Sie Mustern ein Ausrufezeichen (!) voranstellen.
• Eine .aiexclude-Datei stimmt gierig mit dem Zeichen * überein. Dies gilt für alle Verzeichnisse und Dateien. In dieser .aiexclude-Datei wird nicht zwischen ** oder * in Bezug auf Ordner oder Dateien unterschieden.

Derzeit wird nur eine .aiexclude-Datei unterstützt. Erstellen Sie zum Konfigurieren der Datei .aiexclude eine Datei mit dem Titel .aiexclude im Stammverzeichnis des Arbeitsbereichordners. Wenn Sie diese Datei außerhalb des Arbeitsbereichs-Stammverzeichnisses platzieren oder die Datei umbenennen möchten, kann der Pfad in den VS Code-Einstellungen unter „Context Exclusion File“ festgelegt werden. Der in dieser Einstellung angegebene Pfadwert wird relativ zum Stammordner Ihres geöffneten Arbeitsbereichs aufgelöst.

Beispiele

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

• Alle Dateien mit dem Namen apikeys.txt im Arbeitsbereichverzeichnis oder darunter blockieren:

  apikeys.txt
  

• Alle Dateien mit der Dateiendung .key im Arbeitsbereichsverzeichnis oder darunter blockieren:

  *.key
  

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

  /apikeys.txt
  

• Alle Dateien im Verzeichnis my/sensitive/dir und allen Unterverzeichnissen blockieren. Der Pfad sollte relativ zum Arbeitsbereich-Stammverzeichnis sein.

  my/sensitive/dir/*
  

Codevorschläge deaktivieren, die mit zitierten Quellen übereinstimmen

Gemini gibt Zitationsinformationen an, wenn direkt in größerem Umfang aus einer anderen Quelle zitiert wird, z. B. aus vorhandenem Open-Source-Code. Weitere Informationen finden Sie unter Wie und wann zitiert Gemini Quellen?.

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

"geminicodeassist.recitation.maxCitedLength": 0

Smarte Aktionen verwenden

Damit Sie produktiver arbeiten können und weniger Kontextwechsel erforderlich sind, bietet Gemini Code Assist KI-gestützte Smart Actions direkt in Ihrem Code-Editor. Wenn Sie Ihren Code im Code-Editor auswählen, können Sie eine Liste von Aktionen aufrufen und auswählen, die für Ihren Kontext relevant sind.

So verwenden Sie Smart Actions in Ihrem Code:

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

2. Klicken Sie neben dem ausgewählten Codeblock auf lightbulb Code-Aktionen anzeigen.

   

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

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

Codetransformation verwenden

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

Mit der Code-Transformation haben Sie folgende Möglichkeiten:

• Kommentarzeilen zum Dokumentieren Ihres Codes generieren
• Probleme mit Code beheben
• Code besser lesbar machen
• Code effizienter gestalten

Sie können auch die Kontextquellen einer generierten Antwort 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 (unter Windows und Linux) oder die Return-Taste (unter macOS).

   Gemini Code Assist generiert den Code basierend auf Ihrem Prompt.

Unterschiede des refaktorierten Codes ansehen

In der in das Inline-Textfeld integrierten Differenzansicht können Sie die von Gemini vorgeschlagenen Änderungen und Ihren ursprünglichen Code sehen. Sie können die vorgeschlagenen Änderungen dann annehmen oder verwerfen.

So rufen Sie den Unterschied zwischen dem refaktorierten Code und dem ursprünglichen Code im Inline-Textfeld auf:

1. Wählen Sie in Ihrer 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 ein, z. B. Add comments, und drücken Sie die Eingabetaste (unter Windows und Linux) oder die Return-Taste (unter macOS).

   Wenn Gemini die Codeänderungen für die ausgewählte 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 ansehen

In der Funktion zur Kontextanzeige werden Ihre Projektdateien (die Kontextquellen) aufgeführt, 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.

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

Smart Commands verwenden

Smarte Befehle sind Befehle, die Sie im Inline-Textfeld verwenden können, um bestimmte Aktionen für Ihren Code auszuführen.

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

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

2. Drücken Sie /, um die 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 Im Chat ansehen.

Promptverlauf ansehen

Wenn Sie auf Ihren Prompthistorie zugreifen, sparen Sie Zeit, wenn Sie denselben Prompt oder dieselben Prompts in eine große Codedatei eingeben müssen.

Wenn Sie auf Ihren Aufforderungsverlauf zugreifen möchten, öffnen Sie in Ihrer Codedatei das Inline-Textfeld, indem Sie Strg+I (für Windows und Linux) oder Befehlstaste+I (für macOS) drücken. Drücken Sie 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.

Code für Personen besser lesbar machen, deren Muttersprache nicht Englisch ist

Wenn Englisch nicht Ihre Muttersprache ist und Sie auf Übersetzungsanwendungen angewiesen sind, können Sie mit dem Inline-Textfeld auch Kommentare in anderen Sprachen generieren.

So wandeln Sie englische 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. Öffnen Sie das Inline-Textfeld, indem Sie Strg+I (Windows und Linux) oder Befehlstaste+I (macOS) drücken.

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 Sie in Ihrem Prompt angegeben haben, und zeigt die Unterschiede zwischen den Vorschlägen an.

4. Klicken Sie auf Akzeptieren oder Verwerfen, um die Änderungen an Ihrem Code zu übernehmen oder zu 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.

Code erläutern lassen

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 erhalten

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 machen

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

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

   Wenn Sie sich lieber auf einen bestimmten Teil Ihres Codes konzentrieren möchten, wählen Sie den gewünschten Teil des Codes aus, bevor Sie Gemini auffordern.

Bekannte Probleme

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

Warnungen zur Lizenzrezitation bleiben nicht sitzungsübergreifend erhalten

Wenn die Warnungen zur Lizenzrezitation nicht über Sitzungen hinweg bestehen bleiben, sehen Sie sich die persistenten Protokolle an:

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

2. Wählen Sie Gemini Code Assist – Quellenangaben 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, das von gRPC verwendet wird, zugelassen wird.

Sie können das grpc-health-probe-Tool verwenden, um die Verbindung zu 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 nicht erfolgreiche 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 den 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 eine Verbindung über JetBrains Gateway erforderlich ist.

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

Wenn Sie Ihr Projekt gemäß der Anleitung in diesem Leitfaden ausgewählt haben, was auch die Aktivierung der Gemini for Google Cloud API umfasst, 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 dann Feedback geben aus.

2. Klicken Sie für eine der Logdateien 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ü Quick Pick 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-Logs teilen möchten, müssen Sie die Option Skaffold-Logs senden oder AI Companion-Logs senden auswählen.

4. Klicken Sie auf Feedback senden.

Nächste Schritte

• Weitere Informationen zum Schreiben besserer Prompts