Configurare Gemini in Firebase all'interno degli spazi di lavoro

Firebase Studio facilita i tuoi flussi di lavoro di sviluppo con le seguenti funzionalità di codice assistite dall'AI:

• Completamento del codice suggerito durante la digitazione.

• Assistenza AI con la chat, che è consapevole dello spazio di lavoro e completamente integrata nel tuo codice. Può generare, tradurre e spiegare il codice. Inoltre, con la tua revisione e approvazione, Gemini in Firebase può interagire direttamente con il tuo spazio di lavoro per aggiornare i file, eseguire comandi del terminale, interpretare l'output dei comandi e determinare i passaggi successivi. Scopri di più su Prova la chat con Gemini.

• Azioni in linea che puoi intraprendere sui frammenti di codice selezionati. Ad esempio, puoi chiedere a Gemini di rendere più leggibile il codice selezionato.

• Assistenza per il codice in linea.

Importante: questa guida descrive la configurazione di Gemini in Firebase all'interno degli spazi di lavoro (visualizzazione Code). Per informazioni su Gemini in Firebase quando utilizzi App Prototyping agent, vedi Inizia a utilizzare App Prototyping agent.

Puoi personalizzare il modo in cui Gemini in Firebase ti aiuta modificando le sue impostazioni e aggiungendo file di regole AI:

• Modifica le impostazioni del completamento del codice.
• Modifica le impostazioni di indicizzazione del codebase.
• Personalizza le istruzioni per Gemini con un file di regole dell'AI.
• Escludi i file da Gemini con .aiexclude file.
• Bring your own key: utilizzare altri modelli Gemini in chat

Importante: Gemini in Firebase può generare output che sembrano plausibili, ma sono oggettivamente errati. Potrebbe rispondere con informazioni imprecise che non rappresentano l'opinione di Google. Verifica tutti gli output di Gemini prima di utilizzarli e non utilizzare in produzione il codice generato non testato. Non inserire nella chat informazioni che consentono l'identificazione personale (PII) o dati utente.

Usare Gemini in Firebase nel tuo spazio di lavoro

Utilizza Gemini in Firebase per aumentare la produttività di programmazione tramite il pannello della chat o l'assistenza per il codice incorporato.

Nota: se utilizzi App Prototyping agent in Prototyper view, click Switch to Code to open Code view.

1. Utilizza l'assistenza per il codice in linea o nella chat nel tuo workspace:

   • Per utilizzare la chat: nello spazio di lavoro aperto, fai clic su Spark Gemini nella parte inferiore dello spazio di lavoro.

   • Per utilizzare l'assistenza per il codice in linea: inizia a digitare il codice e premi Tab per accettare i suggerimenti.

2. Tieni presente che le seguenti due opzioni sono attive per impostazione predefinita:

   • Suggerimenti durante la digitazione, che fornisce il completamento del codice incorporato.
   • Indicizzazione del codebase, che offre una migliore personalizzazione e risposte più utili.

   Per modificare queste selezioni per le impostazioni dello spazio di lavoro in futuro:

   • Per aggiornare le impostazioni del completamento automatico del codice, vedi Modificare le impostazioni del completamento automatico del codice.
   • Per aggiornare le impostazioni di indicizzazione del codice, consulta Modificare le impostazioni di indicizzazione del codice.

   Puoi anche escludere file e directory specifici dall'indicizzazione dell'AI. Vedi Escludere i file da Gemini con i file .aiexclude.

Gemini nelle scorciatoie di Firebase

Per aprire rapidamente la chat con Gemini, premi Ctrl+Shift+Space (o Cmd+Shift+Space su macOS).

Per visualizzare i comandi Gemini dalla tavolozza comandi:

1. Apri la tavolozza dei comandi premendo Ctrl+Shift+P (o Cmd+Shift+P su macOS).

2. Cerca Gemini.

   Viene visualizzato un elenco di comandi Gemini.

Modificare le impostazioni di completamento del codice

Per aiutarti a scrivere codice, Firebase Studio fornisce il completamento del codice AI che prevede e compila automaticamente il codice in qualsiasi file aperto non appena inizi a digitare.

Tieni presente che il completamento del codice è attivato per impostazione predefinita.

Per attivare o disattivare il completamento del codice, modifica le impostazioni di completamento del codice utilizzando uno dei seguenti metodi:

• Se utilizzi un file settings.json, imposta "IDX.aI.enableInlineCompletion" su true o false.

• Per aggiornare le impostazioni nello spazio di lavoro Firebase Studio:

  1. Fai clic su Gestisci (in basso a sinistra dello spazio di lavoro), quindi scegli Impostazioni o premi Ctrl+, (Cmd+, su Mac).

     Se utilizzi App Prototyping agent in Prototyper view, click Switch to Code to open Code view.

  2. Seleziona la scheda Workspace, quindi cerca l'impostazione Firebase Studio > AI > Enable Inline Completion (Firebase Studio > AI > Abilita completamento in linea).

  3. Per disattivare il completamento del codice, deseleziona l'opzione Attiva il completamento del codice in linea durante la digitazione.

