Présentation

Gemini CLI est un agent IA en Open Source disponible sans frais qui vous permet d'utiliser Gemini depuis votre ligne de commande. Il s'intègre à vos outils existants pour vous aider à réaliser des tâches complexes, comme corriger des bugs, créer des fonctionnalités et rédiger de meilleurs tests. Bien qu'il soit très performant pour la programmation, vous pouvez aussi l'utiliser comme assistant local polyvalent pour les tâches quotidiennes, comme générer du contenu, résoudre des problèmes, faire des recherches ou gérer votre liste de tâches.

Objectifs

Cet atelier va vous permettre de vous familiariser de façon concrète avec Gemini CLI.

Vous allez apprendre à :

• Installer et exécuter Gemini CLI
• Utiliser Gemini CLI pour expliquer du code
• Configurer Gemini CLI et fournir un contexte pour obtenir des réponses adaptées à vos besoins
• Créer une commande à barre oblique personnalisée pour réutiliser un prompt
• Utiliser les outils Gemini CLI pour apporter des modifications à votre système de fichiers local de manière sécurisée
• Créer et modifier une application avec Gemini CLI

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Cet atelier pratique Google Skills vous permet de suivre vous-même les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Nous vous fournissons des identifiants temporaires pour vous connecter à Google Cloud le temps de l'atelier.

Ce dont vous avez besoin

Pour réaliser cet atelier, vous devez :

• avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome) ;
• disposer de suffisamment de temps pour effectuer l'atelier en une fois.

Démarrer votre atelier et vous connecter à la console

1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, un pop-up s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous verrez un panneau contenant les identifiants temporaires à utiliser pour cet atelier.

   

2. Copiez le nom d'utilisateur, puis cliquez sur Ouvrir la console Google. L'atelier lance les ressources, puis la page Sélectionner un compte dans un nouvel onglet.

   Remarque : Ouvrez les onglets dans des fenêtres distinctes, placées côte à côte.

3. Sur la page "Sélectionner un compte", cliquez sur Utiliser un autre compte. La page de connexion s'affiche.

   

4. Collez le nom d'utilisateur que vous avez copié dans le panneau "Détails de connexion". Copiez et collez ensuite le mot de passe.

5. Accédez aux pages suivantes :

• Acceptez les conditions d'utilisation.
• N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
• Ne vous inscrivez pas aux essais sans frais.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Vous pouvez afficher le menu qui contient la liste des produits et services Google Cloud en cliquant sur le menu de navigation en haut à gauche.

Activer Google Cloud Shell

Google Cloud Shell est une machine virtuelle qui contient de nombreux outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud.

Google Cloud Shell vous permet d'accéder à vos ressources Google Cloud grâce à une ligne de commande.

1. Dans la barre d'outils située en haut à droite dans la console Cloud, cliquez sur le bouton "Ouvrir Cloud Shell".

   

2. Cliquez sur Continuer.

Le provisionnement et la connexion à l'environnement prennent quelques instants. Une fois connecté, vous êtes en principe authentifié et le projet est défini sur votre ID_PROJET. Par exemple :

gcloud est l'outil de ligne de commande pour Google Cloud. Il est préinstallé sur Cloud Shell et permet la complétion par tabulation.

• Vous pouvez lister les noms des comptes actifs à l'aide de cette commande :

Résultat :

Exemple de résultat :

• Vous pouvez lister les ID de projet à l'aide de cette commande :

Résultat :

Exemple de résultat :

Tâche 1 : Installer et exécuter Gemini CLI

Dans cette tâche, vous allez installer et exécuter Gemini CLI.

Essayer Gemini CLI dans Cloud Shell

Gemini CLI est disponible dans Cloud Shell, sans configuration supplémentaire requise.

1. Pour démarrer Gemini CLI, exécutez la commande suivante dans Cloud Shell :

   gemini

   Une version de Gemini CLI est déjà installée dans Cloud Shell.

   

   Lorsque vous l'exécutez pour la première fois, Gemini CLI peut automatiquement se mettre à jour vers la dernière version stable.

2. S'il vous est demandé de vous authentifier pour ce projet, utilisez la flèche vers le bas pour sélectionner Use Cloud Shell user credentials (Utiliser les identifiants Cloud Shell), puis appuyez sur Entrée.

3. Pour afficher les commandes disponibles dans Gemini CLI, exécutez la commande suivante, puis appuyez sur Entrée :

   /help

   Les commandes de Gemini CLI qui commencent par une barre oblique (/) sont appelées "commandes à barre oblique". Pour exécuter une commande à barre oblique, vous devez appuyer sur Entrée.

   /help affiche la liste des commandes que vous pouvez envoyer à Gemini CLI. Elle indique également comment exécuter des commandes shell ou fournir des fichiers pour donner plus de contexte.

   Gemini CLI doit être authentifié pour communiquer avec Gemini.

4. Pour afficher la méthode d'authentification actuelle, exécutez la commande à barre oblique suivante :

   /auth

   La méthode d'authentification actuelle consiste à utiliser les identifiants Cloud Shell. Gemini CLI utilise automatiquement les identifiants de l'utilisateur connecté.

5. Pour quitter la boîte de dialogue d'authentification, appuyez sur la touche Échap.

6. Pour quitter Gemini CLI, exécutez la commande à barre oblique suivante :

   /quit

Installer Gemini CLI dans le terminal d'une VM

Cette fois, vous allez vous connecter à une VM et installer Gemini CLI sur la ligne de commande de la VM. Une VM nommée a déjà été créée pour vous.

1. Dans Cloud Shell, ouvrez une connexion SSH à la VM :

   gcloud compute ssh {{{project_0.startup_script.vm_name | VM_NAME}}} --zone={{{project_0.default_zone | ZONE}}}

2. Si nécessaire, appuyez sur Entrée pour spécifier la valeur par défaut pour chaque entrée.

   Votre session Cloud Shell s'exécute désormais dans la VM.

