Gemini in Arbeitsbereichen konfigurieren

Firebase Studio erleichtert Ihre Entwicklungs-Workflows mit den folgenden KI-gestützten Codefunktionen:

• Vorschläge zur Codevervollständigung während der Eingabe.

• KI-Unterstützung mit Chat, die den Arbeitsbereich kennt und vollständig in Ihren Code integriert ist. Es kann Code generieren, übersetzen und erklären. Nachdem Sie die entsprechenden Berechtigungen erteilt haben, kann Gemini direkt mit Ihrem Arbeitsbereich interagieren, um Dateien zu aktualisieren, Terminalbefehle auszuführen, Befehlsausgaben zu interpretieren und die nächsten Schritte zu bestimmen. Weitere Informationen finden Sie unter Chat mit Gemini in Firebase Studio ausprobieren.

• Inline-Aktionen, die Sie für ausgewählte Codeabschnitte ausführen können. Sie können Gemini beispielsweise bitten, den ausgewählten Code lesbarer zu machen.

• Inline-Unterstützung beim Programmieren.

Wichtig: In diesem Leitfaden wird der interaktive Standardchat von Gemini beschrieben. Mit App Prototyping agent erstellte Anwendungen verwenden standardmäßig den Prototyper-Chat in der Code-Ansicht. Wenn Sie stattdessen den interaktiven Chat von Gemini verwenden möchten, klicken Sie unter Gemini auf + und wählen Sie dann Neuer Chat aus. Wenn Sie zum Prototyper-Chat zurückkehren möchten, klicken Sie auf Letzte Chats und wählen Sie dann Prototyper-Chat aus. Informationen zum Prototyper-Chat finden Sie unter Erste Schritte mit dem App Prototyping agent.

Sie können anpassen, wie Gemini Sie unterstützt, indem Sie die Einstellungen anpassen und Dateien mit KI-Regeln hinzufügen:

• Einstellungen für die Codevervollständigung anpassen
• Einstellungen für die Indexierung der Codebasis anpassen
• Anweisungen für Gemini mit einer KI-Regeldatei anpassen
• Dateien mit .aiexclude-Dateien aus Gemini ausschließen.
• Eigene Schlüssel verwenden: Andere Gemini-Modelle im Chat verwenden
• Anpassen, wie Gemini Codeänderungen vorschlägt oder anwendet

Wichtig: Gemini kann Ausgaben generieren, die zwar plausibel erscheinen, aber faktisch falsch sind. Möglicherweise werden fehlerhafte Informationen zurückgegeben, die nicht die Auffassung von Google widerspiegeln. Validieren Sie alle Ausgaben von Gemini, bevor Sie sie verwenden, und verwenden Sie ungetesteten generierten Code nicht in der Produktionsumgebung. Geben Sie keine personenidentifizierbaren Informationen oder Nutzerdaten in den Chat ein.

Gemini in Ihrem Arbeitsbereich verwenden

Mit Gemini können Sie Ihre Programmierproduktivität über das Chat-Panel, das Terminal oder die Unterstützung für Inline-Code steigern.

Hinweis: Wenn Sie App Prototyping agent in der Ansicht Prototyper verwenden, klicken Sie auf Zu Code wechseln, um die Ansicht Code zu öffnen.

1. Verwenden Sie in Ihrem Arbeitsbereich entweder die Chat- oder die Inline-Unterstützung beim Programmieren:

   • So verwenden Sie den Chat: Klicken Sie im geöffneten Arbeitsbereich unten auf spark Gemini.

   • So verwenden Sie die Inline-Unterstützung beim Programmieren: Beginnen Sie mit der Eingabe Ihres Codes und drücken Sie Tab, um Vorschläge anzunehmen.

2. Die folgenden beiden Optionen sind standardmäßig aktiviert:

   • Vorschläge während der Eingabe, die eine Inline-Codevervollständigung ermöglichen.
   • Codebasis-Indexierung, die eine bessere Anpassung und hilfreichere Antworten ermöglicht.

   So ändern Sie diese Auswahl für Ihre Arbeitsbereichseinstellungen in Zukunft:

   • Informationen zum Aktualisieren der Einstellungen für die Codevervollständigung finden Sie unter Einstellungen für die Codevervollständigung anpassen.
   • Informationen zum Aktualisieren der Einstellungen für die Codeindexierung finden Sie unter Einstellungen für die Codeindexierung anpassen.

   Sie können auch bestimmte Dateien und Verzeichnisse von der KI-Indexierung ausschließen. Weitere Informationen finden Sie unter Dateien mit .aiexclude-Dateien von Gemini ausschließen.

Gemini Kurzbefehle

