Mit Gemini Code Assist programmieren

In diesem Dokument wird beschrieben, wie Sie mit Gemini Code Assist, einer KI-basierten Unterstützung in Google Cloud, Folgendes in Cloud Code tun können:

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

• Generieren Sie Code für Ihr Projekt.

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

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

Um Ihnen zu helfen, alle Lizenzanforderungen für Ihren Code erfüllen, Gemini Code Assist gibt Quellenzitationen aus, wenn seine Vorschläge aus einer bestimmten Quelle zitieren. Um mehr darüber zu erfahren, wie und Wenn Gemini Quellen zitiert, siehe So hilft Ihnen Gemini beim Generieren von Code und Zitieren von Quellen

Codeanpassung Hiermit können Sie Codevorschläge erhalten, die auf der privaten Codebasis Ihrer Organisation basieren direkt von Gemini Code Assist aus. Weitere Informationen Codeanpassung konfigurieren

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

Hinweise

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

2. Installieren Sie die Gemini Code Assist und Cloud Code-Erweiterung falls noch nicht geschehen. Cloud Code ist in Ihrer IDE mit Gemini Code Assist integriert.

3. Wenn Sie Ihre IDE lieber über einen Proxy verwenden möchten, lesen Sie den Hilfeartikel Netzwerkverbindungen in Visual Studio Code.

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 aus, in dem die Gemini for Google Cloud API in Ihrer IDE aktiviert ist.

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 Siehe Gemini Code Assist für ein Projekt einrichten.

Wenn Sie dem Code mit Gemini Code Assist folgen möchten direkt in Ihrer IDE an, klicken Sie auf Launch VS Code und folgen Sie der Anleitung in der Schritt-für-Schritt-Anleitung zum Herstellen einer Verbindung zu Google Cloud und zum Aktivieren Gemini Code Assist

VS Code starten

Andernfalls gehen Sie so vor:

1. Starten Sie Ihre IDE.

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

   

3. Wenn Sie aufgefordert werden, Cloud Code das Öffnen der externen Website zu gestatten, klicken Sie auf Öffnen.

4. Folgen Sie der Anleitung, um sich in Ihrem Google-Konto anzumelden.

5. Wenn Sie gefragt werden, ob Sie Cloud Code von Google heruntergeladen haben, klicken Sie auf Sign In (Anmelden).

   Hinweis: Wenn bei Ihren Anmeldeversuchen immer wieder ein Zeitlimit erreicht wird, finden Sie unter Bei Anmeldeversuchen immer wieder ein Zeitlimit erreicht wird weitere Informationen zur Fehlerbehebung.

   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ähle im Gemini Code Assist-Menü die Option Gemini-Code auswählen Projekt.

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

Da es sich bei Gemini für Google Cloud-Produkte 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 für Google Cloud-Produkte 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.

So beginnen Sie mit dem Chatten mit Gemini:

1. Öffnen Sie die Codedatei.

2. Klicken Sie in der Aktivitätsleiste der IDE 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.

   Um auf einen bestimmten Codeblock anstatt auf den gesamten Code in der Datei zu verweisen, können Sie den Block in Ihrer Codedatei auswählen und 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 Anliegen relevant ist, können Sie ihn zurücksetzen. Klicken Sie dazu im Bereich Gemini Code Assist auf delete Chat zurücksetzen.

Hinweis: Der Chatverlauf wird automatisch zurückgesetzt, wenn Sie den Arbeitsbereich wechseln oder die IDE schließen.

Code mit Prompts generieren

In den folgenden Abschnitten erfahren Sie, wie Sie mit Gemini Code Assist Codetransformationen wie function to create a Cloud Storage bucket über die Schnellauswahl-Leiste ausführen

Mit der Codetransformation können Sie über die Schnellauswahlleiste Befehle oder Prompts in natürlicher Sprache verwenden, um Änderungen an Ihrem Code anzufordern. Außerdem wird eine Differenzansicht angezeigt, in der ausstehende Änderungen an Ihrem Code zu sehen sind.

Sie können auch einen Teil Ihres Codes auswählen und dann Gemini Code Assist unterstützt Sie über Gemini Code Assist. und Codevorschläge erhalten und annehmen oder ablehnen, während Sie programmieren.

Gemini Code Assist mit Codetransformation auffordern

1. Drücken Sie in Ihrer Codedatei in einer neuen Zeile Strg + I (Windows und Linux) oder Befehlstaste + I (macOS), um die Leiste Gemini Code Assist Quick Pick zu öffnen.

2. Geben Sie im Menü mit dem Befehl /generate /generate function to create a Cloud Storage bucket ein und drücken Sie dann die Eingabetaste (Windows und Linux) oder auf die Eingabetaste (für macOS).

   

   Gemini Code Assist generiert den Code basierend auf Ihrem Prompt in einem Ansicht „Unterschiede“.

   