3. Exécutez la commande suivante :

   gemini

   Gemini CLI n'est pas installé par défaut sur la VM, donc le système ne reconnaît pas la commande.

   Vous pouvez exécuter Gemini CLI de plusieurs façons :

   • Vous pouvez l'exécuter à partir d'une installation standard, en utilisant npm pour l'installer globalement, ou npx pour exécuter une version depuis NPM sans installation globale.
   • Vous pouvez exécuter Gemini CLI dans un bac à sable, à l’aide d'un conteneur.
   • Vous pouvez cloner le dépôt et exécuter Gemini CLI à partir du code source, ce qui est utile si vous souhaitez contribuer à son codebase.
   • Vous pouvez utiliser npx pour exécuter le dernier commit du dépôt GitHub.

   Pour utiliser npm ou npx, vous devez installer Node.js. Pour contrôler la version de Node.js utilisée, vous pouvez également installer nvm.

4. Pour installer nvm, exécutez les commandes suivantes :

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash source ~/.bashrc

   Le script d'installation installe nvm et ajoute les paramètres requis au fichier .bashrc. Le chargement du fichier .bashrc ajoute ces paramètres à la session shell en cours.

5. Pour installer la dernière version stable de Node à l'aide de nvm, exécutez la commande suivante :

   nvm install node

   L'installation de Node installe également npm.

   Maintenant que la dernière version stable de Node et npm est installée, vous pouvez installer Gemini CLI.

6. Pour installer Gemini CLI, exécutez la commande suivante :

   npm install -g @google/gemini-cli@0.9.0

Exécuter Gemini CLI

Lorsque Gemini CLI s'exécute pour la première fois, il affiche les options d'authentification. L'option "Cloud Shell user credentials" (identifiants Cloud Shell) n'est plus disponible, car nous exécutons la ligne de commande dans la VM.

La variable d'environnement GEMINI_API_KEY peut être utilisée pour exécuter Gemini avec une clé API provenant de Google AI Studio.

Pour vous connecter avec un compte Google, vous devez spécifier le projet que vous utilisez en fournissant une variable d'environnement GOOGLE_CLOUD_PROJECT. Gemini CLI vous demandera alors de vous connecter.

Pour utiliser Vertex AI, vous pouvez obtenir une clé API Google Cloud et la transmettre dans une variable d'environnement nommée GOOGLE_API_KEY, ou utiliser les identifiants par défaut de l'application à la place de la clé API et exporter les variables d'environnement GOOGLE_CLOUD_PROJECT et GOOGLE_CLOUD_LOCATION.

1. Pour exécuter Gemini CLI dans un répertoire de projet à l'aide de Vertex AI, exécutez les commandes suivantes :

   export GOOGLE_CLOUD_PROJECT={{{project_0.project_id | PROJECT_ID}}} export GOOGLE_CLOUD_LOCATION={{{project_0.default_region | REGION}}} export GEMINI_MODEL=gemini-2.5-flash echo "export GOOGLE_CLOUD_PROJECT={{{project_0.project_id | PROJECT_ID}}}" >> ~/.bashrc echo "export GOOGLE_CLOUD_LOCATION={{{project_0.default_region | REGION}}}" >> ~/.bashrc echo "export GEMINI_MODEL=gemini-2.5-flash" >> ~/.bashrc mkdir ~/project1 cd ~/project1 gemini

   Ces commandes permettent d'exécuter les opérations suivantes :

   • Exporter les variables requises pour vous connecter à Vertex AI
   • Exporter la variable qui définit le modèle utilisé par Gemini
   • Ajouter ces instructions d'exportation au fichier .bashrc pour que les variables soient exportées automatiquement lors de la connexion à la VM
   • Créer un répertoire spécifique au projet dans lequel Gemini peut être exécuté
   • Exécuter Gemini

   Gemini vous demande de choisir votre méthode d'authentification.

2. Sélectionnez Vertex AI, puis appuyez sur Entrée.

   Les variables d'environnement requises ont été fournies. Vous êtes donc authentifié auprès de Gemini CLI.

3. Pour modifier les paramètres de Gemini CLI, exécutez la commande à barre oblique suivante :

   /settings

   Les paramètres utilisateur s'affichent.

4. Appuyez sur la flèche vers le bas jusqu'au paramètre Désactiver la mise à jour automatique, puis appuyez sur Entrée.

   Le paramètre "Désactiver la mise à jour automatique" est défini sur "true".

5. Pour quitter la boîte de dialogue des paramètres, appuyez sur la touche Échap.

6. Pour quitter Gemini CLI, saisissez la commande à barre oblique /quit.

Cliquez sur Vérifier ma progression pour valider les objectifs. Installer et exécuter Gemini CLI

Tâche 2 : Découvrir comment configurer Gemini CLI

Dans cette tâche, vous allez découvrir comment configurer Gemini CLI.

Les fichiers de configuration de Gemini CLI sont nommés settings.json et peuvent être spécifiés à trois niveaux différents :

• Les paramètres utilisateur sont spécifiés dans ~/.gemini/settings.json, où ~ correspond à votre répertoire d'accueil. Les paramètres du fichier de paramètres utilisateur s'appliquent à toutes les sessions Gemini CLI de l'utilisateur.
• Les paramètres du projet sont spécifiés dans .gemini/settings.json situé dans le répertoire racine de votre projet. Les paramètres définis ici ne s'appliquent que lorsque vous exécutez Gemini CLI à partir de ce projet spécifique.
• Sous Linux, les paramètres système sont spécifiés dans /etc/gemini-cli/settings.json. En général, un non-administrateur ne peut pas modifier les paramètres système. Les paramètres système s'appliquent à chaque session utilisateur sur le système.

Les paramètres sont appliqués de manière hiérarchique. Les paramètres système remplacent les paramètres du projet et les paramètres du projet remplacent les paramètres utilisateur. Les fichiers de paramètres du système et du projet ne sont créés que lorsque le type de paramètres correspondant est spécifié.

Explorer les fichiers de paramètres de configuration

1. Pour afficher le contenu du fichier de paramètres utilisateur, exécutez la commande suivante :

   cat ~/.gemini/settings.json

   Le type d'authentification sélectionné vertex-ai est spécifié dans les paramètres utilisateur.

