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 Shell tun können:

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

  • 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

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. Weitere Informationen dazu, wie und wann Gemini Quellen zitiert, finden Sie unter So unterstützt Sie Gemini beim Generieren von Code und beim Zitieren von Quellen.

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

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 in den Cloud Shell-Editor.

Wenn Sie ein Google Cloud-Projekt ohne das Gemini für die Google Cloud API aktiviert haben, erhalten Sie eine Benachrichtigung, die Option zum Aktivieren der API über die IDE. Wählen Sie im Menü API aktivieren um die API für Ihr Projekt zu aktivieren. Weitere Informationen Siehe Gemini Code Assist für ein Projekt einrichten.

So stellen Sie eine Verbindung zu Google Cloud her: den Cloud Shell-Editor führen Sie folgende Schritte aus:

  1. Cloud Shell-Editor starten

  2. Wenn Sie den alten Editor verwenden, klicken Sie auf Neuen Editor testen.

  3. Klicken Sie in der Statusleiste auf Cloud Code – Sign In (Cloud Code – Anmeldung).

    Schaltfläche „Cloud Code – Anmelden“ in der Statusleiste

  4. Wenn Sie aufgefordert werden, den Cloud Shell-Editor zu autorisieren, API-Aufrufe auf Autorisieren.

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

    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.

    Die Gemini-Statusleiste ist verfügbar.

  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.

    Das Gemini-Symbol in der Statusleiste ist auf „Normal“ gesetzt.

Mit Gemini Code Assist chatten

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

So beginnen Sie mit dem Chatten mit Gemini:

  1. Öffnen Sie die Codedatei.

  2. Gehen Sie in der Aktivitätsleiste des Cloud Shell-Editors so vor: Klicken Sie 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.

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 Gemini Code Assist über die Chatfunktion um Hilfe bitten und 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 Prompt-Text in Ihrer Codedatei, Gemini Code Assist generiert 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 so ändern:

  1. Klicken Sie im Cloud Shell-Editor auf das Dreistrich-Menü 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 Bearbeiten Tastenkombination ändern.

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

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

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

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 und dann auf 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 schreibt einen Unittest für eine ausgewählte Funktion.

    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 kannst du diese Funktion ausprobieren:

  1. Schreiben Sie in Ihrer Codedatei in einer neuen Zeile eine Funktion. Beispiel: 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 im Cloud Shell-Editor das Menü Menü aus und gehen Sie dann zu Datei > Einstellungen > Einstellungen.

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

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

    Dadurch werden die Inline-Vorschläge deaktiviert. Sie können immer noch Strg + Eingabetaste (Windows und Linux) oder Strg + Eingabetaste (für macOS), um Inline-Vorschläge manuell auszulösen.

Codevorschläge deaktivieren, die mit den 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

Damit Sie produktiver arbeiten und gleichzeitig den Kontextwechsel minimieren können, Gemini Code Assist bietet direkt KI-gestützte intelligente Aktionen in Ihrem Code-Editor. 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.

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

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

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

Vorabversion: Codetransformationen verwenden

Gemini Code Assist bietet Codetransformationen, mit denen 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 Codetransformationen haben Sie folgende Möglichkeiten:

  • Kommentarzeilen zum Dokumentieren Ihres Codes generieren
  • Code mit Problemen beheben
  • Verbesserung der Lesbarkeit von Code
  • 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 der Codedatei Strg + I (Windows und Linux) oder Befehlstaste + I (für 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 Eingabetaste (macOS).

    Gemini Code Assist generiert den Code basierend auf Ihrem Prompt.

Diff des überarbeiteten Codes ansehen

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 diese dann annehmen oder die vorgeschlagenen Änderungen verwerfen.

Um die Unterschiede des refaktorierten Codes im Inline-Textfeld anzuzeigen, führen Sie die folgenden Schritten:

  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 (für macOS).

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

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

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

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

Kontextquellen einer generierten Antwort ansehen

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.

Wenn Sie die Kontextquellen der generierten Antwort aufrufen 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.

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

Intelligente Befehle 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 drücken. (Windows und Linux) oder Befehlstaste + I (für macOS).

  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 sich die generierte Antwort in Gemini: Chat ansehen möchten auf In Google Chat ansehen.

Prompt-Verlauf ansehen

Durch den Zugriff auf den Prompt-Verlauf sparen Sie Zeit, wenn Sie dieselben Informationen Prompt(s) in einer großen Codedatei.

Um auf Ihren Prompt-Verlauf zuzugreifen, öffnen Sie in Ihrer Codedatei das Inline-Textfeld mit durch Drücken von Strg + I (Windows und Linux) oder Befehlstaste + I (für macOS) und drücken Sie dann Strg + Aufwärtspfeil (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 keine Muttersprachler sind und Übersetzungsprogramme verwenden, können Sie Kommentare in anderen Sprachen im Inline-Textfeld eingeben.

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. Öffnen Sie das Inline-Textfeld durch Drücken von Strg+I (für Windows und Linux) oder Befehlstaste + I (für macOS).

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

    Gemini generiert Kommentare in der von Ihnen angegebenen Sprache in Ihrem Prompt und sehen Sie sich den Unterschied dieser Vorschläge an.

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

Weitere Beispiel-Prompts testen

Nachdem Sie die Abschnitt Code mit Prompts generieren hier -Dokument enthält, probieren Sie einige der folgenden Beispiel-Prompts aus.

Codeerklärung 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 Erläuterung 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 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, 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 aus, bevor Sie Gemini aufrufen.

Bekannte Probleme

In den folgenden Abschnitten werden die bekannten Probleme Gemini Code Assist

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 das Dreistrich-Menü Dreistrich-Menü > Ansicht > Ausgabe.

  2. Wählen Sie Gemini Code Assist – Zitate 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 die Firewall so, dass die Kommunikation über HTTP/2 möglich ist, 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 nach der Auswahl eines Gemini Code Assist-Projekts weiterhin angezeigt

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 für die gewünschten Protokolldateien auf Einblenden, um weitere Details zu sehen und Hilfe zu erhalten. um das Problem zu beheben.

Feedback geben

So geben Sie uns Feedback:

  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