Suggerimento: per mantenere questa impostazione in tutte le aree di lavoro, configura l'impostazione nella scheda Utente. In questo modo, le impostazioni vengono applicate a ogni spazio di lavoro a cui accedi con il tuo account utente. Se condividi il tuo spazio di lavoro, dovrai comunque configurare l'impostazione dello spazio di lavoro.

Modificare le impostazioni di indicizzazione del codebase

Puoi controllare se Gemini indicizza il tuo codice. L'indicizzazione del codice fornisce risultati più utili quando utilizzi l'assistenza AI in chat o in linea.

Tieni presente che l'indicizzazione del codebase è attiva per impostazione predefinita.

Suggerimento :puoi controllare quali file vengono indicizzati da Gemini in Firebase. Scopri di più su Escludere file da Gemini con .aiexclude file.

Per attivare o disattivare l'indicizzazione del codice, modifica le impostazioni di indicizzazione del codebase utilizzando uno dei seguenti metodi:

• Se utilizzi un file settings.json, imposta "IDX.aI.enableCodebaseIndexing" su true o false.

• Per aggiornare le impostazioni nello spazio di lavoro Firebase Studio:

  1. Fai clic su Gestisci (in basso a sinistra dello spazio di lavoro), quindi scegli Impostazioni o premi Ctrl+, (Cmd+, su Mac).

     Se utilizzi App Prototyping agent in Prototyper view, click Switch to Code to open Code view.

  2. Seleziona la scheda Workspace, quindi cerca l'impostazione Firebase Studio > AI > Enable Inline Completion (Abilita completamento in linea).

  3. Seleziona Firebase Studio > AI: Enable Codebase Indexing.

  4. Per disattivare l'indicizzazione del codice, deseleziona AI: Enable Codebase Indexing. Devi aggiornare le impostazioni di indicizzazione del codice per ciascuno dei tuoi spazi di lavoro.

Suggerimento: per mantenere questa impostazione in tutte le aree di lavoro, configura l'impostazione nella scheda Utente. In questo modo, le impostazioni vengono applicate a ogni spazio di lavoro a cui accedi con il tuo account utente. Se condividi il tuo spazio di lavoro, dovrai comunque configurare l'impostazione dello spazio di lavoro.

Personalizzare le istruzioni per Gemini in Firebase con un file di regole AI

Puoi aggiungere informazioni sul contesto e sul prompt di sistema creando un file di regole AI (.idx/airules.md). Gemini in Firebase utilizza le regole come istruzioni di sistema e contesto, garantendo che le risposte siano personalizzate per il tuo caso d'uso.

Utilizza il file delle regole dell'AI per condividere prompt personalizzati, best practice e persino contesto importante sul tuo progetto con Gemini per raggiungere obiettivi come:

• Influenzare la persona di Gemini e specializzare le sue competenze.
• Applicare standard a livello di progetto, come stile di programmazione, convenzioni e preferenze tecnologiche.
• Riduzione della quantità di informazioni che devi condividere esplicitamente nel codice o nella chat fornendo il contesto essenziale del tuo progetto.

Le regole che configuri vengono utilizzate da Gemini in Chat.

Creare e testare il file delle regole dell'AI

Per creare e testare il file di regole dell'AI:

1. Crea un nuovo file in .idx/airules.md nel tuo workspace Firebase Studio (nella stessa directory del file dev.nix). Puoi utilizzare una delle seguenti opzioni:

   • In Esplora (Ctrl+Shift+E), fai clic con il tasto destro del mouse su .idx e seleziona Nuovo file. Assegna al file il nome airules.md e premi Invio.
   • Dal terminale, utilizza l'editor di testo che preferisci per aprire .idx/airules.md.

2. Aggiungi contenuti al file. Potresti voler aggiungere informazioni sulla persona Gemini da utilizzare (ad esempio "Sei uno sviluppatore esperto e un assistente utile che sa tutto su Next.js"), standard di codifica e conversazione e contesto del progetto. Vedi il seguente esempio per un file di regole AI di esempio.

3. Salva il file e apri Gemini in Firebase.

4. Per iniziare a utilizzare le regole dell'AI, puoi procedere in uno dei seguenti modi:

   • Ricostruisci lo spazio di lavoro aggiornando la pagina. Dopo la ricompilazione, Gemini in Firebase utilizzerà il file delle regole all'interno della chat. Le modifiche al file delle regole dell'AI devono essere applicate immediatamente nella chat.
   • Se non vuoi ricreare il tuo spazio di lavoro, puoi chiedere a Gemini tramite chat di load airules.md. Se apporti modifiche al file durante la sessione corrente, potresti dover richiedere nuovamente a Gemini di caricare di nuovo il file delle regole.

5. Fare domande sul codice. Gemini risponde utilizzando le informazioni che hai incluso nel file di regole come contesto.

Suggerimento: se hai sviluppato file di regole per altri IDE basati sull'AI, puoi copiarli direttamente in .idx/airules.md. Se il progetto ha un file .cursorrules nella directory principale, Gemini lo utilizzerà, a meno che non sia presente anche .idx/airules.md. Se esistono sia .cursorrules che .idx/airules.md, airules.md ha la precedenza.