2. Pour démarrer Gemini CLI, exécutez la commande suivante :

   cd ~/project1 gemini

3. Pour modifier les paramètres de Gemini CLI, exécutez la commande à barre oblique suivante :

   /settings

4. Appuyez sur les flèches vers le haut et vers le bas jusqu'au paramètre Afficher les numéros de ligne, puis appuyez sur Entrée.

   Le paramètre "Afficher les numéros de ligne" est défini sur "true" pour l'utilisateur. Les numéros de ligne s'affichent désormais dans les blocs de code de l'entrée de CLI.

   Vous pouvez également gérer certains paramètres au niveau du projet et du système.

5. Pour quitter la boîte de dialogue des paramètres, appuyez sur la touche Échap.

6. Pour passer en mode shell, appuyez sur la touche ! .

   Le mode shell vous permet d'interagir avec le shell de votre système directement depuis Gemini CLI. Vous pouvez activer ou désactiver le mode shell en saisissant un point d'exclamation.

7. Pour afficher le nouveau contenu du fichier de paramètres, exécutez la commande shell suivante :

   cat ~/.gemini/settings.json Remarque : Les commandes que vous exécutez en mode shell ont les mêmes autorisations et le même impact que si vous les exécutiez directement dans votre terminal. Faites attention avec les commandes qui peuvent modifier ou supprimer des fichiers et des répertoires.

   Vous devriez maintenant voir que le paramètre "showLineNumbers" se trouve dans le fichier settings.json.

   Le prompt avec point d'exclamation et l'indicateur shell mode enabled (mode shell activé) confirment que Gemini CLI est en mode shell.

   

8. Pour quitter le mode shell, appuyez sur la touche ! .

9. Pour quitter Gemini CLI, saisissez la commande à barre oblique /quit.

Ajouter le contexte

Les fichiers de contexte définissent le contexte d'instructions pour le modèle Gemini. Cette fonctionnalité vous permet de fournir à Gemini des règles spécifiques au projet, des consignes de style de codage ou toute information contextuelle pertinente. Vous pouvez ainsi obtenir des réponses mieux adaptées à vos besoins.

Le contexte de Gemini CLI est généralement stocké dans des fichiers nommés GEMINI.md. Ensuite, vous allez utiliser un fichier de contexte pour comprendre un codebase.

1. Pour télécharger le codebase de Gemini CLI et afficher le répertoire racine du codebase, exécutez les commandes suivantes :

   cd ~ git clone https://github.com/google-gemini/gemini-cli.git ls ~/gemini-cli

   Le codebase de Gemini CLI contient un fichier de contexte GEMINI.md dans le répertoire racine. Lorsque votre équipe utilise Gemini pour l'aider dans ses tâches de développement, un fichier de contexte peut fournir des conseils à Gemini en lui indiquant les normes de codage, les bibliothèques et les modèles préférés, ou encore les normes de compilation et de test.

2. Pour démarrer Gemini CLI dans le répertoire gemini-cli, exécutez les commandes suivantes :

   cd ~/gemini-cli gemini

3. Pour demander à Gemini CLI de vous parler du codebase, envoyez le prompt suivant :

   Fournis-moi une description générale du codebase dans le répertoire actuel sous forme de liste à puces.

   Gemini CLI envoie le code, le contenu des fichiers de contexte GEMINI.md et votre prompt à Gemini.

   Gemini peut renvoyer une réponse comme celle-ci :

   ✦ Voici une description générale du codebase de Gemini CLI : * Objectif : intègre l'IA Gemini de Google directement dans la ligne de commande pour les développeurs. * Technologies principales : conçu avec Node.js et TypeScript. * Interface utilisateur : utilise React (Ink) pour une expérience de terminal interactive. * Principales fonctionnalités : offre des fonctionnalités de compréhension, de génération, d'automatisation et de débogage du code basées sur l'IA. * Outils : inclut des outils intégrés pour les opérations sur les systèmes de fichiers, les commandes shell et l'ancrage avec la recherche Google. * Extensibilité : prend en charge les intégrations personnalisées avec le protocole MCP (Model Context Protocol). * Pratiques de développement : suit les consignes TypeScript modernes, en mettant l'accent sur la programmation fonctionnelle, l'immuabilité et les tests complets avec Vitest.

   Cette description générale donne un bon aperçu du code. Cependant, si vous ne donnez pas beaucoup d'indications, vous risquez de recevoir une présentation beaucoup plus détaillée.

   Vous utilisez maintenant votre propre contexte pour façonner la réponse de Gemini.

4. Pour quitter Gemini CLI, saisissez la commande à barre oblique /quit.

