Configurare Gemini in Firebase all'interno degli spazi di lavoro

Firebase Studio semplifica i flussi di lavoro di sviluppo con le seguenti funzionalità di codice assistite dall'IA:

  • Completamento del codice suggerito durante la digitazione.

  • Assistenza AI con chat, che è consapevole dello spazio di lavoro e completamente integrata con il 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 di terminale, interpretare l'output dei comandi e determinare i passaggi successivi. Scopri di più all'indirizzo Prova chattare con Gemini.

  • Azioni in linea che puoi eseguire su parti di codice selezionate. Ad esempio, puoi chiedere a Gemini di rendere più leggibile il codice selezionato.

  • Assistenza per il codice in linea.

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

Utilizzare Gemini in Firebase nello spazio di lavoro

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

  1. Utilizza la chat o l'assistenza per il codice in linea 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 due opzioni che seguono sono attive per impostazione predefinita:

    • Suggerimenti durante la digitazione, che fornisce il completamento del codice in linea.
    • Indicizzazione della base di codice, che offre una migliore personalizzazione e risposte più utili.

    Per modificare in futuro queste selezioni per le impostazioni dell'area di lavoro:

    Puoi anche escludere file e directory specifici dall'indicizzazione AI. Consulta Escludere file da Gemini con 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 dei 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 basato sull'IA che prevede e compila automaticamente il codice in qualsiasi file aperto non appena inizi a digitare.

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

Per attivare o disattivare il completamento automatico del codice, modifica le impostazioni di completamento automatico 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 Icona a forma di ingranaggio Gestisci (in basso a sinistra nello spazio di lavoro), quindi scegli Impostazioni o premi Ctrl+, (Cmd+, su Mac).

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

    2. Seleziona la scheda Spazio di lavoro, quindi cerca l'impostazione Firebase Studio > IA > Abilita completamento in linea.

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

Modificare le impostazioni di indicizzazione del codice base

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

Tieni presente che l'indicizzazione della base di codice è attiva per impostazione predefinita.

Per attivare o disattivare l'indicizzazione del codice, modifica le impostazioni di indicizzazione della base di codice 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 Icona a forma di ingranaggio Gestisci (in basso a sinistra nello spazio di lavoro), quindi scegli Impostazioni o premi Ctrl+, (Cmd+, su Mac).

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

    2. Seleziona la scheda Spazio di lavoro, quindi cerca l'impostazione Firebase Studio > IA > Attiva il completamento in linea.

    3. Seleziona Firebase Studio > AI: attiva l'indicizzazione del codebase.

    4. Per disattivare l'indicizzazione del codice, deseleziona IA: attiva l'indicizzazione della base di codice. Devi aggiornare le impostazioni di indicizzazione del codice per ogni spazio di lavoro.

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

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

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

  • Influenzare la persona di Gemini e specializzarne le competenze.
  • Applicazione di standard a livello di progetto, come stile di programmazione, convenzioni e preferenze tecnologiche.
  • Riduci la 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 AI

Per creare e testare il file delle regole AI:

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

    • In Explorer (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. Ti consigliamo di aggiungere informazioni sulla persona Gemini deve utilizzare (ad esempio "Sei uno sviluppatore esperto e un assistente utile che sa tutto su Next.js"), gli standard di programmazione e conversazione e il contesto del progetto. Consulta l'esempio che segue per un file di regole AI di esempio.

  3. Salva il file e apri Gemini in Firebase.

  4. Per iniziare a utilizzare le regole di IA, puoi procedere in uno dei seguenti modi:

    • Ricostruisci lo spazio di lavoro aggiornando la pagina. Dopo la ricostruzione, Gemini in Firebase utilizzerà il file delle regole all'interno della chat. Le modifiche al file delle regole dell'IA dovrebbero essere applicate immediatamente in chat.
    • Se non vuoi ricostruire il tuo spazio di lavoro, puoi chiedere a Gemini di contattare load airules.md tramite chat. Se apporti modifiche al file durante la sessione corrente, potrebbe essere necessario richiedere nuovamente a Gemini di ricaricare il file delle regole.
  5. Fai domande sul tuo codice. Gemini risponde utilizzando le informazioni che hai incluso nel file delle regole come contesto.

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.

Escludere i file da Gemini con i file .aiexclude

Puoi controllare quali file della base di codice devono essere nascosti da Gemini includendo i file .aiexclude nel progetto. In questo modo puoi controllare in modo granulare il contesto del progetto che condividi con Gemini.

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 IA che operano nell'editor. Un file .aiexclude opera sui file nella directory che lo contiene o al di sotto.

I file coperti da .aiexclude non verranno indicizzati da Gemini se è attivata la funzionalità Indicizzazione del codice base. Inoltre, .aiexclude influirà sull'assistenza in linea per i file coperti nei seguenti modi:

  • Assistenza via chat: Gemini non potrà rispondere alle domande o offrire suggerimenti sui file coperti da .aiexclude.
  • Completamento del codice: i completamenti di codice suggeriti non saranno disponibili durante l'editing dei file coperti.
  • Assistenza in linea: potrai generare nuovo codice, ma non modificare quello esistente quando modifichi i file coperti.

Anche altri ambienti di sviluppo, come Android Studio, potrebbero supportare 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 relativa directory e in tutte le sue sottodirectory. È lo stesso di un file che contiene **/*.
  • I file .aiexclude non supportano la negazione (prefissi dei pattern con !).

Esempi

Ecco alcuni esempi di configurazioni del file .aiexclude:

  • Blocca tutti i file denominati apikeys.txt nella directory contenente il file .aiexclude o al suo interno:

    apikeys.txt
    
  • Blocca tutti i file con l'estensione .key nella directory o nelle directory al di sotto della directory contenente il file .aiexclude:

    *.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/
    

Porta la tua chiave: utilizza altri modelli Gemini in chat

Puoi configurare il modello Gemini utilizzato da Gemini in Firebase chat. Puoi scegliere 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 Gemini modelli.

Per configurare la chiave e selezionare un altro modello Gemini:

  1. Nell'area di lavoro aperta, fai clic su Spark Gemini nella parte inferiore dell'area di lavoro (o sulla scheda Gemini).

  2. Nella finestra della chat di Gemini in Firebase, fai clic sul menu a discesa del nome del modello, quindi sul link della chiave Gemini API. Viene visualizzata la pagina Impostazioni utente.

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

Ora puoi selezionare uno dei modelli Gemini preconfigurati in chat.

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

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

  2. Nella finestra della chat di Gemini in Firebase, fai clic sul selettore del modello e poi scegli ID modello personalizzato. Si apre la pagina Impostazioni dell'utente.

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

  4. Chiudi la finestra della chat, quindi riaprila facendo clic su Spark Gemini nella parte inferiore dell'area di lavoro per aggiornare l'elenco dei modelli.

Passaggi successivi