Configurare Gemini all'interno degli spazi di lavoro

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

  • Completamento del codice suggerito durante la digitazione.

  • Assistenza AI tramite chat o interfaccia a riga di comando (CLI), che riconosce l'area di lavoro ed è completamente integrata nel codice. Può generare, tradurre e spiegare il codice. Inoltre, con la tua revisione e approvazione, Gemini può interagire direttamente con la tua area di lavoro per aggiornare i file, eseguire comandi del terminale, interpretare l'output comando, e determinare i passaggi successivi. Scopri di più in Prova la chat con Gemini in Firebase Studio.

  • Azioni in linea che puoi intraprendere 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 l'assistenza di Gemini modificando le impostazioni e aggiungendo file di regole AI:

Utilizzare Gemini nell'area di lavoro

Utilizza Gemini per aumentare la tua produttività nella programmazione tramite il riquadro della chat, terminale o l'assistenza per il codice in linea.

  1. Utilizza la chat o l'assistenza per il codice in linea nella tua area di lavoro:

    • Per utilizzare la chat: nell'area di lavoro aperta, fai clic spark Gemini nella parte inferiore dell'area di lavoro.

    • Per utilizzare Gemini CLI: apri il terminale e inserisci gemini per l'interfaccia Gemini CLI, oppure utilizza il comando gemini -p per utilizzare Gemini CLI in modalità non interattiva.

    • 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 seguenti sono attivate per impostazione predefinita:

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

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

    Puoi anche escludere file e directory specifici dall'indicizzazione AI. Consulta Escludi i file da Gemini con i file .aiexclude.

