Configurer Gemini dans Firebase dans les espaces de travail

Firebase Studio facilite vos workflows de développement grâce aux fonctionnalités de code assistées par l'IA suivantes :

• Suggestions de saisie semi-automatique du code à mesure que vous le saisissez.

• Assistance de l'IA par chat ou via l'interface de ligne de commande (CLI), qui est adaptée à l'espace de travail et entièrement intégrée à votre code. Il peut générer, traduire et expliquer du code. Après examen et approbation de votre part, Gemini dans Firebase peut interagir directement avec votre espace de travail pour mettre à jour des fichiers, exécuter des commandes de terminal, interpréter les résultats des commandes et déterminer les prochaines étapes. Pour en savoir plus, consultez Essayer le chat avec Gemini dans Firebase Studio.

• Actions intégrées que vous pouvez effectuer sur des extraits de code sélectionnés. Par exemple, vous pouvez demander à Gemini de rendre le code sélectionné plus lisible.

• Assistance pour le code intégré.

Important : Ce guide décrit la configuration de Gemini dans Firebase au sein des espaces de travail (vue Code). Pour en savoir plus sur Gemini dans Firebase lorsque vous utilisez App Prototyping agent, consultez Premiers pas avec App Prototyping agent.

Vous pouvez personnaliser la façon dont Gemini dans Firebase vous aide en ajustant ses paramètres et en ajoutant des fichiers de règles d'IA :

• Ajustez les paramètres de complétion de code.
• Ajustez les paramètres d'indexation de votre codebase.
• Personnalisez les instructions pour Gemini avec un fichier de règles d'IA.
• Excluez des fichiers de Gemini avec .aiexclude fichiers.
• Utiliser votre propre clé : utiliser d'autres modèles Gemini dans le chat
• Ajustez la façon dont Gemini suggère ou applique les modifications de code.

Important : Gemini dans Firebase peut générer des résultats qui semblent plausibles, mais qui sont en fait incorrects. Il peut fournir des réponses inexactes qui ne représentent pas les points de vue de Google. Validez tous les résultats de Gemini avant de les utiliser et n'utilisez pas en production du code généré que vous n'avez pas testé. Ne saisissez pas d'informations permettant d'identifier personnellement l'utilisateur ni de données utilisateur dans le chat.

Utiliser Gemini dans Firebase dans votre espace de travail

Utilisez Gemini dans Firebase pour améliorer votre productivité en matière de codage grâce au panneau de chat, au terminal ou à l'assistance dans le code.

Remarque : Si vous utilisez App Prototyping agent dans Prototyper view, click Switch to Code to open Code view.

1. Utilisez l'assistance au codage par chat ou intégrée dans votre espace de travail :

   • Pour utiliser le chat : dans l'espace de travail ouvert, cliquez sur spark Gemini en bas de l'espace de travail.

   • Pour utiliser Gemini CLI : ouvrez le terminal et saisissez gemini pour l'interface Gemini CLI, ou utilisez la commande gemini -p pour utiliser Gemini CLI en mode non interactif.

   • Pour utiliser l'assistance au code intégrée, commencez à saisir votre code et appuyez sur Tab pour accepter les suggestions.

2. Notez que les deux options suivantes sont activées par défaut :

   • Suggestions lors de la saisie, qui fournit la complétion de code intégrée.
   • L'indexation de la base de code, qui permet une meilleure personnalisation et des réponses plus utiles.

   Pour modifier ces sélections pour les paramètres de votre espace de travail à l'avenir :

   • Pour modifier les paramètres de complétion de code, consultez Ajuster vos paramètres de complétion de code.
   • Pour modifier les paramètres d'indexation du code, consultez Ajuster vos paramètres d'indexation du code.

   Vous pouvez également exclure des fichiers et des répertoires spécifiques de l'indexation par l'IA. Consultez Exclure des fichiers de Gemini avec des fichiers .aiexclude.

Raccourcis Gemini dans Firebase

Pour ouvrir rapidement une discussion avec Gemini, appuyez sur Ctrl+Shift+Space (ou Cmd+Shift+Space sur macOS).

Pour afficher les commandes Gemini depuis la palette de commandes :

1. Ouvrez la palette de commandes en appuyant sur Ctrl+Shift+P (ou Cmd+Shift+P sur macOS).

2. Recherchez Gemini.

   Une liste de commandes Gemini s'affiche.

Ajuster vos paramètres de complétion de code

Pour vous aider à écrire du code, Firebase Studio fournit une fonctionnalité de saisie semi-automatique de code par IA qui prédit et remplit automatiquement le code dans n'importe quel fichier ouvert dès que vous commencez à taper.

