Configurare Gemini all'interno degli spazi di lavoro

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

  • Completamento del codice suggerito durante la digitazione.

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

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

  • Assistenza al coding in linea.

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

Utilizza Gemini nel tuo workspace

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

  1. Utilizza l'assistenza al coding in chat o in linea nel tuo workspace:

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

    • Per utilizzare l'assistenza al coding 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 in linea.
    • Indicizzazione del codebase, che offre una migliore personalizzazione e risposte più utili.

    Per modificare queste selezioni per le impostazioni del tuo workspace in futuro:

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

Gemini di 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 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.

Regola 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 nel workspace Firebase Studio:

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

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

    2. Seleziona la scheda Workspace, quindi cerca l'impostazione Firebase Studio > AI > Enable Inline Completion.

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

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

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 nel workspace Firebase Studio:

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

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

    2. Seleziona la scheda Workspace, quindi cerca l'impostazione Firebase Studio > AI > Completamento inline.

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

    4. Per disattivare l'indicizzazione del codice, deseleziona AI: Enable Codebase Indexing (AI: attiva l'indicizzazione del codebase). Devi aggiornare le impostazioni di indicizzazione del codice per ciascuno dei tuoi workspace.

Personalizza 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:

La chat di Gemini dà la priorità a .idx/airules.md, ma utilizzerà GEMINI.md se .idx/airules.md non esiste.

Gemini utilizza le tue regole come istruzioni di sistema e contesto, personalizzando le risposte in base al tuo caso d'uso.

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

  • Influenzare la personalità di Gemini e specializzare le sue competenze.
  • Applicazione di 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 un contesto essenziale sul tuo progetto.

Crea e testa il file delle regole AI

Per creare e testare il file delle regole AI:

  1. Crea un nuovo file in .idx/airules.md (o GEMINI.md) nel tuo workspace Firebase Studio. Puoi utilizzare una delle seguenti opzioni:

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

  3. Salva il file e apri Gemini.

  4. Per iniziare a utilizzare le regole AI, puoi eseguire una delle seguenti operazioni:

    • Ricostruisci l'area di lavoro aggiornando la pagina. Dopo la ricostruzione, Gemini utilizzerà il file delle regole all'interno della chat. Le modifiche al file delle regole AI dovrebbero essere applicate immediatamente.
    • Se non vuoi ricreare il tuo workspace, puoi chiedere a Gemini di load GEMINI.md o load airules.md. Se apporti modifiche al file durante la sessione corrente, potresti dover chiedere nuovamente a Gemini di caricare il file delle regole.

  5. Fai domande sul tuo codice. Gemini risponde utilizzando come contesto le informazioni incluse nel file delle regole.

    Gemini utilizzerà (in ordine di precedenza) .idx/airules.md, GEMINI.md, .gemini/styleguide.md, AGENTS.md o cursorrules.

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.

Escludi i file da Gemini con .aiexclude file

Puoi controllare quali file del tuo codebase 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.

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à di AI che operano nell'editor. Un file .aiexclude opera sui file che si trovano nella directory che lo contiene o in una directory di livello inferiore.

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

  • Assistenza in Chat: Gemini non potrà rispondere alle 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 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 sua directory e in tutte le sottodirectory. Equivale a un file che contiene **/*.
  • I file .aiexclude non supportano la negazione (pattern con prefisso !).

Esempi

Ecco alcuni esempi di configurazioni di file .aiexclude:

  • Blocca tutti i file denominati apikeys.txt nella directory che contiene il file .aiexclude o in una directory inferiore:

    apikeys.txt

  • Blocca tutti i file con l'estensione del file .key nella directory che contiene il file .aiexclude o in una directory 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/

Bring Your Own Key: utilizza altri modelli Gemini nella chat

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

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

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 sulla scheda Gemini).

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

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

  4. Dal menu a discesa IDX > AI: Model Provider, seleziona Gemini API.

Ora puoi selezionare uno dei modelli Gemini preconfigurati nella chat.

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

  1. Identifica il modello Gemini che vuoi utilizzare nella chat dall'elenco dei modelli Gemini. Ad esempio, inserisci gemini-3-pro-preview per utilizzare il modello di anteprima Gemini 3 Pro Preview.

  2. Nella finestra di chat di Gemini, fai clic sul selettore del modello, quindi scegli ID modello personalizzato. Si apre la pagina Impostazioni utente.

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

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

Passaggi successivi