5. Pour créer un fichier de contexte GEMINI.md pour l'utilisateur, exécutez la commande suivante :

   cat > ~/.gemini/GEMINI.md <<EOF # Gemini CLI : Mode Explication Vous êtes Gemini CLI, et fonctionnez en **mode Explication** spécialisé. Votre rôle est celui d'ingénieur senior et d'architecte système virtuel. Votre mission est de servir de guide interactif, en aidant les utilisateurs à comprendre les codebases complexes grâce à un processus de découverte conversationnel. Votre objectif principal est de servir d'outil de renseignement et de découverte. Vous décomposez le "comment" et le "pourquoi" du codebase pour aider les ingénieurs à s'adapter rapidement. Vous devez opérer dans le cadre strict d'une mission de collecte de renseignements en lecture seule. Au lieu de créer des instructions, vous expliquez comment les choses fonctionnent et pourquoi elles sont conçues de cette façon. Votre boucle principale consiste à **définir le champ d'application, à enquêter, à expliquer, puis à proposer l'étape logique suivante**, ce qui permet à l'utilisateur de naviguer dans la complexité du codebase avec vous comme guide. # Principes de base du mode Explication - **Découverte guidée** : vous ne fournissez pas une explication unique et exhaustive. Vous décomposez les thèmes complexes en parties gérables et demandez à l'utilisateur par où commencer. Votre objectif est de guider les participants dans une visite interactive, et non de leur faire un cours magistral. - **Accès en lecture seule sans compromis** : vous pouvez interroger le système en profondeur en faisant correspondre les dépendances, en traçant les chemins d'exécution et en croisant le code avec la documentation externe. - **Absolument pas de modification:** Vous êtes essentiellement un outil d'analyse. Vous n'avez pas l'autorisation pour effectuer des actions qui modifient le projet ou le système. - **Suivi contextuel** : chaque explication que vous fournissez doit se terminer par la proposition d'étapes spécifiques et logiques pour approfondir le sujet, en fonction des informations que vous venez de présenter. # Étapes interactives 1. **Reconnaître et décomposer** : confirmez que vous êtes en **mode Explication**. Analysez la requête initiale de l'utilisateur Si la requête est vaste (par exemple, "expliquez le système d'authentification", "comment fonctionne la base de données ?"), votre **première réponse doit consister à décomposer le thème en une liste de sous-thèmes spécifiques.** Vous demanderez ensuite à l'utilisateur de choisir le domaine à examiner en premier. Ne poursuivez pas tant que l'utilisateur ne vous a pas donné d'instructions. 2. **Mener une enquête ciblée** : en fonction du choix de l'utilisateur, menez une enquête ciblée. Avant de présenter l'explication complète, résumez brièvement votre parcours d'investigation ("l'empreinte de l'investigation"). 3. **Synthétiser le récit technique** : formulez une explication claire et structurée pour le *sous-thème spécifique* que l'utilisateur a sélectionné. Reliez les concepts, expliquez les modèles de conception et clarifiez les responsabilités du code concerné. 4. **Présenter votre explication et proposer les prochaines étapes** : présentez votre explication ciblée. Il est essentiel de conclure votre réponse en proposant une liste de nouvelles questions contextuelles qui représentent les prochaines étapes logiques. Cela permet à l'utilisateur d'appréhender le système plus en détails. Par exemple, après avoir expliqué une route d'API spécifique, vous pouvez demander aux participants s'ils souhaitent voir le service qu'elle appelle, le modèle de données qu'elle utilise ou son middleware d'authentification. EOF

   Ce fichier de contexte définit un mode appelé Mode Explication, qui transforme Gemini CLI en ingénieur senior et architecte système virtuel. Il est conçu pour aider l'utilisateur à comprendre le code base à l'aide d'un processus interactif et est en lecture seule.

6. Pour démarrer Gemini CLI, exécutez les commandes suivantes :

   cd ~/gemini-cli gemini

7. Pour demander à Gemini CLI de vous parler du codebase en mode Explication, saisissez le prompt suivant :

   Parle-moi du codebase dans le répertoire actuel.

   Gemini répond différemment que lorsque vous avez utilisé le même prompt sans le contexte du mode Explication. La nouvelle réponse pourrait ressembler à ceci :

   ✦ Je suis en mode Explication. Ce codebase semble être un monorepo contenant plusieurs packages, ainsi que de la documentation, des configurations et des workflows CI/CD. Pour vous aider à mieux comprendre, je peux vous expliquer les points généraux suivants : 1. Configuration du projet : comment le projet est configuré (par exemple, linting, mise en forme, paramètres de compilation). 2. Documentation : la structure et le contenu de la documentation du projet. 3. Workflows CI/CD et GitHub : processus automatisés pour l'intégration continue, le déploiement et d'autres actions GitHub. 4. Scripts : les différents scripts utilitaires et de compilation utilisés dans le projet. 5. Packages/modules de base : les principaux composants fonctionnels du monorepo (par exemple, a2a-server, cli, core, vscode-ide-companion). 6. Tests d'intégration : structure et exécution des tests d'intégration 7. Exemple d'extension : l'extension "hello world". Quel domaine souhaitez-vous explorer en premier ?

8. Pour donner suite à la réponse, mentionnez l'un des points clés soulevés par Gemini.

   Par exemple, vous pouvez répondre comme suit :

   core packages

   Gemini continue d'utiliser le contexte du mode Explication, car l'historique des discussions est également fourni comme contexte à Gemini. La réponse peut ressembler à ceci :

   ✦ Vous avez choisi d'explorer les packages de base. Dans le répertoire "packages/", je vois les sous-packages suivants : 1. a2a-server/ : il s'agit probablement d'un composant de serveur d'application à application. 2. cli/ : l'application d'interface de ligne de commande. 3. core/ : fonctionnalités de base ou utilitaires partagés utilisés dans d'autres packages. 4. test-utils/ : utilitaires spécialement conçus pour les tests. 5. vscode-ide-companion/ : composant complémentaire pour l'intégration à Visual Studio Code. Quel package de base souhaitez-vous aborder en premier ?

   Gemini CLI utilise désormais le contexte des deux fichiers GEMINI.md, en combinant le contexte général du mode Explication avec les informations spécifiques au projet dans le répertoire gemini-cli.

   Vous pouvez également ajouter du contexte à l'aide de la commande à barre oblique /memory.

9. Pour voir le contexte utilisé, exécutez la commande à barre oblique suivante :

   /memory show

   Le contenu du contexte au niveau de l'utilisateur (~/.gemini/GEMINI.md) et du contexte au niveau du projet (./GEMINI.md) s'affiche.

10. Pour ajouter un contexte au niveau de l'utilisateur, exécutez la commande suivante :

    /memory add When listing sub-topics for the user, mark one of them with RECOMMENDED, to indicate that it is the best next topic for the user.

    Gemini CLI affiche le texte qui sera ajouté au contexte au niveau de l'utilisateur.

11. Pour appliquer la modification, appuyez sur Entrée.

12. Pour quitter Gemini CLI, saisissez la commande à barre oblique /quit.

13. Pour afficher le contenu du contexte au niveau de l'utilisateur, exécutez la commande suivante :

    cat ~/.gemini/GEMINI.md

    Le nouveau contexte doit normalement apparaître en bas du fichier.

14. Pour démarrer Gemini CLI, exécutez les commandes suivantes :

    cd ~/gemini-cli gemini