So öffnen Sie schnell einen Chat mit Gemini: Drücken Sie Ctrl+Shift+Space (oder Cmd+Shift+Space unter macOS).

So rufen Sie Gemini-Befehle über die Befehlspalette auf:

1. Öffnen Sie die Befehlspalette, indem Sie Ctrl+Shift+P (oder Cmd+Shift+P unter macOS) drücken.

2. Suchen Sie nach Gemini.

   Eine Liste der Gemini-Befehle wird angezeigt.

Einstellungen für die Codevervollständigung anpassen

Firebase Studio bietet eine KI-gestützte Codevervollständigung, die Code in jeder geöffneten Datei vorhersagt und automatisch ausfüllt, sobald Sie mit dem Tippen beginnen.

Die Codevervollständigung ist standardmäßig aktiviert.

Wenn Sie die Codevervollständigung aktivieren oder deaktivieren möchten, passen Sie die Einstellungen für die Codevervollständigung mit einer der folgenden Methoden an:

• Wenn Sie eine settings.json-Datei verwenden, legen Sie "IDX.aI.enableInlineCompletion" auf true oder false fest.

• So aktualisieren Sie die Einstellungen im Arbeitsbereich „Firebase Studio“:

  1. Klicken Sie links unten im Arbeitsbereich auf Verwalten und wählen Sie „Einstellungen“ aus oder drücken Sie Ctrl+, (Cmd+, auf dem Mac).

     Wenn Sie die Ansicht App Prototyping agent in Prototyper verwenden, klicken Sie auf Zu Code wechseln, um die Ansicht Code zu öffnen.

  2. Wählen Sie den Tab Arbeitsbereich aus und suchen Sie nach der Einstellung Firebase Studio > KI > Inline-Vervollständigung aktivieren.

  3. Wenn Sie die Codevervollständigung deaktivieren möchten, heben Sie die Auswahl der Option Inline-Codevervollständigung während der Eingabe aktivieren auf.

Tipp: Wenn Sie diese Einstellung für alle Ihre Arbeitsbereiche beibehalten möchten, konfigurieren Sie die Einstellung auf dem Tab Nutzer. So werden Ihre Einstellungen auf jeden Arbeitsbereich angewendet, auf den Sie mit Ihrem Nutzerkonto zugreifen. Wenn Sie Ihren Arbeitsbereich freigeben, müssen Sie die Arbeitsbereichseinstellung trotzdem konfigurieren.

Einstellungen für die Indexierung der Codebasis anpassen

Sie können festlegen, ob Gemini Ihren Code indexiert. Wenn Sie Ihren Code indexieren, erhalten Sie relevantere Ergebnisse, wenn Sie den Chat oder die Inline-KI-Unterstützung verwenden.

Die Indexierung der Codebasis ist standardmäßig aktiviert.

Tipp: Sie können festlegen, welche Dateien von Gemini indexiert werden. Weitere Informationen finden Sie unter Dateien mit .aiexclude-Dateien aus Gemini ausschließen.

Wenn Sie die Codeindexierung aktivieren oder deaktivieren möchten, passen Sie die Einstellungen für die Codebasisindexierung mit einer der folgenden Methoden an:

• Wenn Sie eine settings.json-Datei verwenden, legen Sie "IDX.aI.enableCodebaseIndexing" auf true oder false fest.

• So aktualisieren Sie die Einstellungen im Arbeitsbereich „Firebase Studio“:

  1. Klicken Sie auf Verwalten (unten links im Arbeitsbereich) und wählen Sie „Einstellungen“ aus oder drücken Sie Ctrl+, (Cmd+, auf einem Mac).

     Wenn Sie die Ansicht App Prototyping agent in Prototyper verwenden, klicken Sie auf Zu Code wechseln, um die Ansicht Code zu öffnen.

  2. Wählen Sie den Tab Arbeitsbereich aus und suchen Sie nach der Einstellung Firebase Studio > KI > Inline-Vervollständigung aktivieren.

  3. Wählen Sie Firebase Studio > AI: Enable Codebase Indexing aus.

  4. Wenn Sie die Codeindexierung deaktivieren möchten, heben Sie die Auswahl von AI: Enable Codebase Indexing auf. Sie müssen die Einstellungen für die Codeindexierung für jeden Ihrer Arbeitsbereiche aktualisieren.

Tipp: Wenn Sie diese Einstellung für alle Ihre Arbeitsbereiche beibehalten möchten, konfigurieren Sie die Einstellung auf dem Tab Nutzer. So werden Ihre Einstellungen auf jeden Arbeitsbereich angewendet, auf den Sie mit Ihrem Nutzerkonto zugreifen. Wenn Sie Ihren Arbeitsbereich freigeben, müssen Sie die Arbeitsbereichseinstellung trotzdem konfigurieren.

