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 à mesure que vous saisissez du texte.

  • Assistance par IA avec chat, qui est sensible à l'espace de travail et entièrement intégrée à votre code. Il peut générer, traduire et expliquer du code. 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 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é.

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 :

Utiliser Gemini dans votre espace de travail

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

  1. Utilisez l'assistance par chat ou par code intégré 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 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 :

    • Les suggestions de saisie, qui fournissent une complétion de code intégrée.
    • L'indexation du codebase, 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 :

    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 raccourcis

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 saisie semi-automatique du code

Pour vous aider à écrire du code, Firebase Studio fournit une complétion de code par IA qui prédit et saisit 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 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 Icône en forme de roue dentée 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 Icône de l'interrupteur de code Passer au code pour ouvrir la vue Code.

    2. Sélectionnez l'onglet Workspace (Espace de travail), puis recherchez le paramètre Firebase Studio > AI > Enable Inline Completion (IA > Activer la saisie semi-automatique intégrée).

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

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 du codebase est activée par défaut.

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 Icône en forme de roue dentée 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 Icône de l'interrupteur de code Passer au code pour ouvrir la vue Code.

    2. Sélectionnez l'onglet Workspace (Espace de travail), puis recherchez le paramètre Firebase Studio > AI > Enable Inline Completion (IA > Activer la saisie semi-automatique intégrée).

    3. Sélectionnez Firebase Studio > IA : activer l'indexation de la codebase.

    4. Pour désactiver l'indexation du code, désélectionnez IA : Activer l'indexation du codebase. Vous devez mettre à jour les paramètres d'indexation du code pour chacun de vos espaces 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 :

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 et contexte système, 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, comme le style de programmation, 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'emplacement .idx/airules.md (ou GEMINI.md) dans votre espace de travail Firebase Studio. Vous pouvez utiliser l'une des options suivantes :

    • Dans 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.

  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 de load GEMINI.md ou de 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.

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

Exclure des fichiers de Gemini avec des fichiers .aiexclude

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

À l'instar d'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 fonctionne sur les fichiers situés dans le répertoire qui le contient ou dans l'un de ses sous-répertoires.

Les fichiers couverts par .aiexclude ne seront pas indexés par Gemini lorsque l'indexation du code source 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 ses 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 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/

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

Vous pouvez configurer le modèle Gemini utilisé par Gemini Chat. 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 la section Modèles Gemini.

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, cliquez sur Icône des paramètres de l'IA Paramètres de l'IA. Les paramètres utilisateur s'affichent.

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

  4. Dans le menu déroulant 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 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-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é. 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.

Étapes suivantes