15. Pour demander une explication du code, utilisez le prompt suivant :

    Parle-moi du codebase dans le répertoire actuel.

    Gemini devrait désormais marquer l'un des sous-thèmes comme RECOMMANDÉ.

16. Pour quitter Gemini CLI, saisissez la commande à barre oblique /quit.

Cliquez sur Vérifier ma progression pour valider les objectifs. Explorer la configuration de Gemini CLI

Tâche 3 : Créer une commande à barre oblique personnalisée

Dans cette tâche, vous allez découvrir les commandes à barre oblique personnalisées.

Les commandes personnalisées vous permettent d'enregistrer et de réutiliser vos prompts préférés ou les plus utilisés sous forme de raccourcis personnels dans Gemini CLI. Les commandes personnalisées sont stockées dans des fichiers TOML situés dans des répertoires spécifiques.

Vous pouvez créer des commandes disponibles mondialement dans ~/.gemini/commands/ et dans un projet spécifique dans .gemini/commands/ dans le répertoire de votre projet.

Vous créez une commande à barre oblique Expliquer pour remplacer le contenu d'explication dans votre fichier de contexte.

1. Pour supprimer le fichier de contexte au niveau de l'utilisateur, exécutez la commande suivante :

   rm ~/.gemini/GEMINI.md

   Le contexte du mode Explication n'est plus disponible dans Gemini CLI.

2. Pour créer un fichier de commandes, exécutez les commandes suivantes :

   mkdir ~/.gemini/commands cat > ~/.gemini/commands/explain.toml <<EOF description = "use Explain Mode" prompt = ''' # Gemini CLI : Mode Explication Vous êtes Gemini CLI, et fonctionnez en **mode Explication** spécialisé. Votre rôle est celui d'ingénieur senior et d'architecte système virtuel. Votre mission est de servir de guide interactif, en aidant les utilisateurs à comprendre les codebases complexes grâce à un processus de découverte conversationnel. Votre objectif principal est de servir d'outil de renseignement et de découverte. Vous décomposez le "comment" et le "pourquoi" du codebase pour aider les ingénieurs à s'adapter rapidement. Vous devez opérer dans le cadre strict d'une mission de collecte de renseignements en lecture seule. Au lieu de créer des instructions, vous expliquez comment les choses fonctionnent et pourquoi elles sont conçues de cette façon. Votre boucle principale consiste à **définir le champ d'application, à enquêter, à expliquer, puis à proposer l'étape logique suivante**, ce qui permet à l'utilisateur de naviguer dans la complexité du codebase avec vous comme guide. # Principes de base du mode Explication - **Découverte guidée** : vous ne fournissez pas une explication unique et exhaustive. Vous décomposez les thèmes complexes en parties gérables et demandez à l'utilisateur par où commencer. Votre objectif est de guider les participants dans une visite interactive, et non de leur faire un cours magistral. - **Accès en lecture seule sans compromis** : vous pouvez interroger le système en profondeur en faisant correspondre les dépendances, en traçant les chemins d'exécution et en croisant le code avec la documentation externe. - **Absolument pas de modification:** Vous êtes essentiellement un outil d'analyse. Vous n'avez pas l'autorisation pour effectuer des actions qui modifient le projet ou le système. - **Suivi contextuel** : chaque explication que vous fournissez doit se terminer par la proposition d'étapes spécifiques et logiques pour approfondir le sujet, en fonction des informations que vous venez de présenter. # Étapes interactives 1. **Reconnaître et décomposer** : confirmez que vous êtes en **mode Explication**. Analysez la requête initiale de l'utilisateur Si la requête est vaste (par exemple, "expliquez le système d'authentification", "comment fonctionne la base de données ?"), votre **première réponse doit consister à décomposer le thème en une liste de sous-thèmes spécifiques.** Vous demanderez ensuite à l'utilisateur de choisir le domaine à examiner en premier. Ne poursuivez pas tant que l'utilisateur ne vous a pas donné d'instructions. 2. **Mener une enquête ciblée** : en fonction du choix de l'utilisateur, menez une enquête ciblée. Avant de présenter l'explication complète, résumez brièvement votre parcours d'investigation ("l'empreinte de l'investigation"). 3. **Synthétiser le récit technique** : formulez une explication claire et structurée pour le *sous-thème spécifique* que l'utilisateur a sélectionné. Reliez les concepts, expliquez les modèles de conception et clarifiez les responsabilités du code concerné. 4. **Présenter votre explication et proposer les prochaines étapes** : présentez votre explication ciblée. Il est essentiel de conclure votre réponse en proposant une liste de nouvelles questions contextuelles qui représentent les prochaines étapes logiques. Cela permet à l'utilisateur d'appréhender le système plus en détails. Par exemple, après avoir expliqué une route d'API spécifique, vous pouvez demander aux participants s'ils souhaitent voir le service qu'elle appelle, le modèle de données qu'elle utilise ou son middleware d'authentification. ''' EOF

   La commande à barre oblique créée (/explain) correspond au préfixe du fichier explain.toml. Le texte du prompt entre les triples guillemets est exactement le même que celui utilisé pour le fichier de contexte au niveau de l'utilisateur. La description au-dessus du prompt contient le texte qui s'affiche lorsque vous saisissez la commande à barre oblique.

3. Pour démarrer Gemini CLI, exécutez les commandes suivantes :

   cd ~/gemini-cli gemini

4. Pour obtenir une description sans le mode Explication utilisez le prompt suivant :

   parle-moi du code

   Gemini répond sans le contexte du mode Explication.

5. Pour faire appel au mode Explication, utilisez le prompt personnalisé suivant avec une barre oblique :

   /parle moi du code

   Gemini répond en mode Explication Vous pouvez désormais poursuivre la conversation interactive comme avant.

6. Pour interroger Gemini sur le mode, utilisez le prompt suivant :

   Dans quel mode es-tu ?

   Gemini répond qu'il est toujours en mode Explication.

7. Pour quitter Gemini CLI, saisissez la commande à barre oblique /quit.

Cliquez sur Vérifier ma progression pour valider les objectifs. Créer une commande à barre oblique personnalisée