Esempio

Di seguito è riportato un esempio di base di un file di regole che potresti utilizzare per un gioco casual sviluppato con Next.js:

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

Suggerimento: le regole di AI contribuiscono alle dimensioni complessive del contesto, pertanto ti consigliamo di mantenere il file delle regole di AI entro un limite ragionevole per garantire le migliori prestazioni del modello.

Escludi i file da Gemini con .aiexclude file

Puoi controllare quali file nel tuo codice sorgente devono essere nascosti a Gemini includendo i file .aiexclude nel tuo progetto. In questo modo puoi controllare in modo granulare il contesto del progetto che condividi con Gemini.

Proprio come un file .gitignore, un file .aiexclude tiene traccia dei file che non devono essere condivisi con Gemini, inclusa l'esperienza di chat e le funzionalità di AI che operano nell'editor. Un file .aiexclude opera sui file nella directory che lo contiene o nelle directory sottostanti.

Nota: i file ignorati dai file .gitignore nel repository vengono esclusi automaticamente, anche se non sono elencati in un file .aiexclude.

I file coperti da .aiexclude non verranno indicizzati da Gemini quando l'indicizzazione del codebase è attivata. Inoltre, .aiexclude influenzerà l'assistenza in linea per i file coperti nei seguenti modi:

• Assistenza chat: Gemini non potrà rispondere a domande o offrire suggerimenti sui file coperti da .aiexclude.
• Completamento del codice: i suggerimenti per il completamento del codice non saranno disponibili durante la modifica dei file coperti.
• Assistenza in linea: potrai generare nuovo codice, ma non modificare il codice esistente durante la modifica dei file coperti.

Anche altri ambienti di sviluppo come Android Studio potrebbero rispettare i file .aiexclude.

Come scrivere file .aiexclude

Un file .aiexclude segue la stessa sintassi di un file .gitignore, con le seguenti differenze:

• Un file .aiexclude vuoto blocca tutti i file nella directory e in tutte le sottodirectory. È come un file che contiene **/*.
• I file .aiexclude non supportano la negazione (prefisso dei pattern con !).

Esempi

Ecco alcune configurazioni di file .aiexclude di esempio:

• Blocca tutti i file denominati apikeys.txt nella directory contenente il file .aiexclude o nelle directory di livello inferiore:

  apikeys.txt
  

• Blocca tutti i file con l'estensione .key nella directory che contiene il file .aiexclude o in una directory di livello inferiore:

  *.key
  

• Blocca solo il file apikeys.txt nella stessa directory di .aiexclude, ma non le sottodirectory:

  /apikeys.txt
  

• Blocca tutti i file nella directory my/sensitive/dir e in tutte le sottodirectory. Il percorso deve essere relativo alla directory che contiene il file .aiexclude:

  my/sensitive/dir/
  

Usa la tua chiave: utilizza altri modelli Gemini nella chat

Sperimentale: questa funzionalità è sperimentale.

Puoi configurare il modello Gemini utilizzato da Gemini in Firebase Chat. Puoi scegliere tra il modello integrato, i modelli configurati nella finestra della chat (inclusi i modelli Gemini 2.5) o qualsiasi modello Gemini a cui hai accesso.

Per un elenco di tutti i modelli disponibili, consulta la sezione Modelli Gemini.

Importante :Firebase Studio le impostazioni dell'IA sono impostazioni utente. Ciò significa che rimarranno configurate per te su più workstation.

Per configurare la chiave e selezionare un modello Gemini diverso:

1. Nello spazio di lavoro aperto, fai clic su Spark Gemini in fondo allo spazio di lavoro (o nella scheda Gemini).

2. Nella finestra di chat di Gemini in Firebase, fai clic sul menu a discesa del nome del modello, quindi sul link Gemini API. Vengono visualizzate le impostazioni utente.

3. Nel campo IDX > AI: Gemini Api Key, inserisci la chiave Gemini API.

   Nota :questo campo potrebbe essere già compilato se hai utilizzato App Prototyping agent e se è stato creato un progetto Firebase e una chiave Gemini API per te.

Ora puoi selezionare uno qualsiasi dei modelli Gemini preconfigurati nella chat.

Per configurare un modello Gemini che non è presente nel menu a discesa:

1. Identifica il modello Gemini che vuoi utilizzare nella chat dall'elenco in Modelli Gemini. Ad esempio, devi inserire gemini-2.0-flash-lite per utilizzare l'ultima versione stabile del modelloGemini 2.0 Flash‑Lite.

2. Nella finestra di chat di Gemini in Firebase, fai clic sul selettore del modello e poi scegli ID modello personalizzato. Si aprono le Impostazioni utente.

3. Copia il nome del modello selezionato nel campo IDX > AI: Gemini Model.

4. Chiudi la finestra della chat e riaprila facendo clic su spark Gemini nella parte inferiore dello spazio di lavoro per aggiornare l'elenco dei modelli.

Passaggi successivi

• Prova Gemini in Firebase.