Anleitungen, die Ihnen bei der Lösung von Problemen mit Ihrem Code helfen.
Code für Ihr Projekt generieren
Sie erhalten beim Programmieren Inline-Vorschläge.
Weitere 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.Mit der Codeanpassung erhalten Sie direkt von Gemini Code Assist Codevorschläge auf der Grundlage der privaten Codebasis Ihrer Organisation. Codeanpassung konfigurieren
Dieses Dokument richtet sich an Entwickler aller Qualifikationsstufen. Dabei werden Grundkenntnisse des Cloud Shell-Editors und Google Cloudvorausgesetzt. Sie können sich auch Gemini Code Assist in Cloud Workstations, Cloud Code for IntelliJ und Cloud Code for VS Code ansehen.
Verbindung zu Google Cloud herstellen und Projekt auswählen
In diesem Abschnitt stellen Sie eine Verbindung zu Google Cloud her und wählen einGoogle Cloud -Projekt aus, bei dem die Gemini for Google Cloud API im Cloud Shell-Editor aktiviert ist.
Wenn du ein Google Cloud -Projekt auswählst, für das die Gemini für Google Cloud API nicht aktiviert ist, erhältst du 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 im Cloud Shell-Editor eine Verbindung zu Google Cloud her:
Cloud Shell-Editor starten
Wenn Sie den alten Editor verwenden, klicken Sie auf Neuen Editor testen.
Klicken Sie in der Statusleiste auf Cloud Code – Sign In.
Wenn Sie aufgefordert werden, den Cloud Shell-Editor für API-Aufrufe Google Cloud zu autorisieren, klicken Sie auf Autorisieren.
Folgen Sie der Anleitung, um sich in Ihrem Google-Konto anzumelden.
Sie sind jetzt mit Google Cloudverbunden.
Gehen Sie dann so vor, um ein Google Cloud -Projekt auszuwählen, in dem Gemini for Google Cloud API aktiviert ist:
Klicken Sie in der Statusleiste von Gemini Code Assist auf Gemini Code Assist.
Wählen Sie im Menü Gemini Code Assist die Option Gemini Code-Projekt auswählen aus.
Wählen Sie ein Google Cloud -Projekt aus, in dem 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 zu Ihrem vorhandenen Code zu erhalten.
Gehen Sie so vor, um mit Gemini zu chatten:
Öffnen Sie die Codedatei.
Klicken Sie in der Aktivitätsleiste des Cloud Shell-Editors auf spark Gemini Code Assist.
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 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 delete Chat zurücksetzen.
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 dann über die Chatfunktion Gemini Code Assist um Hilfe bitten. Außerdem können Sie Codevorschläge erhalten und annehmen oder ablehnen, während Sie programmieren.
Gemini Code Assist in einer Codedatei auffordern
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) bzw. die Eingabetaste (macOS).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.
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:
Klicken Sie im Cloud Shell-Editor auf menu Menü und navigieren Sie dann zu Datei > Einstellungen > Tastaturkürzel.
Suchen Sie in der Liste der Tastenkombinationen nach Cloud Code: Code generieren.
Klicken Sie auf Cloud Code: Code generieren und dann auf edit Keybinding ändern.
Geben Sie im angezeigten Dialogfeld Ihre eigene Tastenkombination ein.
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. So erhalten Sie generierten Code, der auf einem Prompt mit ausgewähltem Code basiert:
Klicken Sie in der Aktivitätsleiste auf spark Gemini Code Assist, um den Bereich Gemini Code Assist zu öffnen.
Wählen Sie in Ihrer Codedatei einen Codeblock aus.
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 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:
Schreiben Sie in Ihrer Codedatei in einer neuen Zeile eine Funktion. Wenn Sie sich beispielsweise in einer Python-Datei befinden, schreiben Sie
def
.Gemini schlägt Code in Form von Geistertext vor.
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:
Wählen Sie im Cloud Shell-Editor menu Menü aus und navigieren Sie dann zu Datei > Einstellungen > Einstellungen.
Gehen Sie auf dem Tab Nutzer des Dialogfelds Einstellungen zu Erweiterungen > Cloud Code.
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.
Optional: Dateien mit einer .aiexclude-Datei aus dem Kontext ausschließen
Sie können Dateien ausschließen, damit sie von Gemini Code Assist für den Kontext berücksichtigt werden. Dazu erstellen Sie eine .aiexclude
-Datei. Eine .aiexclude
-Datei folgt der ähnlichen Syntax wie eine .gitignore
-Datei, mit folgenden Unterschieden:
- Eine leere oder nicht vorhandene
.aiexclude
-Datei blockiert keine Dateien in ihrem Verzeichnis und allen Unterverzeichnissen. - In der Datei
.aiexclude
wird die Negation nicht unterstützt, bei der Sie Mustern ein Ausrufezeichen (!
) voranstellen. - Eine
.aiexclude
-Datei sucht gierig nach dem Zeichen*
. Dabei werden Verzeichnisse und Dateien wahllos abgeglichen. Die Datei.aiexclude
unterscheidet in Bezug auf Ordner oder Dateien nicht zwischen**
und*
.
Derzeit wird nur eine einzige .aiexclude
-Datei unterstützt. Erstellen Sie zum Konfigurieren der Datei .aiexclude
im Stammverzeichnis Ihres Arbeitsbereichs eine Datei mit dem Namen .aiexclude
. Wenn Sie diese Datei außerhalb des Stammverzeichnisses des Arbeitsbereichs platzieren oder die Datei umbenennen möchten, kann der Pfad in den VS Code-Einstellungen unter „Kontextausschlussdatei“ festgelegt werden. Der in dieser Einstellung angegebene Pfadwert wird relativ zum Stammordner des geöffneten Arbeitsbereichs aufgelöst.
Beispiele
Die folgenden Beispiele veranschaulichen, wie Sie eine .aiexclude
-Datei konfigurieren können:
Blockieren Sie alle Dateien mit dem Namen
apikeys.txt
im oder unterhalb des Arbeitsbereichsverzeichnisses:apikeys.txt
Blockieren Sie alle Dateien mit der Dateiendung
.key
im oder unterhalb des Arbeitsbereichsverzeichnisses:*.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 den zitierten Quellen übereinstimmen
Gemini liefert Zitationsinformationen, wenn es direkt in 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 geminicodeassist.recitation.maxCitedLength
in einer settings.json
-Datei zu 0
ändern:
"geminicodeassist.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 der für Ihren Kontext relevanten Aktionen aufrufen und eine davon auswählen.
So verwenden Sie intelligente Aktionen in Ihrem Code:
Wählen Sie in Ihrer Codedatei einen Codeblock aus.
Klicken Sie neben dem ausgewählten Codeblock auf lightbulb Codeaktionen anzeigen.
Wählen Sie eine Aktion aus, z. B. Unittests generieren.
Gemini generiert eine Antwort, die auf der von Ihnen ausgewählten Aktion basiert.
Codetransformation verwenden
Gemini Code Assist bietet eine Codetransformation. Damit können Sie einen Teil Ihrer Codedatei auswählen und mithilfe von Prompts in natürlicher Sprache mithilfe eines Inline-Textfelds Änderungen an Ihrem vorhandenen Code anfordern.
Mit der Codetransformation 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:
Drücken Sie in der Codedatei Strg + I (Windows und Linux) oder Befehlstaste + I (Mac).
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:
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.
Geben Sie eine Eingabeaufforderung ein, z. B.
Add comments
, und drücken Sie die Eingabetaste (Windows und Linux) oder die Eingabetaste (für macOS).Wenn Gemini die Codeänderungen für die ausgewählte Funktion generiert, wird die Ansicht „Unterschiede“ angezeigt.
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 Erläuterung der gesamten Codedatei auf:
Öffnen Sie in Ihrer Codedatei das Inline-Textfeld, indem Sie Strg + I (unter Windows und Linux) oder Befehlstaste + I (für macOS) drücken.
Drücken Sie /, um die Liste intelligenter Befehle und die zugehörigen Beschreibungen aufzurufen.
Wählen Sie
/explain
aus.Gemini generiert im Inline-Textfeld eine Erklärung der gesamten Codedatei.
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 nutzen, 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:
Wählen Sie in der Codedatei Code aus, dem Sie Kommentare hinzufügen möchten.
Öffnen Sie das Inline-Textfeld, indem Sie Strg + I (Windows und Linux) oder Befehlstaste + I (Mac) drücken.
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.
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äuterung des Codes erhalten
- Wählen Sie in Ihrer Codedatei eine Funktion aus, die erklärt werden soll.
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 erstellen
- Wählen Sie in der Codedatei den Code aus, dem Sie Einheitentests hinzufügen möchten.
- Geben Sie im Bereich Gemini Code Assist den Prompt
Write unit tests for my code
ein.
Hilfe zum Debugging von Code
- Wählen Sie in der Codedatei den Code aus, in dem Sie Fehler beheben möchten.
- Geben Sie im Bereich Gemini Code Assist den Prompt
Help me debug my code
ein.
Ihren Code lesbarer machen
- Wählen Sie in Ihrer Codedatei den Code aus, der lesbarer gemacht werden soll.
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 Lizenzrezitationen werden nicht bei allen Sitzungen angezeigt
Wenn Warnungen zur Lizenzwiedergabe nicht über mehrere Sitzungen hinweg bestehen, sieh dir die persistenten Protokolle an:
Klicken Sie auf menu Menü > Ansicht > Ausgabe.
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
undcloudaicompanion.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. 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 zur folgenden 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 aktivieren“ wird immer noch angezeigt, nachdem Sie das Gemini Code Assist-Projekt ausgewählt haben
Wenn Sie gemäß der Anleitung in diesem Leitfaden Ihr Projekt ausgewählt haben und z. B. die Gemini für die Google Cloud API aktiviert haben, liegt möglicherweise ein Problem mit dem LS-Server vor.
So erhalten Sie weitere Informationen zu Ihrem Problem:
Klicken Sie in der Statusleiste auf spark Gemini Code Assist und wählen Sie dann Feedback geben aus.
Klicken Sie für die gewünschten Logdateien auf Anzeigen, um weitere Details zu sehen und Hilfe bei der Fehlerbehebung zu erhalten.
Feedback geben
So geben Sie uns Feedback:
Klicken Sie in der Statusleiste auf Gemini Code Assist und wählen Sie im Menü Schnellauswahl die Option Feedback geben aus.
Füllen Sie im Formular die Felder Titel und Kommentare aus.
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.
Klicken Sie auf Feedback geben.