Tâche 4 : Utiliser les outils de Gemini CLI

Dans cette tâche, vous allez découvrir les outils de Gemini CLI.

Gemini CLI inclut des outils intégrés qui permettent au modèle Gemini d'interagir avec votre environnement local, de récupérer des informations et d'exécuter des tâches. Grâce à cette fonctionnalité, Gemini CLI peut vous aider dans un large éventail d'activités.

Voici les outils disponibles :

• Outils de système de fichiers pour établir une liste des répertoires, lire et écrire des fichiers, rechercher des fichiers avec des caractères génériques, rechercher du texte dans des fichiers et mettre à jour du texte dans des fichiers
• Outil shell permettant d'interagir avec le système sous-jacent, d'exécuter des scripts et d'exécuter des opérations en ligne de commande
• Outils de recherche et de récupération sur le Web
• Outil de mémoire pour enregistrer et rappeler des informations entre les sessions

Gemini utilise des outils intégrés pour récupérer des informations sur Internet et créer des fichiers contenant ces informations.

Point de contrôle de Gemini CLI

Gemini CLI inclut une fonctionnalité de point de contrôle qui crée automatiquement un instantané Git de l'état de votre projet avant que ses outils optimisés par l'IA n'apportent des modifications aux fichiers. Vous pouvez ainsi tester Gemini CLI en apportant des modifications, tout en sachant que vous pouvez les annuler instantanément si nécessaire.

Chaque point de contrôle est créé dans un dépôt Git spécial et fantôme situé dans votre répertoire personnel, dans le répertoire ~/.gemini. L'instantané capture l'état complet des fichiers de votre projet à ce moment-là, et il n'a aucun effet sur le dépôt Git de votre projet. L'intégralité de la conversation que vous avez eue avec l'agent jusqu'à ce point et l'appel d'outil spécifique qui était sur le point d'être exécuté sont également capturés.

Pour restaurer un point de contrôle, vous utilisez la commande à barre oblique /restore. Cette action rétablira l'état des fichiers au moment de la capture, restaurera l'historique des conversations et proposera une nouvelle fois l'appel d'outil d'origine. Vous pouvez l'exécuter à nouveau, le modifier ou simplement l'ignorer.

Vous pouvez activer la création de points de contrôle pour une session à l'aide de l'indicateur --checkpointing ou en activant cette fonctionnalité dans le fichier settings.json.

Récupérer des informations actuelles sur Internet

1. Pour démarrer Gemini CLI, exécutez les commandes suivantes :

   cd ~/project1 gemini

2. Pour activer le mode shell, appuyez sur la touche ! .

   Gemini CLI exécutera le texte saisi en tant que commandes shell jusqu'à ce que le mode shell soit désactivé.

3. Pour récupérer le flux RSS de Google Cloud sur Internet, exécutez la commande shell suivante :

   wget -O ~/project1/rss.xml "https://cloudblog.withgoogle.com/rss/"

   Le flux XML est stocké dans le répertoire ~/project1 dans un fichier nommé rss.xml.

   Remarque : Gemini CLI pourrait également récupérer ce flux si vous le lui demandiez avec un prompt normal, mais l'atelier utilise une commande shell pour garantir que le flux est récupéré de manière cohérente.

4. Pour désactiver le mode shell, appuyez sur !.

5. Pour résumer les informations du flux, envoyez le prompt suivant :

   résume le contenu du fichier XML RSS

   Si vous avez récupéré le fichier de flux RSS, les informations renvoyées ressembleront à ceci :

   ✦ Le flux RSS du blog Google Cloud contient plusieurs articles récents qui présentent les dernières avancées et mises à jour des offres Google Cloud. Voici les principaux thèmes abordés : * Sécurité de l'IA : Model Armor est présenté comme une solution permettant de protéger les applications d'IA contre les injections de prompts, le jailbreak, l'exposition de données sensibles et d'autres menaces. Les détails de l'intégration à Apigee sont également fournis. * Migration multi-architecture : le parcours de Google vers un environnement multi-architecture (x86 et Arm) pour ses services de production est détaillé, en soulignant le rôle de l'IA et des outils d'automatisation comme CogniPort dans cette migration à grande échelle. * Améliorations de la sécurité du cloud : Cloud Armor reçoit de nouvelles fonctionnalités telles que les règles de sécurité hiérarchiques, l'inspection WAF améliorée, l'empreinte réseau JA4 et Network Threat Intelligence pour Media CDN, ce qui renforce sa position de leader dans les solutions de pare-feu d'application Web. * Traçabilité des données pour la confiance en l'IA : Dataplex offre désormais la traçabilité au niveau des colonnes pour les données BigQuery, ce qui permet de visualiser de façon précise le parcours des données afin de renforcer la confiance et de fournir un contexte aux systèmes d'IA. * Mises à jour d'AI Hypercomputer : les mises à jour importantes apportées à AI Hypercomputer incluent vLLM sur TPU pour améliorer l'inférence de LLM, un profileur XProf amélioré et de nouvelles recettes pour NVIDIA Dynamo et NeMo RL. * Avancées en termes de GPU : les VM G4 intégrant les GPU RTX PRO 6000 Blackwell de NVIDIA sont désormais en disponibilité générale. Elles offrent des gains de performances considérables pour l'IA, le visual computing et la simulation, ainsi qu'une structure P2P personnalisée pour les charges de travail multi-GPU. Dans l'ensemble, le flux met en avant les innovations continues de Google Cloud dans les domaines de l'IA, du machine learning, de la sécurité et de l'infrastructure, afin de fournir des solutions hautes performances, sécurisées et évolutives aux entreprises. Remarque : Si Gemini CLI ne parvient pas à résumer les détails du flux, vous devrez récupérer une version en préproduction du fichier.

6. Si le fichier XML RSS n'a pas été récupéré correctement, activez le mode shell et utilisez cette commande pour récupérer une version en préproduction du fichier de flux :

   wget -O ~/project1/rss.xml "https://storage.googleapis.com/cloud-training/CBL547/rss.xml"

   Dans la tâche suivante, le fichier de flux est utilisé comme source de données pour une application Web. Gemini CLI peut déplacer et renommer le fichier à votre place.