Gemini scorciatoie

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 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 nell'area di lavoro Firebase Studio:

    1. Fai clic su Icona a forma di ingranaggio Gestisci (in basso a sinistra nell'area di lavoro), quindi scegli Impostazioni oppure premi Ctrl+, (Cmd+, su Mac).

      Se utilizzi App Prototyping agent in Prototyper visualizzazione, fai clic su Icona di un interruttore di codice Passa al codice per aprire la visualizzazione Code.

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

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

Modificare le impostazioni di indicizzazione della codebase

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

Tieni presente che l'indicizzazione della codebase è attivata per impostazione predefinita.

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

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

  • Per aggiornare le impostazioni nell'area di lavoro Firebase Studio:

    1. Fai clic su Icona a forma di ingranaggio Gestisci (in basso a sinistra nell'area di lavoro), quindi scegli Impostazioni oppure premi Ctrl+, (Cmd+, su Mac).

      Se utilizzi App Prototyping agent in Prototyper visualizzazione, fai clic su Icona di un interruttore di codice Passa al codice per aprire la visualizzazione Code.

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

    3. Seleziona Firebase Studio > AI: abilita l'indicizzazione della codebase .

    4. Per disattivare l'indicizzazione del codice, deseleziona AI: abilita l'indicizzazione della codebase. Devi aggiornare le impostazioni di indicizzazione del codice per ciascuna delle tue aree di lavoro.

Personalizzare le istruzioni per Gemini con un file di regole AI

Puoi aggiungere informazioni sul contesto e sul prompt di sistema creando un file di regole AI:

  • Gemini CLI solo utilizza GEMINI.md.
  • Gemini chat dà la priorità a .idx/airules.md, ma utilizzerà GEMINI.md se .idx/airules.md non esiste.

Gemini utilizza le regole come istruzioni di sistema e contesto, personalizzando le risposte per il tuo caso d'uso.

Utilizza il file di regole AI per condividere con Gemini prompt personalizzati, best practice e persino informazioni di contesto importanti sul tuo progetto per raggiungere obiettivi come:

  • Influenzare Gemini's personalità e specializzare la sua competenza.
  • Applicare standard a livello di progetto, come stile di programmazione, convenzioni e preferenze tecnologiche.
  • Ridurre la quantità di informazioni che devi condividere esplicitamente nel codice o nella chat fornendo il contesto essenziale del tuo progetto.

Creare e testare il file di regole AI

Per creare e testare il file di regole AI:

  1. Crea un nuovo file in ~/GEMINI.md (per Gemini CLI) o .idx/airules.md (per la chat Gemini) nella tua area di lavoro Firebase Studio. Puoi utilizzare una delle seguenti opzioni:

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

  2. Aggiungi contenuti al file. Potresti voler aggiungere informazioni sulla personalità che Gemini deve utilizzare (ad esempio "Sei uno sviluppatore esperto e un assistente utile che sa tutto su Next.js"), sugli standard di programmazione e conversazione e sul contesto del progetto. Per un esempio di file di regole AI, consulta l' esempio seguente.

  3. Salva il file e apri Gemini CLI o Gemini.

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

    • Ricrea l'area di lavoro aggiornando la pagina. Dopo la ricreazione, Gemini utilizzerà il file di regole nella chat. Le modifiche al file di regole AI dovrebbero essere applicate immediatamente.
    • Se non vuoi ricreare l'area di lavoro, puoi chiedere a Gemini di load GEMINI.md o load airules.md. Se apporti modifiche a l file durante la sessione corrente, potrebbe essere necessario richiedere nuovamente a Gemini di caricare il file di regole.

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

Esempio

Di seguito è riportato un esempio di base di un file di regole che potresti utilizzare per un casual game 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 nella codebase 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.

Analogamente a 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à AI che operano nell'editor. Un file .aiexclude opera sui file nella directory che lo contiene o nelle relative sottodirectory.

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

  • Assistenza per la chat: Gemini non sarà in grado di rispondere a domande o offrire suggerimenti sui file coperti da .aiexclude.
  • Completamento del codice: i completamenti del codice suggeriti 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 anche 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. È uguale a 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 che contiene il file .aiexclude o nelle relative sottodirectory:

    apikeys.txt

  • Blocca tutti i file con l'estensione .key nella directory che contiene il file .aiexclude o nelle relative sottodirectory:

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

Utilizzare la propria chiave: usare altri Gemini modelli nella chat

Puoi configurare il Gemini modello utilizzato dalla Gemini chat. Puoi scegliere il modello integrato, i modelli configurati nella finestra della chat o qualsiasi Gemini modello a cui hai accesso.

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

Per configurare la chiave e selezionare un modello Gemini diverso:

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

  2. Nella finestra della chat Gemini fai clic su Icona Impostazioni AI Impostazioni AI. Vengono visualizzate le Impostazioni utente.

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

  4. Dal menu a discesa IDX > AI: fornitore del modello, seleziona 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 Gemini modello che vuoi utilizzare in chat dall'elenco in Gemini modelli. Ad esempio, inserisci gemini-3-pro-preview per utilizzare il Gemini 3 Pro modello di anteprima.

  2. Nella finestra della chat Gemini, fai clic sul selettore del modello, quindi scegli ID modello personalizzato. Si aprono le Impostazioni utente.

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

  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.

Personalizza Gemini CLI

  • Impostazioni: crea un file .gemini/settings.json per modificare il tema, attivare o disattivare la raccolta delle statistiche di utilizzo, modificare gli strumenti a cui Gemini CLI ha accesso, configurare la funzionalità di checkpoint e molto altro.
  • Impostazioni: consulta la Gemini CLI documentazione per ulteriori informazioni su come modificare le impostazioni.
  • Variabili di ambiente: Gemini CLI carica automaticamente le variabili di ambiente dal file .env. È qui che devi archiviare la GEMINI_API_KEY (obbligatoria), nonché, facoltativamente, includere il modello Gemini che vuoi utilizzare, l'ID progetto Google Cloud e altro ancora.
  • Istruzioni: per modificare il contesto utilizzato da Gemini CLI quando segue le istruzioni, crea un file GEMINI.md. In questo modo puoi fornire a Gemini istruzioni specifiche del progetto, guide di stile di programmazione o informazioni di background pertinenti, rendendo le risposte più personalizzate e accurate in base alle tue esigenze. Tieni presente che la creazione di questo file fornirà le stesse istruzioni a Gemini, a meno che tu non crei anche un file .idx/airules.md (nel qual caso Gemini CLI utilizzerebbe GEMINI.md e Gemini utilizzerebbe airules.md).

Consulta la Gemini CLI documentazione per ulteriori informazioni su come modificare le impostazioni, le variabili di ambiente e le istruzioni.

Passaggi successivi