Configurer Gemini 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 complétion de code au fur et à mesure que vous tapez.

• L'assistance IA avec chat, qui est compatible avec l'espace de travail et entièrement intégrée à votre code. Il peut générer, traduire et expliquer du code. De plus, avec votre examen et votre approbation, Gemini peut interagir directement avec votre espace de travail pour mettre à jour des fichiers, exécuter des commandes de terminal, interpréter le résultat de la commande et déterminer les étapes suivantes. Pour en savoir plus, consultez Essayer de discuter avec Gemini dans Firebase Studio.

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

• Assistance au codage intégrée.

Important : Ce guide décrit le chat interactif Gemini par défaut. Les applications créées avec App Prototyping agent utilisent par défaut le chat Prototyper dans la vue Code. Pour utiliser le chat interactif Gemini, sous Gemini, cliquez sur +, puis sélectionnez Nouveau chat. Pour revenir au chat Prototyper, cliquez sur Chats récents, puis sélectionnez Chat Prototyper. Pour en savoir plus sur le chat Prototyper, consultez Premiers pas avec App Prototyping agent.

Vous pouvez personnaliser la façon dont Gemini 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.
• Personnaliser les instructions pour Gemini avec un fichier de règles d'IA
• Exclure des fichiers de Gemini avec des fichiers .aiexclude.
• Utiliser votre propre clé : utiliser d'autres modèles Gemini dans Chat
• Ajustez la façon dont Gemini suggère ou applique les modifications de code.

Important : Gemini 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 de code généré non testé en production. Ne saisissez pas d'informations permettant d'identifier personnellement l'utilisateur ni de données utilisateur dans le chat.

Utiliser Gemini dans votre espace de travail

Utilisez Gemini pour booster votre productivité en codage grâce au panneau de chat, au terminal ou à l'assistance au code intégré.

Remarque : Si vous utilisez App Prototyping agent dans la vue Prototyper, cliquez sur Passer au code pour ouvrir la vue Code.

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

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

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

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

   • Suggestions pendant la saisie, qui fournit une complétion de code intégrée.
   • Indexation du codebase, qui offre 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 les paramètres de complétion de code.
   • Pour mettre à jour les paramètres d'indexation du code, consultez Ajuster les 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.

Gemini raccourci

Pour ouvrir rapidement un chat avec Gemini, appuyez sur Ctrl+Shift+Space (ou Cmd+Shift+Space sous macOS).

Pour afficher les commandes Gemini à partir de la palette de commandes :

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

2. Recherchez Gemini.

   Une liste de commandes Gemini s'affiche.

Ajuster les paramètres de complétion de code

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

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

Pour activer ou désactiver la complétion de code, ajustez vos paramètres de complétion 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 la vue Prototyper, cliquez sur Passer au code pour ouvrir la vue Code.

  2. Sélectionnez l'onglet Workspace, puis recherchez le paramètre Firebase Studio > AI > Enable Inline Completion ( > IA > Activer l'autocomplétion).

  3. Pour désactiver la complétion de code, désélectionnez l'option Activer la complétion de code intégrée pendant la saisie.

Conseil : Pour conserver ce paramètre dans tous vos espaces de travail, configurez-le dans l'onglet Utilisateur. Cela garantit 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 "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 fournit des résultats plus utiles lorsque vous utilisez l'assistance IA par chat ou intégrée.

Sachez que l'indexation du codebase est activée par défaut.

Remarque : Vous pouvez contrôler les fichiers indexés par Gemini. 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 de 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 la vue Prototyper, cliquez sur Passer au code pour ouvrir la vue Code.

  2. Sélectionnez l'onglet Workspace, puis recherchez le paramètre Firebase Studio > AI > Enable Inline Completion ( > IA > Activer l'autocomplétion).

  3. Sélectionnez Firebase Studio > AI: Enable Codebase Indexing (IA : activer l'indexation de la codebase).

  4. Pour désactiver l'indexation du code, désélectionnez AI: Enable Codebase Indexing (IA : activer l'indexation du 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. Cela garantit 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 "Espace de travail".

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

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

Le chat Gemini donne la priorité à .idx/airules.md, mais utilise GEMINI.md si .idx/airules.md n'existe pas.

Gemini utilise vos règles comme instructions système et contexte, en personnalisant 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, telles que le style de codage, les conventions et les préférences technologiques.
• Réduire la quantité d'informations que vous devez partager explicitement dans le code ou le chat en fournissant un contexte essentiel sur 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 dans .idx/airules.md (ou GEMINI.md) 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. Attribuez un nom au 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 texte au fichier. Vous pouvez ajouter des informations sur le persona que Gemini doit utiliser (par exemple, "Vous êtes un développeur expert et un assistant utile qui sait tout sur Next.js"), les normes de codage et de conversation, et 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.

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 la recompilation, Gemini utilisera le fichier de règles dans Chat. Les modifications apportées au fichier de règles d'IA devraient être prises en compte immédiatement.
   • Si vous ne souhaitez pas recompiler votre espace de travail, vous pouvez demander à Gemini de load GEMINI.md ou load airules.md. Si vous modifiez le fichier au cours de la session actuelle, vous devrez peut-être demander à nouveau à Gemini de charger 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.

   Gemini 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 grand public 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 des performances optimales du modèle.

Exclure des fichiers de Gemini avec des fichiers .aiexclude

Vous pouvez contrôler les fichiers de votre codebase qui doivent être masqués pour Gemini en incluant des fichiers .aiexclude dans votre projet. Vous pouvez ainsi contrôler précisément le contexte du projet que vous partagez avec Gemini.

Tout comme un fichier .gitignore, un fichier .aiexclude suit 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 agit sur les fichiers du répertoire qui le contient ou de l'un de ses sous-répertoires.

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 codebase 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 proposer de suggestions concernant les fichiers couverts par .aiexclude.
• Saisie semi-automatique du code : les suggestions de saisie semi-automatique du code ne seront pas disponibles lors de la modification 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.

Comment é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 ses sous-répertoires. Cela équivaut à un fichier contenant **/*.
• Les fichiers .aiexclude ne sont pas compatibles avec la négation (préfixer les modèles avec !).

Exemples

Voici quelques exemples de configurations de fichiers .aiexclude :

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

  apikeys.txt
  

• Bloquez tous les fichiers portant l'extension de fichier .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 le fichier .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 spécifié par rapport au dossier dans lequel se trouve le fichier .aiexclude :

  my/sensitive/dir/
  

Apportez votre propre clé : utilisez d'autres modèles Gemini dans le chat

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

Vous pouvez configurer le modèle Gemini utilisé par le chat Gemini. Vous pouvez choisir le modèle intégré, les modèles configurés dans la fenêtre de chat ou n'importe quel modèle Gemini auquel vous avez accès.

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

Important : Les paramètres d'IA de 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 votre 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, cliquez sur Paramètres de l'IA. Paramètres utilisateur s'affiche.

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

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

4. Dans le menu déroulant IDX > AI: Model Provider (IDX > IA : fournisseur de modèle), sélectionnez Gemini API.

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 la liste déroulante :

1. Identifiez le modèle Gemini que vous souhaitez utiliser dans le chat dans la liste des modèles Gemini. Par exemple, vous devez saisir gemini-3-pro-preview pour utiliser le modèle d'aperçu Gemini 3 Pro Preview.

2. Dans la fenêtre de chat Gemini, cliquez sur le sélecteur de modèle, puis sélectionnez ID de modèle personnalisé. Paramètres utilisateur s'ouvre.

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

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

Étapes suivantes

• Essayez Gemini.