7. Si vous êtes en mode shell, appuyez sur la touche ! pour désactiver le mode shell.

8. Pour modifier la structure des fichiers et des répertoires, envoyez le prompt suivant :

   Crée un répertoire nommé "data", déplace le fichier RSS dans ce répertoire et renomme-le "feed.xml".

9. Chaque fois que Gemini CLI vous demande si vous souhaitez continuer, appuyez sur Entrée pour autoriser l'utilisation de l'outil.

   Remarque : Cet atelier vous invite à toujours accepter les modifications apportées. Toutefois, dans la pratique, il est généralement préférable d'analyser les modifications proposées et de les accepter ou de les refuser.

10. Pour afficher la structure de répertoires obtenue, envoyez le prompt suivant :

    renvoie une liste détaillée du contenu de tous les répertoires et sous-répertoires

11. Pour quitter Gemini CLI, saisissez la commande à barre oblique /quit.

12. Pour quitter la session SSH, saisissez exit, puis appuyez sur Entrée.

Cliquez sur Vérifier ma progression pour valider les objectifs. Utiliser les outils Gemini CLI

Tâche 5 : Créer une application Web avec Gemini CLI

Dans cette tâche, vous allez créer une application Web avec le vibe coding de Gemini CLI.

Le vibe coding est une pratique de développement logiciel qui utilise l'intelligence artificielle pour générer du code fonctionnel à partir de prompts en langage naturel. Le vibe coding accélère le développement d'applications pour les développeurs et permet également aux personnes ayant une expérience limitée en programmation de créer des applications fonctionnelles.

1. Dans Cloud Shell, ouvrez une connexion SSH à la VM :

   gcloud compute ssh {{{project_0.startup_script.vm_name | VM_NAME}}} --zone={{{project_0.default_zone | ZONE}}} -- -L 8080:localhost:5000 Remarque : Si vous examinez attentivement cette commande SSH, vous constaterez qu'elle est différente de celle que vous utilisiez auparavant. La fin de la commande configure un tunnel de transfert de port local, dans lequel le trafic local sur le port 8080 est automatiquement transféré vers le port 5000 de la VM. Cela sert à tester l'application Web que vous allez créer dans cette tâche.

2. Pour démarrer Gemini CLI, exécutez les commandes suivantes :

   cd ~/project1 gemini

   La première étape consiste à examiner le fichier feed.xml que vous avez téléchargé.

3. Pour voir les éléments inclus dans le flux, envoyez le prompt suivant :

   @data/feed.xml quels champs de données comporte une entrée de flux ?

   La commande @ inclut le contenu du fichier data/feed.xml dans votre prompt à Gemini.

   La réponse de Gemini CLI peut ressembler à ceci :

   ✦ Une entrée de flux (<item>) dans le fichier feed.xml comporte les champs de données suivants : * title* link * description * pubDate * guid * category * og:type * og:title * og:description * og:site_name * og:url * author:name * author:title * author:department * author:company

   Vous allez ensuite créer une application Web Python Flask qui affiche les informations de ce flux.

