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 con la chat, che è consapevole dello spazio di lavoro e completamente integrata nel 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 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 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 nello spazio di lavoro

Utilizza Gemini per aumentare la produttività della 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 nel tuo spazio di lavoro:

    • Per utilizzare la chat: nello spazio di lavoro aperto, fai clic 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 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 dello spazio 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 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 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 Spazio 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 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 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 Spazio 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 ogni spazio 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 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 .idx/airules.md (o GEMINI.md) nel tuo Firebase Studio spazio di lavoro. 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. Consulta il seguente Esempio per un esempio di file di regole AI.

  3. Salva il file e apri Gemini.

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

    • Ricostruisci lo spazio di lavoro aggiornando la pagina. Dopo la ricostruzione, Gemini utilizzerà il file di regole nella chat. Le modifiche al file di regole AI dovrebbero essere applicate immediatamente.
    • Se non vuoi ricostruire lo spazio 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 chiedere 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.

    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.

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 tra 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. Nello spazio di lavoro aperto, fai clic su spark Gemini nella parte inferiore dello spazio 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 modello Gemini che vuoi utilizzare nella chat dall'elenco dei Gemini modelli. Ad esempio, inserisci gemini-3-pro-preview per utilizzare il Gemini 3 Pro Preview 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 dello spazio di lavoro per aggiornare l'elenco dei modelli.

Passaggi successivi