Configurer Gemini dans les espaces de travail

Firebase Studio facilite vos workflows de développement grâce aux fonctionnalités d'assistance au codage par l'IA suivantes :

  • Suggestions de complétion de code à mesure que vous saisissez du texte.

  • Assistance de l'IA par chat ou via l'interface de ligne de commande (CLI), qui est compatible avec l'espace de travail et entièrement intégrée à votre code. Elle 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 la sortie de commandes, et déterminer les étapes suivantes. 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ée.

Vous pouvez personnaliser l'aide de Gemini 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 via le panneau de chat, terminal, ou l'assistance pour le code intégré.

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

    • Pour utiliser le chat : dans votre espace de travail ouvert, cliquez sur l'icône d'étincelle 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 pour le 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 à mesure que vous saisissez du texte, 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 :

    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 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 vos paramètres de complétion de code

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

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 le App Prototyping agent dans Prototyper vue, cliquez sur Icône de l'interrupteur de code Passer au code pour ouvrir la vue Code.

    2. Sélectionnez l'onglet Espace de travail, puis recherchez le paramètre Firebase Studio > IA > Activer la complétion intégrée .

    3. Pour désactiver la complétion de code, désélectionnez l'option Activer la complétion de code intégrée à mesure que vous saisissez du texte.

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 le chat ou l'assistance par l'IA intégrée.

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

Pour activer ou désactiver l'indexation de code, ajustez vos paramètres d'indexation de 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 le App Prototyping agent dans Prototyper vue, cliquez sur Icône de l'interrupteur de code Passer au code pour ouvrir la vue Code.

    2. Sélectionnez l'onglet Espace de travail, puis recherchez le paramètre Firebase Studio > IA > Activer la complétion intégrée.

    3. Sélectionnez Firebase Studio > IA : Activer l'indexation du codebase .

    4. Pour désactiver l'indexation de code, désélectionnez IA : Activer l'indexation du codebase. Vous devez modifier les paramètres d'indexation de 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 contextuelles et des requêtes système en créant un fichier de règles d'IA :

  • Gemini CLI n'utilise que uses GEMINI.md.
  • 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 un contexte important sur votre projet avec Gemini afin d'atteindre des objectifs tels que :

  • Influencer Gemini's personnalité et spécialiser son expertise.
  • Appliquer des normes à l'ensemble 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 ~/GEMINI.md (pour Gemini CLI) ou .idx/airules.md (pour le chat Gemini) dans votre Firebase Studio espace de travail. Vous pouvez utiliser l'une des options suivantes :

    • Dans Explorateur (Ctrl+Shift+E), effectuez un clic droit sur le répertoire parent et sélectionnez Nouveau fichier. Nommez le fichier et appuyez sur Entrée.
    • À partir du 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 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.

  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 recréation effectuée, Gemini utilisera le fichier de règles dans le chat. Les modifications apportées au fichier de règles d'IA doivent être reflétées immédiatement.
    • Si vous ne souhaitez pas recréer votre espace de travail, vous pouvez demander à Gemini de load GEMINI.md ou load airules.md. Si vous modifiez le fichier pendant la session en cours, vous devrez peut-être demander à nouveau à Gemini de charger le fichier de règles.

  5. Posez des questions sur votre code. Gemini répond en utilisant les informations que vous avez incluses dans le fichier de règles comme 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 dans 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.

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 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 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.
  • Complétion de code : les suggestions de complétion de code ne seront pas disponibles lors de la modification des fichiers couverts.
  • Assistance intégrée : vous pourrez générer du nouveau code, mais pas modifier le code existant lors de la modification des fichiers couverts.

D'autres environnements de développement tels que 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 à 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/

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

Vous pouvez configurer le Gemini modèle utilisé par le 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 Gemini modèle auquel vous avez accès.

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

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

  1. Dans votre espace de travail ouvert, cliquez sur l'icône d'étincelle 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 d'IA. Les paramètres utilisateur s'affichent.

  3. Dans le champ IDX > IA : 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 maintenant 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 Gemini modèles. Par exemple, saisissez gemini-3-pro-preview pour utiliser le Gemini 3 Pro modèle d'aperçu.

  2. Dans la fenêtre de chat Gemini , cliquez sur le sélecteur de modèle, puis choisissez 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 l'icône d'étincelle 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 en savoir plus sur la modification des 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 lors du suivi des instructions, créez un fichier GEMINI.md. Cela vous permet de fournir à Gemini des instructions spécifiques au projet, des guides de style de codage ou des informations contextuelles pertinentes . Les réponses de Gemini sont ainsi plus adaptées et plus précises . Notez que la création de ce fichier fournira les mêmes instructions à Gemini, sauf si vous créez également un fichier .idx/airules.md (auquel cas Gemini CLI utiliserait GEMINI.md et Gemini utiliserait airules.md).

Consultez la Gemini CLI documentation pour en savoir plus sur la modification des paramètres, des variables d'environnement et des instructions.

Étapes suivantes