Mit Gemini Code Assist programmieren

In diesem Dokument wird beschrieben, wie Sie Gemini Code Assist, einen KI-basierten Assistenten in Google Cloud, verwenden können, um Folgendes im Basis-Editor von Cloud Workstations zu tun:

  • Unterstützung bei der Behebung von Problemen mit Ihrem Code erhalten

  • Code für Ihr Projekt generieren

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

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

Damit Sie alle Lizenzanforderungen für Ihren Code einhalten können, stellt Gemini Code Assist Quellenangaben bereit, wenn Vorschläge längere Passagen direkt aus einer bestimmten Quelle zitieren. Weitere Informationen dazu, wie und wann Gemini Quellenangaben bereitstellt, finden Sie unter Wie Gemini Sie dabei unterstützt, Code zu generieren, und Quellen zitiert.

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

Dieses Dokument richtet sich an Entwickler aller Erfahrungsstufen. Dabei wird davon ausgegangen, dass Sie grundlegende Kenntnisse zu Cloud Workstations haben und mit Google Cloudvertraut sind. Sie können Gemini Code Assist auch in VS Code, IntelliJ und im 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, sehen Sie nach, 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 ein Projekt auswählen

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

Wenn Sie ein Projekt in Google Cloud ohne aktivierte Gemini for Google Cloud API auswählen, erhalten Sie eine Benachrichtigung, in der Sie die API über die IDE aktivieren können. 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 Aktivitätsleiste Ihrer Workstation auf spark Gemini Code Assist.

  3. Folgen Sie der Anleitung, um sich bei Gemini Code Assist anzumelden, falls Sie noch nicht angemeldet sind.

  4. Wenn Sie aufgefordert werden, Cloud Workstations das Öffnen der externen Website zu erlauben, klicken Sie auf Öffnen.

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

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

    Sie sind jetzt mit Google Cloudverbunden. 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 Ihren Code erklären zu lassen.

So starten Sie eine Unterhaltung mit Gemini:

  1. Öffnen Sie eine Quelldatei.

  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 Ihre Datei als Kontext für Ihren Prompt und antwortet mit einer Erklärung Ihres Codes.

    Wenn Sie sich auf einen bestimmten Codeblock konzentrieren möchten, wählen Sie diesen Block in Ihrer geöffneten Datei aus, bevor Sie Ihren Prompt eingeben.

Chatprotokoll zurücksetzen

Gemini Code Assist verwendet das Chatprotokoll als zusätzlichen Kontext bei der Beantwortung Ihrer Prompts.

Wenn Ihr Chatprotokoll für das, was Sie erreichen möchten, nicht mehr relevant ist, können Sie es zurücksetzen: Klicken Sie 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 einer Datei 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, werden Codevorschläge angezeigt, die Sie annehmen oder ablehnen können.

Gemini Code Assist in einer Datei prompten

  1. Geben Sie in einer Quellcodedatei 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 die Return-Taste (für macOS).

  2. Um Code zu generieren, drücken Sie Strg + Eingabe (für Windows und Linux) oder Control + Eingabe (für macOS).

    Gemini Code Assist generiert den Code neben Ihrem Prompttext in der Datei in Form von Ghosttext.

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

Optional: Tastenkombination zum Generieren von Code ändern

Wenn die Standardtastenkombination zum Generieren von Code nicht wie im vorherigen Abschnitt beschrieben funktioniert, können Sie die Tastenkombination ändern. Gehen Sie dazu so vor:

  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 erstellen und dann auf edit Tastenkombination ändern.

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

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

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

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

Gemini Code Assist kann auf Grundlage von ausgewähltem Code Aufgaben ausführen oder Fragen 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 Chatbereich Gemini Code Assist zu öffnen.

  2. Wählen Sie in einer Quelldatei einen Codeblock aus.

  3. Geben Sie im Textfeld des Gemini Code Assist-Chats 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 annehmen oder ignorieren können. So probieren Sie diese Funktion aus:

  1. Beginnen Sie in einer Quelldatei in einer neuen Zeile mit dem Schreiben einer Funktion. Wenn Sie sich in einer Python-Datei befinden, schreiben Sie beispielsweise def. Gemini schlägt Code in Form von Ghosttext 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 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, bis die Liste Cloudcode: Gemini Code Assist: Inline-Vorschläge: Auto aktivieren angezeigt wird, und wählen Sie dann Aus aus.

    Dadurch werden die Inline-Vorschläge deaktiviert. Sie können weiterhin mit Strg + Eingabe (für Windows und Linux) oder Control + Eingabe (für macOS) Inline-Vorschläge auslösen.

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