Notez que la complétion de code est activée par défaut.

Pour activer ou désactiver la saisie semi-automatique de code, ajustez vos paramètres de saisie semi-automatique de code à l'aide de l'une des méthodes suivantes :

• Si vous utilisez un fichier settings.json, définissez "IDX.aI.enableInlineCompletion" sur true ou false.

• Pour modifier les paramètres dans l'espace de travail Firebase Studio :

  1. Cliquez sur Gérer (en bas à gauche de l'espace de travail), puis sélectionnez Paramètres ou appuyez sur Ctrl+, (Cmd+, sur Mac).

     Si vous utilisez App Prototyping agent dans Prototyper view, click Switch to Code to open Code view.

  2. Sélectionnez l'onglet Espace de travail, puis recherchez le paramètre Firebase Studio > IA > Activer la saisie semi-automatique.

  3. Pour désactiver la saisie semi-automatique du code, désélectionnez l'option Activer la saisie semi-automatique du code intégré à mesure que vous le saisissez.

Conseil : Pour conserver ce paramètre dans tous vos espaces de travail, configurez-le dans l'onglet Utilisateur. Vous vous assurez ainsi que vos paramètres sont appliqués à tous les espaces de travail auxquels vous accédez avec votre compte utilisateur. Si vous partagez votre espace de travail, vous devrez quand même configurer le paramètre de l'espace de travail.

Ajuster les paramètres d'indexation de votre codebase

Vous pouvez contrôler si Gemini indexe votre code. L'indexation de votre code permet d'obtenir des résultats plus utiles lorsque vous utilisez l'assistance d'IA par chat ou intégrée.

Notez que l'indexation de la codebase est activée par défaut.

Remarque : Vous pouvez contrôler les fichiers que Gemini dans Firebase indexe. Pour en savoir plus, consultez Exclure des fichiers de Gemini avec des fichiers .aiexclude.

Pour activer ou désactiver l'indexation du code, ajustez les paramètres d'indexation de votre codebase à l'aide de l'une des méthodes suivantes :

• Si vous utilisez un fichier settings.json, définissez "IDX.aI.enableCodebaseIndexing" sur true ou false.

• Pour modifier les paramètres dans l'espace de travail Firebase Studio :

  1. Cliquez sur Gérer (en bas à gauche de l'espace de travail), puis sélectionnez "Paramètres" ou appuyez sur Ctrl+, (Cmd+, sur Mac).

     Si vous utilisez App Prototyping agent dans Prototyper view, click Switch to Code to open Code view.

  2. Sélectionnez l'onglet Workspace, puis recherchez le paramètre Firebase Studio > IA > Activer la saisie semi-automatique.

  3. Sélectionnez Firebase Studio > IA : activer l'indexation du code source.

  4. Pour désactiver l'indexation du code, désélectionnez IA : Activer l'indexation de la codebase. Vous devez mettre à jour les paramètres d'indexation du code pour chacun de vos espaces de travail.

Conseil : Pour conserver ce paramètre dans tous vos espaces de travail, configurez-le dans l'onglet Utilisateur. Vous vous assurez ainsi que vos paramètres sont appliqués à tous les espaces de travail auxquels vous accédez avec votre compte utilisateur. Si vous partagez votre espace de travail, vous devrez quand même configurer le paramètre de l'espace de travail.

Personnaliser les instructions pour Gemini avec un fichier de règles d'IA

Vous pouvez ajouter des informations sur le contexte et l'invite système en créant un fichier de règles d'IA :

• Gemini CLI uniquement utilise GEMINI.md.
• Gemini dans Firebase privilégie .idx/airules.md, mais utilisera GEMINI.md si .idx/airules.md n'existe pas.

Gemini dans Firebase utilise vos règles comme instructions système et contexte, ce qui lui permet de personnaliser ses réponses pour votre cas d'utilisation.

Utilisez le fichier de règles d'IA pour partager des requêtes personnalisées, des bonnes pratiques et même des informations contextuelles importantes sur votre projet avec Gemini afin d'atteindre des objectifs tels que :

• Influencer le persona de Gemini et spécialiser son expertise.
• Appliquer des normes à l'échelle du projet, comme le style de codage, les conventions et les préférences technologiques.
• Réduisez la quantité d'informations que vous devez partager explicitement dans le code ou le chat en fournissant le contexte essentiel de votre projet.

Créer et tester votre fichier de règles d'IA

Pour créer et tester votre fichier de règles d'IA :

1. Créez un fichier à l'adresse ~/GEMINI.md (pour Gemini CLI) ou .idx/airules.md (pour Gemini dans le chat Firebase) dans votre espace de travail Firebase Studio. Vous pouvez utiliser l'une des options suivantes :

   • Dans l'explorateur (Ctrl+Shift+E), effectuez un clic droit sur le répertoire parent, puis sélectionnez Nouveau fichier. Nommez le fichier, puis appuyez sur Entrée.
   • Dans le terminal, utilisez l'éditeur de texte de votre choix pour ouvrir GEMINI.md ou .idx/airules.md.

2. Ajoutez du contenu au fichier. Vous pouvez ajouter des informations sur la personnalité que Gemini doit utiliser (par exemple, "Vous êtes un développeur expert et un assistant utile qui connaît tout sur Next.js"), les normes de codage et de conversation, ainsi que le contexte du projet. Consultez l'exemple suivant pour obtenir un exemple de fichier de règles d'IA.

3. Enregistrez le fichier et ouvrez Gemini CLI ou Gemini dans Firebase.

4. Pour commencer à utiliser vos règles d'IA, vous pouvez effectuer l'une des opérations suivantes :

   • Reconstruisez l'espace de travail en actualisant la page. Après avoir reconstruit, Gemini utilisera le fichier de règles dans Chat. Les modifications apportées au fichier de règles d'IA doivent être répercutées immédiatement.
   • Si vous ne souhaitez pas recréer votre espace de travail, vous pouvez demander à Gemini d'load GEMINI.md ou d'load airules.md. Si vous modifiez le fichier au cours de la session actuelle, vous devrez peut-être relancer Gemini pour charger à nouveau le fichier de règles.

5. poser des questions sur votre code ; Gemini répond en utilisant les informations que vous avez incluses dans le fichier de règles comme contexte.

Conseil : Si vous avez développé des fichiers de règles pour d'autres IDE compatibles avec l'IA, vous pouvez les copier directement dans votre fichier de règles Gemini. Alors que Gemini CLI n'utilise que GEMINI.md comme fichier de règles, Gemini dans Firebase utilisera (par ordre de priorité) .idx/airules.md, GEMINI.md, .gemini/styleguide.md, AGENTS.md ou cursorrules.

Exemple

Voici un exemple de base de fichier de règles que vous pouvez utiliser pour un jeu occasionnel développé avec 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.

Conseil : Les règles d'IA contribuent à la taille globale du contexte. Nous vous recommandons donc de limiter la taille de votre fichier de règles d'IA pour garantir les meilleures performances du modèle.

Exclure des fichiers de Gemini avec .aiexclude fichiers

Vous pouvez contrôler les fichiers de votre code source qui doivent rester masqués dans Gemini en incluant des fichiers .aiexclude dans votre projet. Cela vous permet de contrôler de manière précise le contexte du projet que vous partagez avec Gemini.

À l'instar d'un fichier .gitignore, un fichier .aiexclude permet de suivre les fichiers qui ne doivent pas être partagés avec Gemini, y compris l'expérience de chat ainsi que les fonctionnalités d'IA qui fonctionnent dans l'éditeur. Un fichier .aiexclude fonctionne sur les fichiers situés dans le répertoire qui le contient ou dans un sous-répertoire.

Remarque : Les fichiers ignorés par les fichiers .gitignore de votre dépôt sont automatiquement exclus, même s'ils ne sont pas listés dans un fichier .aiexclude.

Les fichiers couverts par .aiexclude ne seront pas indexés par Gemini lorsque l'indexation de la base de code est activée. De plus, .aiexclude affectera l'assistance intégrée pour les fichiers couverts de la manière suivante :

• Assistance par chat : Gemini ne pourra pas répondre aux questions ni faire de suggestions concernant les fichiers couverts par .aiexclude.
• Saisie de code : les suggestions de saisie de code ne seront pas disponibles lorsque vous modifierez des fichiers couverts.
• Assistance intégrée : vous pourrez générer du code, mais pas modifier le code existant lorsque vous modifierez des fichiers couverts.

D'autres environnements de développement, tels qu'Android Studio, peuvent également respecter les fichiers .aiexclude.

Écrire des fichiers .aiexclude

Un fichier .aiexclude suit la même syntaxe qu'un fichier .gitignore, avec les différences suivantes :

• Un fichier .aiexclude vide bloque tous les fichiers de son répertoire et de tous les sous-répertoires. Cela revient à utiliser un fichier contenant **/*.
• Les fichiers .aiexclude ne sont pas compatibles avec la négation (préfixe !).

Exemples

Voici quelques exemples de configurations de fichier .aiexclude :

• Bloquez tous les fichiers nommés apikeys.txt dans le répertoire contenant le fichier .aiexclude ou dans un sous-répertoire :

  apikeys.txt
  

• Bloquez tous les fichiers portant l'extension .key dans le répertoire contenant le fichier .aiexclude ou dans l'un de ses sous-répertoires :

  *.key
  

• Bloquez uniquement le fichier apikeys.txt dans le même répertoire que .aiexclude, mais pas les sous-répertoires :

  /apikeys.txt
  

• Bloquez tous les fichiers du répertoire my/sensitive/dir et de tous ses sous-répertoires. Le chemin d'accès doit être relatif au répertoire contenant le fichier .aiexclude :

  my/sensitive/dir/
  

Utiliser votre propre clé : utiliser d'autres modèles Gemini dans le chat

Expérimental : cette fonctionnalité est expérimentale.

Vous pouvez configurer le modèle Gemini utilisé par Gemini dans Firebase. Vous pouvez choisir le modèle intégré, les modèles configurés dans la fenêtre de chat (y compris les modèles Gemini 2.5) ou tout modèle Gemini auquel vous avez accès.

Pour obtenir la liste de tous les modèles disponibles, consultez la section Modèles Gemini.

Important : Les paramètres d'IA Firebase Studio sont des paramètres utilisateur. Cela signifie qu'ils resteront configurés pour vous sur plusieurs postes de travail.

Pour configurer votre clé et sélectionner un autre modèle Gemini :

1. Dans l'espace de travail ouvert, cliquez sur spark Gemini en bas de l'espace de travail (ou sur l'onglet Gemini).

2. Dans la fenêtre de chat Gemini dans Firebase, cliquez sur le menu déroulant du nom du modèle, puis sur le lien touche Gemini API. Les paramètres utilisateur s'affichent.

3. Dans le champ IDX > AI : clé API Gemini, saisissez votre clé Gemini API.

   Remarque : Ce champ peut déjà être renseigné si vous avez utilisé App Prototyping agent et qu'il a créé un projet Firebase et une clé Gemini API pour vous.

Vous pouvez désormais sélectionner l'un des modèles Gemini préconfigurés dans le chat.

Pour configurer un modèle Gemini qui ne figure pas dans le menu déroulant :

1. Identifiez le modèle Gemini que vous souhaitez utiliser dans le chat à partir de la liste des modèles Gemini. Par exemple, saisissez gemini-2.0-flash-lite pour utiliser le dernier modèle Gemini 2.0 Flash‑Lite stable.

2. Dans la fenêtre de chat Gemini dans Firebase, cliquez sur le sélecteur de modèle, puis sélectionnez ID de modèle personnalisé. Les paramètres utilisateur s'ouvrent.

3. Copiez le nom du modèle que vous avez sélectionné dans le champ IDX > IA : modèle Gemini.

4. Fermez la fenêtre de chat, puis rouvrez-la en cliquant sur spark Gemini en bas de l'espace de travail pour actualiser la liste des modèles.

Personnaliser Gemini CLI

• Paramètres : créez un fichier .gemini/settings.json pour modifier le thème, activer ou désactiver la collecte de statistiques d'utilisation, ajuster les outils auxquels Gemini CLI a accès, configurer la fonctionnalité de point de contrôle et bien plus encore.
• Paramètres : consultez la documentation Gemini CLI pour savoir comment ajuster les paramètres.
• Variables d'environnement : Gemini CLI charge automatiquement les variables d'environnement à partir du fichier .env. C'est là que vous devez stocker votre GEMINI_API_KEY (obligatoire), ainsi que, éventuellement, inclure le modèle Gemini que vous souhaitez utiliser, l'ID de votre projet Google Cloud, et plus encore.
• Instructions : pour ajuster le contexte utilisé par Gemini CLI lorsqu'il suit des instructions, créez un fichier GEMINI.md. Vous pouvez ainsi fournir à Gemini des instructions spécifiques à un projet, des guides de style de programmation ou des informations contextuelles pertinentes, ce qui lui permet de générer des réponses plus adaptées et plus précises à vos besoins. Notez que la création de ce fichier fournira les mêmes instructions à Gemini dans Firebase, sauf si vous créez également un fichier .idx/airules.md (auquel cas Gemini CLI utilisera GEMINI.md et Gemini dans Firebase utilisera airules.md).

Consultez la documentation Gemini CLI pour savoir comment ajuster les paramètres, les variables d'environnement et les instructions.

Étapes suivantes

• Essayez Gemini dans Firebase.