3. Optional: Klicken Sie auf Akzeptieren, um die Änderungen zu übernehmen.

Optional: Gemini Code Assist in einer Codedatei mit einem Kommentar auffordern

Sie können Gemini Code Assist auch mit einem Kommentar in Ihrer Codedatei auffordern. Gehen Sie dazu so vor:

1. Geben Sie 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 die Eingabetaste. (für 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 in Ihrer IDE auf Datei (Windows und Linux) oder Code (macOS) und gehen Sie dann zu Einstellungen > Tastenkombinationen.

2. Scrollen Sie in der Liste der Tastenkombinationen zu 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 die neu zugewiesene Tastenkombination verwenden, um Code mit Gemini Code Assist

Weitere Informationen zum Ändern von Tastenkürzeln in Ihrer IDE finden Sie unter Tastenkürzel für Visual Studio Code.

Gemini Code Assist mit ausgewähltem Code per Chat 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 in das Textfeld im Bereich Gemini Code Assist einen Prompt für den ausgewählten Code.

   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 auf Ihren Prompt.

Inline-Vorschläge beim Programmieren erhalten

Beim Schreiben von Code erstellt Gemini Code Assist Inline-Code die Sie annehmen oder ignorieren können. So testen Sie diese Funktion:

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

   Gemini schlägt Code in Form von Geistertext vor.

2. Um den Codevorschlag von Gemini Code Assist anzunehmen, drücken Sie Tab: 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, führen Sie folgende Schritte aus:

1. Wählen Sie in Ihrer IDE Code (für macOS) oder Datei (für Windows und Linux) und dann Einstellungen > Einstellungen aus.

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

3. Scrollen Sie zu Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Automatisch und wählen Sie dann 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.

Schnellkorrektur für Codetransformation verwenden

Wenn Ihr Code einen Fehler enthält, können Sie mit Gemini Code Assist eine Schnellkorrektur mit Codetransformation vornehmen.

So wenden Sie eine Schnellkorrektur auf Ihre Codedatei an:

1. Halten Sie in Ihrer Codedatei den Zeiger über die verschnörkelte Fehlerzeile und wählen Sie Quick Fix (Schnellkorrektur) und wählen Sie dann /fix aus.

   

2. Wenn die Schnellkorrektur angewendet wird, wird eine Differenzansicht angezeigt. Klicken Sie auf Akzeptieren, um die Änderungen zu übernehmen.

Aufforderung zur Eingabe bestimmter Dateien in Ihrem Arbeitsbereich mit Informationen zur lokalen Codebasis

Wenn Sie Dateien angeben, die Gemini Code Assist als Kontext verwenden soll, erhalten Sie hochwertige Codevorschläge, die syntaktisch korrekt und semantisch sinnvoll im weiteren Kontext Ihrer Codebasis sind.

Wenn Sie Dateien in Ihrem Chatvorschlag angeben möchten, geben Sie @ ein und wählen Sie die gewünschten Dateien aus.

Um eine Erklärung zu den Unterschieden von zwei Dateien in Ihrer Codebasis zu erhalten, folgen Sie diese Schritte:

1. Klicke in der Aktivitätsleiste auf spark Gemini Code Assist

2. Geben Sie im Bereich Gemini Code Assist den Prompt Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 ein und drücken Sie die Eingabetaste (Windows und Linux), die Return-Taste (macOS) oder die Tabulatortaste. Sie können auch auf den Namen der Datei in der Liste klicken, um sie auszuwählen. Wenn Sie auf das file name fügt die Datei zum Prompt-Kontext hinzu und öffnet sie in Ihrer IDE.

   Gemini Code Assist reagiert auf Ihren Prompt, während er die beiden Dateien, die Sie für den Kontext angegeben haben. Gemini Code Assist enthält auch die Dateien, die Sie unter Kontextquellen angegeben haben.

Nachdem Sie diese Dateien angegeben haben, können Sie im selben Chatverlauf weitere Fragen oder Prompts stellen, ohne die Dateien noch einmal angeben zu müssen.

Beispiel: Geben Sie im Bereich Gemini Code Assist die Aufforderung How can I improve YOUR_FILE_NAME_1? (ohne das Symbol @) ein und drücken Sie die Eingabetaste (Windows und Linux) oder die Return-Taste (macOS).

Gemini Code Assist antwortet auf Ihre Anfrage zur Datei, die Sie in Ihrem Prompt angegeben haben.

Hinweis: Wenn Sie Ihren Chatverlauf löschen, wird Gemini Code Assist nicht Ihre Dateien werden länger für den Kontext verwendet und Sie müssen die Dateien im Chat neu angeben Bereich mit dem @-Symbol, wenn Sie weitere Fragen zum Dateien.

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

Sie können Dateien ausschließen, damit sie von Gemini Code Assist berücksichtigt werden um Kontext zu erhalten, indem Sie eine .aiexclude-Datei erstellen. Eine .aiexclude-Datei folgt der ähnliche Syntax wie eine .gitignore-Datei. Es gibt jedoch folgende Unterschiede:

• 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 Sie Mustern Ausrufezeichen (!)
• Eine .aiexclude-Datei sucht gierig nach dem Zeichen *. Dabei werden Verzeichnisse und Dateien ohne Unterscheidung abgeglichen. Diese .aiexclude-Datei enthält bei Ordnern oder Dateien zwischen ** und * unterscheiden.

Derzeit wird nur eine einzelne .aiexclude-Datei unterstützt. So konfigurieren Sie Ihr .aiexclude-Datei, erstellen Sie eine Datei mit dem Namen .aiexclude im Stammverzeichnis Ihres Arbeitsbereich-Ordner. Wenn Sie diese Datei außerhalb des Stammverzeichnisses des Arbeitsbereichs ablegen möchten, oder die Datei umbenennen, können Sie den Pfad in den VS Code-Einstellungen unter Kontextausschluss-Datei. 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 oder unterhalb des Arbeitsbereichsverzeichnisses:

  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
  

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

  my/sensitive/dir/*
  

Codevorschläge deaktivieren, die mit zitierten Quellen übereinstimmen

Gemini liefert Zitationsinformationen, wenn es direkt zitiert wird. Länge aus einer anderen Quelle, z. B. aus bestehendem 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 auf 0 settings.json-Datei:

"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 im Code-Editor auswählen, und wähle aus einer Liste von Aktionen aus, die für deinen 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 lightbulb Codeaktionen anzeigen.

   

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

   Gemini generiert eine Antwort, die auf der von dir ausgewählt.

Andere Beispiel-Prompts testen

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

Erläuterungen zu Code 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 machen

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.

Chatantworten werden möglicherweise abgeschnitten, wenn sie eine aktualisierte Version einer großen offenen Datei enthalten.

Wählen Sie zur Umgehung dieses Problems einen kleineren Code-Abschnitt aus und fügen Sie ein zusätzliche Anweisung in der Chat-Eingabeaufforderung, z. B. only output the selected code.

Vim: Vorschläge zur Codegenerierung können nur im Einfügemodus akzeptiert oder abgelehnt werden

Wenn Sie das Vim-Plug-in im Normalmodus verwenden, können Sie Codevorschläge nicht akzeptieren oder ablehnen.

Um dieses Problem zu umgehen, drücken Sie die Taste i, um in den Einfügemodus zu wechseln, und dann die Tabulatortaste, um den Vorschlag zu akzeptieren.

Vim: Uneinheitliches Verhalten beim Drücken der Esc zum Ablehnen von Vorschlägen

Wenn Sie die Esc drücken, werden sowohl die IDE als auch Gemini werden abgelehnt. Dieses Verhalten unterscheidet sich von dem Verhalten ohne Vim. Dabei wird Gemini durch Drücken der Esc noch einmal ausgelöst.

Bei Anmeldeversuchen kommt es immer wieder zu einer Zeitüberschreitung

Wenn es bei Ihren Anmeldeversuchen weiterhin zu einer Zeitüberschreitung kommt, fügen Sie den Parameter cloudcode.beta.forceOobLogin-Einstellung für Ihre settings.json-Datei:

"cloudcode.beta.forceOobLogin": true

Warnungen zur Lizenzwiedergabe bleiben nicht sitzungsübergreifend erhalten

Wenn die Warnungen bei einer Lizenzänderung nicht über mehrere Sitzungen hinweg bestehen, siehe persistente Logs:

1. Klicken Sie auf 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 in der Gemini Code Assist-Ausgabefenster 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.

Mit dem grpc-health-probe-Tool können Sie die Verbindung 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 aktivieren“ wird immer noch angezeigt, nachdem Sie das Gemini Code Assist-Projekt ausgewählt haben

Wenn Sie gemäß der Anleitung in diesem Projekt Ihr Projekt ausgewählt haben, unter anderem zur Aktivierung der Gemini für die Google Cloud API, werden möglicherweise Es gibt ein Problem mit dem LS-Server.

Führen Sie die folgenden Schritte aus, um weitere Informationen zu Ihrem Problem zu erhalten:

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 uns Feedback:

1. Klicken Sie in der Statusleiste auf Gemini Code Assist und dann in der Quick Auswählen 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 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 Schreiben besserer Prompts