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 complétion de code à mesure que vous le saisissez.

  • Assistance IA avec le 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. Après examen et approbation, Gemini dans Firebase peut interagir directement avec votre espace de travail pour mettre à jour des fichiers, exécuter des commandes de terminal, interpréter la sortie des commandes et déterminer les prochaines étapes. Pour en savoir plus, consultez Essayez le chat avec Gemini.

  • Actions intégrées que vous pouvez effectuer sur des éléments 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 l'aide de Gemini dans Firebase en ajustant ses paramètres et en ajoutant des fichiers de règles d'IA:

Utiliser Gemini dans Firebase dans votre espace de travail

Utilisez Gemini dans Firebase pour accroître votre productivité en codage grâce à l'assistance du panneau de chat ou du code intégré.

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

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

    • Pour utiliser l'assistance de code 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 lors de la saisie, qui fournit la complétion de code en ligne.
    • 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:

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

Gemini dans les raccourcis Firebase

Pour ouvrir rapidement le 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 basée sur l'IA qui prédit et remplit automatiquement le code dans n'importe quel fichier ouvert dès que vous commencez à taper.

Notez que la saisie semi-automatique du code est activée par défaut.

Pour activer ou désactiver la saisie semi-automatique du code, ajustez ses paramètres à 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 mettre à jour 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 Prototyper view, click Code switch icon Switch to Code to open Code view.

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

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

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 par chat ou par IA 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 mettre à jour 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 Prototyper view, click Code switch icon Switch to Code to open Code view.

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

    3. Sélectionnez Firebase Studio > IA: activer l'indexation du 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 dans Firebase avec un fichier de règles d'IA

Vous pouvez ajouter des informations sur le contexte et les requêtes système en créant un fichier de règles d'IA (.idx/airules.md). Gemini dans Firebase utilise vos règles comme instructions système et contexte, ce qui garantit que ses réponses sont personnalisées pour votre cas d'utilisation.

Utilisez le fichier de règles d'IA pour partager avec Gemini des invites personnalisées, des bonnes pratiques et même un contexte important sur votre projet 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éduire la quantité d'informations que vous devez partager explicitement dans le code ou la discussion en fournissant le contexte essentiel de votre projet.

Les règles que vous configurez sont utilisées par Gemini dans la discussion.

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 dans votre espace de travail Firebase Studio (dans le même répertoire que votre fichier dev.nix). Vous pouvez utiliser l'une des options suivantes:

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

  2. Ajoutez du texte au fichier. Vous pouvez ajouter des informations sur le persona Gemini qui doit utiliser (par exemple, "Vous êtes un développeur expert et un assistant serviable qui sait 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, puis ouvrez Gemini dans Firebase.

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

    • Recréez l'espace de travail en actualisant la page. Une fois la recompilation effectuée, Gemini dans Firebase 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 dans le chat.
    • Si vous ne souhaitez pas reconstruire votre espace de travail, vous pouvez demander à Gemini de le faire à l'aide de Chat.load airules.md Si vous modifiez le fichier pendant la session en cours, vous devrez peut-être demander à Gemini de charger à nouveau le fichier de règles.

  5. Posez des questions sur votre code. Gemini répond à l'aide des informations que vous avez incluses dans le fichier de règles en tant que contexte.

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 codebase qui doivent être masqués pour Gemini en incluant des fichiers .aiexclude dans votre projet. Vous pouvez ainsi contrôler de manière précise 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 et les fonctionnalités d'IA qui fonctionnent dans l'éditeur. Un fichier .aiexclude fonctionne sur les fichiers situés au niveau du répertoire qui le contient ou en dessous.

Les fichiers couverts par .aiexclude ne seront pas indexés par Gemini lorsque l'indexation du codebase est activée. De plus, .aiexclude affectera l'assistance intégrée pour les fichiers couverts comme suit:

  • Assistance par chat: Gemini ne pourra pas répondre aux questions ni suggérer de solutions concernant les fichiers couverts par .aiexclude.
  • Complétion du code: les suggestions de complétion du code ne sont pas disponibles lorsque vous modifiez des fichiers couverts.
  • Assistance intégrée: vous pouvez générer du code, mais pas modifier le code existant lorsque vous modifiez 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. Il s'agit de la même chose qu'un fichier contenant **/*.
  • Les fichiers .aiexclude ne sont pas compatibles avec la négation (préfixer les modèles par !).

Exemples

Voici quelques exemples de configurations de fichiers .aiexclude:

  • Bloquez tous les fichiers nommés apikeys.txt au niveau ou en dessous du répertoire contenant le fichier .aiexclude:

    apikeys.txt

  • Bloquez tous les fichiers portant l'extension de fichier .key au niveau ou en dessous du répertoire contenant le fichier .aiexclude:

    *.key

  • Ne bloquez que 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 tous ses sous-répertoires. Le chemin d'accès doit être relatif au répertoire contenant le fichier .aiexclude:

    my/sensitive/dir/

Utiliser vos propres clés: utiliser d'autres modèles Gemini dans Chat

Vous pouvez configurer le modèle Gemini utilisé par Gemini dans le chat 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 les modèles Gemini.

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

  1. Dans votre espace de travail ouvert, cliquez sur l'icône étincelle Gemini en bas de l'espace de travail (ou dans 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 de la clé Gemini API. La page Paramètres utilisateur s'affiche.

  3. Dans le champ IDX > AI: Clé API Gemini, saisissez votre clé 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 dans la liste des modèles Gemini. Par exemple, vous devez saisir gemini-2.0-flash-lite pour utiliser la dernière version stable du modèle Gemini 2.0 Flash‑Lite.

  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é. La page 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 étincelle Gemini en bas de l'espace de travail pour actualiser la liste des modèles.

Étapes suivantes