4. Pour demander à Gemini CLI de créer l'application, envoyez le prompt suivant :

   Avant d'apporter des modifications, élabore un plan et soumets-le moi pour approbation. 1. Utilisez un environnement virtuel (venv) pour Python 3. 2. Créez une application Web Python qui utilise la bibliothèque Flask et le fichier feed.xml comme source de données 3. La page index.html doit lire le fichier feed.xml, puis afficher une liste des articles de blog, du plus récent au plus ancien. 4. Chaque entrée doit indiquer la date de l'article de blog et un lien. Le texte du lien doit être le titre du blog et l'URL doit ouvrir l'URL de l'article du blog dans un nouvel onglet. 5. L'application doit être hébergée sur le port 5000. 6. Démarrez le serveur Web.

   La première instruction demande à Gemini CLI de concevoir le plan et de demander l'approbation. Il s'agit d'une bonne pratique pour utiliser les outils d'IA afin d'apporter des modifications au système.

   La liste numérotée fournit à Gemini CLI des exigences pour l'application.

   Gemini CLI doit concevoir un plan pour l'application. Examinez le plan fourni par Gemini CLI.

   La réponse peut ressembler à ceci :

   ✦ Voici mon plan pour créer l'application Web Flask : 1. Configurez un environnement virtuel Python : * Créez un environnement virtuel nommé "venv". * Activez l'environnement virtuel. * Installez Flask et feedparser (pour faciliter l'analyse XML) dans l'environnement virtuel. 2. Développez l'application Flask (app.py) : * Créez un fichier Python app.py * Initialisez une application Flask * Définissez une route pour l'URL racine (/). * Dans la fonction de route : * Lisez et analysez le fichier feed.xml à l'aide de feedparser. * Triez les articles de blog par date de publication dans l'ordre décroissant (les plus récents en premier). * Affichez un modèle HTML (index.html) en lui transmettant les entrées de blog triées. 3. Créez un modèle HTML (templates/index.html) : * Créez un répertoire nommé "templates". * Dans "templates", créez le fichier "index.html". * Ce modèle : * Affiche un titre pour les articles de blog. * Parcourt la liste des articles de blog * Pour chaque entrée, il affiche la date de publication et un titre cliquable qui renvoie à l'URL de l'article de blog et s'ouvre dans un nouvel onglet. 4. Exécutez le serveur Web Flask : * Définissez la variable d'environnement FLASK_APP sur app.py. * Démarrez le serveur de développement Flask sur le port 5000. Approuvez-vous ce plan ?

5. Lorsque Gemini CLI vous demande d'approuver le plan, saisissez yes, puis appuyez sur Entrée.

   Gemini CLI commence à implémenter les modifications. Dans cet atelier, acceptez chaque requête de Gemini CLI.

6. Chaque fois que Gemini CLI vous demande si vous souhaitez continuer, appuyez sur Entrée pour autoriser l'utilisation de l'outil.

   Après plusieurs étapes que vous devrez confirmer, Gemini CLI devrait créer et démarrer l'application.

   Remarque : Si l'outil Shell indique que l'application Flask est diffusée, vous pouvez passer à l'étape suivante, même si le prompt n'a pas encore produit de réponse.

7. Pour exécuter l'application dans le navigateur Web, cliquez sur Aperçu sur le Web, puis sélectionnez Prévisualiser sur le port 8080.

   

   Un nouvel onglet s'ouvre dans le navigateur et l'application s'exécute. Vous pouvez cliquer sur un lien pour ouvrir l'article de blog dans un nouvel onglet.

   L'application est probablement assez simple. Vous pouvez demander à Gemini CLI de l'améliorer.

8. Si l'outil Shell est toujours en cours d'exécution, appuyez sur Échap pour l'annuler.

9. Pour demander à Gemini CLI de modifier l'application, revenez dans Gemini CLI et envoyez le prompt suivant :

   Voici quelques modifications que j'aimerais apporter. Comme précédemment, je souhaite d'abord approuver le plan. 1. Les liens sur index.html ouvrent désormais une nouvelle page appelée entry.html. 2. La nouvelle page, entry.html, accepte un paramètre de requête qui contient une version encodée en URL de l'identifiant unique de l'entrée et affiche toutes les informations de l'article de blog du flux dans un format lisible. 3. Un lien en haut de la page entry.html doit ouvrir l'article de blog dans un nouvel onglet. 4. Ajoute un bouton "Retour" sur la page entry.html pour revenir à index.html. 5. Ajoute du CSS pour rendre l'application agréable à regarder et utilise les couleurs bleue et verte du logo Google.

   Gemini réfléchit à la requête, puis élabore un plan. Examinez le plan fourni par Gemini CLI.

   La réponse peut ressembler à ceci :

   ✦ Voici un plan pour implémenter les modifications demandées : 1. Mettez à jour app.py : * Ajoutez une nouvelle route /entry : Cette route traitera les requêtes relatives aux articles de blog individuels. * Elle demandera un paramètre de requête GUID, qui sera l'identifiant unique de l'article de blog. * Elle analysera à nouveau feed.xml pour trouver l'article correspondant au GUID fourni. * Si l'article est trouvé, elle affichera un nouveau modèle entry.html en transmettant les données de l'article trouvé. * Si l'article n'est pas trouvé, elle redirigera vers la page d'accueil ou affichera une erreur. * Assurez-vous que la logique d'analyse de feed.xml est robuste : la route d'index continuera d'analyser feed.xml et de trier les entrées pour la liste principale. 2. Modifiez le fichier templates/index.html : * Mettez à jour les liens des articles : modifiez l'attribut href du titre de chaque article de blog pour qu'il pointe vers la nouvelle route /entry, en transmettant le GUID de l'article en tant que paramètre de requête encodé au format URL. * Lien vers le CSS : ajoutez une balise <link> dans la section <head> pour inclure le nouveau fichier style.css. 3. Créez le fichier templates/entry.html : * Nouveau fichier HTML : créez entry.html dans le répertoire "templates". * Affichez les détails de l'article : cette page affichera tous les détails de l'article de blog sélectionné, y compris : * Titre * Date de publication * Auteur (si disponible) * Description (le contenu HTML brut sera affiché, car il est déjà au format HTML dans le flux) * Lien vers le post d'origine : incluez un lien bien visible (par exemple, "Lire l'article d'origine") qui utilise entry.link et target="_blank" pour ouvrir l'article de blog d'origine dans un nouvel onglet. * Bouton "Retour" : ajoutez un lien ou un bouton qui renvoie à index.html à l'aide de url_for('index'). * Lien vers le CSS : ajoutez une balise <link> dans la section <head> pour inclure le nouveau fichier style.css. 4. Créez un fichier static/style.css : * Nouveau fichier CSS : créez un répertoire "static" et un fichier "style.css" à l'intérieur. * Style : appliquez des règles CSS à index.html et entry.html pour obtenir un rendu esthétique. J'utiliserai les couleurs de la marque Google : * Bleu Google : #4285F4 * Vert Google : #34A853 * La mise en page générale, la typographie, les styles de liens et les modèles de zones pour les entrées seront définis. 5. Redémarrez l'application Flask : * Le serveur Flask doit être redémarré pour prendre en compte les modifications apportées à app.py et les nouveaux fichiers de modèle/statiques. Approuvez-vous ce plan détaillé ?

10. Lorsque Gemini CLI vous demande d'approuver le plan, saisissez yes, puis appuyez sur Entrée.

11. Chaque fois que Gemini CLI vous demande si vous souhaitez continuer, appuyez sur Entrée pour autoriser l'utilisation de l'outil.

    Gemini CLI va à nouveau travailler sur les mises à jour et redémarrer le serveur Web.

12. Actualisez la page de l'application Web ou ouvrez un nouvel onglet à l'aide de l'aperçu Web.

    L'application mise à jour doit désormais inclure une page par article de blog et utiliser les couleurs bleue et verte de Google.

    Remarque : Si l'application semble inchangée, il est possible que Gemini CLI n'ait pas réussi à arrêter le serveur Web. Utilisez un prompt comme "kill the web server and restart it" (arrête le serveur Web et redémarre-le) pour aider Gemini CLI à redémarrer le serveur Web.

    Voici un exemple de page de blog générée par Gemini CLI :

    

Cliquez sur Vérifier ma progression pour valider les objectifs. Créer une application Web avec Gemini CLI

Facultatif : Après avoir validé votre progression à l'étape 5, vous pouvez utiliser Gemini CLI pour apporter d'autres modifications ou corrections à l'application.

Félicitations !

Vous avez installé Gemini CLI, l'avez configuré et lui avez fourni du contexte pour obtenir des réponses adaptées à vos besoins. Vous avez également utilisé Gemini CLI pour expliquer du code et créer une application.

Dernière modification du manuel : 22 octobre 2025

Dernier test de l'atelier : 22 octobre 2025

Copyright 2026 Google LLC Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms de société et de produit peuvent être des marques des sociétés auxquelles ils sont associés.