Sie können Dateien davon ausschließen, dass sie von Gemini Code Assist für den Kontext berücksichtigt werden, indem Sie eine .aiexclude-Datei erstellen. Für eine .aiexclude-Datei gilt die gleiche 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 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. Es wird unterschiedslos auf Verzeichnisse und Dateien abgestimmt. 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:

  • Alle Dateien mit dem Namen apikeys.txt im Arbeitsbereichsverzeichnis oder einem Unterverzeichnis blockieren:

    apikeys.txt

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

    *.key

  • Nur die Datei „apikeys.txt“ im selben Verzeichnis wie die Datei .aiexclude blockieren, nicht in Unterverzeichnissen:

    /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, die mit zitierten Quellen übereinstimmen, deaktivieren

Gemini liefert Zitierinformationen, wenn es längere Zitate direkt aus einer anderen Quelle übernimmt, wie beispielsweise aus öffentlich verfügbarem Quellcode. Weitere Informationen finden Sie unter Wie und wann zitiert Gemini Quellen?.

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

"geminicodeassist.recitation.maxCitedLength": 0

Intelligente Aktionen verwenden

Damit Sie produktiver arbeiten können und weniger Kontextwechsel erforderlich sind, bietet Gemini Code Assist KI-basierte intelligente Aktionen direkt in Ihrem Quellcode-Editor. Wenn Sie Code in Ihrem 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:

  1. Wählen Sie in einer Quelldatei einen Codeblock aus.

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

    Das Glühbirnensymbol für intelligente Aktionen wird angezeigt, nachdem Sie einen Codeblock in Shell und Workstations ausgewählt haben.

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

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

Codetransformation verwenden

Gemini Code Assist bietet die Codetransformation. Damit können Sie einen Teil des Codes in einer Datei 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 die Kontextquellen einer generierten Antwort auch im Bereich Gemini: Chat ansehen.

Gemini Code Assist über das Inline-Textfeld prompten

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

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

  1. Drücken Sie in einer Quelldatei Strg+I (für Windows und Linux) oder Befehlstaste+I (für macOS).

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

    Gemini Code Assist generiert den Code basierend auf Ihrem Prompt.

Unterschiede des refaktorierten Codes ansehen

In der Ansicht der Unterschiede, die 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 annehmen oder verwerfen.

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

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

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

    Wenn Gemini die Codeänderungen für die ausgewählte Funktion generiert, wird die Vergleichsansicht angezeigt.

    Kontextquellen, die im Bereich „Gemini: Chat“ aufgeführt sind.

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

Kontextquellen einer generierten Antwort ansehen

In der 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 ansehen möchten, scrollen Sie im Bereich Gemini: Chat, bis Sie das Snippet Kontextquellen sehen. Maximieren Sie den Ausschnitt, um alle Kontextquellen zu sehen.

Kontextquellen, die im Bereich „Gemini: Chat“ aufgeführt sind.

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 für eine gesamte Quelldatei mit dem Smart-Befehl /explain:

  1. Öffnen Sie in einer Datei 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 Datei im Inline-Textfeld.

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

Promptverlauf ansehen

Wenn Sie auf Ihren Prompthistorie zugreifen, sparen Sie Zeit, wenn Sie Prompts in einer großen Quelldatei wiederverwenden möchten.

Wenn Sie auf Ihren Promptverlauf zugreifen möchten, öffnen Sie in Ihrer Datei 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 einer Quelldatei den Code aus, dem Sie Kommentare hinzufügen möchten.

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

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

    Gemini generiert Kommentare in der Sprache, die Sie in Ihrem Prompt angegeben haben, und zeigt die Änderungen an.

  4. Klicken Sie auf Akzeptieren oder Verwerfen, um diese Ä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 einer Quelldatei 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 den ausgewählten Code als Referenz und antwortet mit einer Erklärung der ausgewählten Funktion.

Testpläne erstellen

  1. Wählen Sie in einer Quelldatei 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 einer Quelldatei 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 einer Quelldatei den Code aus, den Sie besser lesbar 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 entsprechenden Code aus, bevor Sie Gemini prompten.

Bekannte Probleme

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

Warnungen zu Lizenzen und Zitaten werden nicht sitzungsübergreifend beibehalten

Wenn die Warnungen zu Lizenzen und Zitaten nicht über Sitzungen hinweg bestehen bleiben, sehen Sie sich die persistenten Logs 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, führen Sie Folgendes aus:

  • 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 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 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 und die Gemini for Google Cloud API aktiviert haben, 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 senden 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 Ihren Erfahrungen:

  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-Logs teilen möchten, wählen Sie die Option Skaffold-Logs senden oder AI Companion-Logs senden aus.

  4. Klicken Sie auf Feedback senden.

Weitere Informationen