Anweisungen für Gemini mit einer KI-Regeldatei anpassen

Sie können Kontext- und System-Prompt-Informationen hinzufügen, indem Sie eine Datei mit KI-Regeln erstellen:

Gemini-Chat priorisiert .idx/airules.md, verwendet aber GEMINI.md, wenn .idx/airules.md nicht vorhanden ist.

Gemini verwendet Ihre Regeln als Systemanweisungen und Kontext und passt die Antworten an Ihren Anwendungsfall an.

In der Datei mit KI-Regeln können Sie benutzerdefinierte Prompts, Best Practices und sogar wichtige Kontextinformationen zu Ihrem Projekt mit Gemini teilen, um Ziele wie die folgenden zu erreichen:

• Die Persona von Gemini beeinflussen und das Fachwissen spezialisieren.
• Projektweite Standards wie Codierungsstil, Konventionen und Technologiepräferenzen anwenden.
• Reduzieren Sie die Menge an Informationen, die Sie explizit im Code oder Chat teilen müssen, indem Sie wichtige Kontextinformationen zu Ihrem Projekt bereitstellen.

KI-Regeldatei erstellen und testen

So erstellen und testen Sie Ihre KI-Regeldatei:

1. Erstellen Sie eine neue Datei unter .idx/airules.md (oder GEMINI.md) in Ihrem Firebase Studio-Arbeitsbereich. Sie haben die folgenden Möglichkeiten:

   • Klicken Sie im Explorer (Ctrl+Shift+E) mit der rechten Maustaste auf das übergeordnete Verzeichnis und wählen Sie Neue Datei aus. Benennen Sie die Datei und drücken Sie die Eingabetaste.
   • Öffnen Sie im Terminal mit Ihrem bevorzugten Texteditor GEMINI.md oder .idx/airules.md.

2. Fügen Sie der Datei Inhalte hinzu. Sie können Informationen zur Persona hinzufügen, die Gemini verwenden soll (z. B. „Du bist ein erfahrener Entwickler und hilfreicher Assistent, der alles über Next.js weiß“), sowie zu Codierungs- und Konversationsstandards und zum Kontext des Projekts. Ein Beispiel für eine KI-Regeldatei finden Sie im folgenden Beispiel.

3. Speichern Sie die Datei und öffnen Sie Gemini.

4. Wenn Sie Ihre KI-Regeln verwenden möchten, haben Sie folgende Möglichkeiten:

   • Erstellen Sie den Arbeitsbereich neu, indem Sie die Seite aktualisieren. Nach dem Neuerstellen verwendet Gemini die Regeldatei im Chat. Änderungen an der Datei mit den KI-Regeln sollten sofort übernommen werden.
   • Wenn Sie Ihren Arbeitsbereich nicht neu erstellen möchten, können Sie Gemini bitten, load GEMINI.md oder load airules.md. Wenn Sie während der aktuellen Sitzung Änderungen an der Datei vornehmen, müssen Sie Gemini möglicherweise noch einmal auffordern, die Regeldatei zu laden.

5. Fragen zu Ihrem Code stellen Gemini antwortet anhand der Informationen, die Sie in der Regeldatei als Kontext angegeben haben.

   Gemini verwendet (in der Reihenfolge der Priorität) .idx/airules.md, GEMINI.md, .gemini/styleguide.md, AGENTS.md oder cursorrules.

Beispiel

Das folgende Beispiel zeigt eine einfache Regeldatei, die Sie für ein mit Next.js entwickeltes Casual Game verwenden können:

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

Tipp: KI-Regeln tragen zur Gesamtkontextgröße bei. Wir empfehlen daher, die Datei mit den KI-Regeln in einem angemessenen Rahmen zu halten, um die beste Modellleistung zu erzielen.

Dateien mit .aiexclude-Dateien aus Gemini ausschließen

Sie können festlegen, welche Dateien in Ihrer Codebasis vor Gemini verborgen bleiben sollen, indem Sie .aiexclude-Dateien in Ihr Projekt aufnehmen. So können Sie den Projektkontext, den Sie mit Gemini teilen, detailliert steuern.

Ähnlich wie eine .gitignore-Datei verfolgt eine .aiexclude-Datei Dateien, die nicht mit Gemini geteilt werden sollen, einschließlich des Chats und der KI-Funktionen, die im Editor verwendet werden. Eine .aiexclude-Datei wirkt sich auf Dateien im Verzeichnis oder einem Unterverzeichnis aus, das die Datei enthält.

Hinweis: Dateien, die von .gitignore-Dateien in Ihrem Repository ignoriert werden, werden automatisch ausgeschlossen, auch wenn sie nicht in einer .aiexclude-Datei aufgeführt sind.

Dateien, die von .aiexclude abgedeckt werden, werden von Gemini nicht indexiert, wenn die Codebasis-Indexierung aktiviert ist. Außerdem hat .aiexclude die folgenden Auswirkungen auf die Inline-Unterstützung für abgedeckte Dateien:

• Chat-Unterstützung: Gemini kann keine Fragen zu Dateien beantworten oder Vorschläge zu Dateien machen, die von .aiexclude abgedeckt werden.
• Codevervollständigung: Vorgeschlagene Codevervollständigungen sind beim Bearbeiten abgedeckter Dateien nicht verfügbar.
• Inline-Unterstützung: Sie können neuen Code generieren, aber keinen vorhandenen Code ändern, wenn Sie abgedeckte Dateien bearbeiten.

Andere Entwicklungsumgebungen wie Android Studio können .aiexclude-Dateien ebenfalls berücksichtigen.

.aiexclude-Dateien schreiben

Für eine .aiexclude-Datei gilt die gleiche Syntax wie für eine .gitignore-Datei, mit folgenden Unterschieden:

• Eine leere .aiexclude-Datei blockiert alle Dateien in ihrem Verzeichnis und allen Unterverzeichnissen. Dies entspricht einer Datei, die **/* enthält.
• .aiexclude-Dateien unterstützen keine Negation (Präfixmuster mit !).

Beispiele

Hier sind einige Beispiele für .aiexclude-Dateikonfigurationen:

• Alle Dateien mit dem Namen apikeys.txt im Verzeichnis oder einem Unterverzeichnis, das die .aiexclude-Datei enthält, blockieren:

  apikeys.txt
  

• Alle Dateien mit der Dateiendung .key im Verzeichnis oder einem Unterverzeichnis, das die .aiexclude-Datei enthält, blockieren:

  *.key
  

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

  /apikeys.txt
  

• Alle Dateien im Verzeichnis my/sensitive/dir und allen Unterverzeichnissen blockieren Der Pfad sollte relativ zum Verzeichnis sein, das die .aiexclude-Datei enthält:

  my/sensitive/dir/
  

Eigene Schlüssel verwenden: Andere Gemini-Modelle im Chat verwenden

Experimentell: Diese Funktion wird derzeit noch getestet.

Sie können das Gemini-Modell konfigurieren, das der Gemini-Chat verwendet. Sie können das integrierte Modell, im Chatfenster konfigurierte Modelle oder ein beliebiges Gemini-Modell auswählen, auf das Sie Zugriff haben.

Eine Liste aller verfügbaren Modelle finden Sie unter Gemini-Modelle.

Wichtig: Firebase Studio KI-Einstellungen sind Nutzereinstellungen. Das bedeutet, dass sie auf mehreren Workstations für Sie konfiguriert bleiben.

So konfigurieren Sie Ihren Schlüssel und wählen ein anderes Gemini-Modell aus:

1. Klicken Sie in Ihrem geöffneten Arbeitsbereich unten auf spark Gemini (oder auf den Tab Gemini).

2. Klicken Sie im Chatfenster von Gemini auf KI-Einstellungen. Die Nutzereinstellungen werden angezeigt.

3. Geben Sie im Feld IDX > KI: Gemini API-Schlüssel Ihren Gemini API-Schlüssel ein.

   Hinweis: Dieses Feld ist möglicherweise bereits ausgefüllt, wenn Sie das App Prototyping agent verwendet haben und ein Firebase-Projekt und ein Gemini API-Schlüssel für Sie erstellt wurden.

4. Wählen Sie im Drop-down-Menü IDX > KI: Modellanbieter die Option Gemini API aus.

Sie können jetzt im Chat eines der vorkonfigurierten Gemini-Modelle auswählen.

So konfigurieren Sie ein Gemini-Modell, das nicht im Drop-down-Menü enthalten ist:

1. Wählen Sie das Gemini-Modell, das Sie im Chat verwenden möchten, aus der Liste der Gemini-Modelle aus. Wenn Sie beispielsweise das Vorschaumodell Gemini 3 Pro Preview verwenden möchten, geben Sie gemini-3-pro-preview ein.

2. Klicken Sie im Gemini-Chatfenster auf die Modellauswahl und wählen Sie dann Benutzerdefinierte Modell-ID aus. Die Nutzereinstellungen werden geöffnet.

3. Kopieren Sie den ausgewählten Modellnamen in das Feld IDX > KI: Gemini-Modell.

4. Schließen Sie das Chatfenster und öffnen Sie es wieder, indem Sie unten im Arbeitsbereich auf Spark Gemini klicken, um die Modellliste zu aktualisieren.

Nächste Schritte

• Gemini ausprobieren: