1. Objectif de cet atelier
Dans cet atelier pratique, vous allez installer et authentifier l'interface de ligne de commande Gemini, puis tester quelques cas d'utilisation de base.
Points abordés
- Comprendre les principes de base de la CLI Gemini
- Découvrez comment effectuer des tâches de base avec la CLI Gemini.
2. Avant de commencer
- Si vous ne disposez pas déjà d'un projet que vous pouvez utiliser, vous devrez en créer un dans la console GCP.
- Dans cet atelier, nous utiliserons GCP Cloud Shell pour effectuer les étapes ci-dessous. Ouvrez Cloud Shell et définissez le projet à l'aide de Cloud Shell.
- Ouvrez l'éditeur Cloud Shell de GCP en appuyant sur le bouton de l'éditeur Cloud Shell. Si la fenêtre pop-up "Autoriser Shell" s'affiche, cliquez dessus pour autoriser l'éditeur Cloud Shell.
- Vous pouvez vérifier si le projet est déjà authentifié à l'aide de la commande suivante.
gcloud auth list
- Exécutez la commande suivante dans Cloud Shell pour confirmer votre projet
gcloud config list project
- Si votre projet n'est pas défini, utilisez la commande suivante pour le définir :
gcloud config set project <YOUR_PROJECT_ID>
- Nous devons activer certains services pour exécuter cet atelier. Exécutez la commande suivante dans Cloud Shell.
gcloud services enable aiplatform.googleapis.com
3. Installation et authentification
Installation
La CLI Gemini est préinstallée dans l'éditeur GCP Cloud Shell . Si vous souhaitez l'utiliser, vous pouvez commencer tout de suite.
Vous pouvez également installer Gemini CLI dans votre environnement local.
Pour installer Gemini CLI dans votre environnement local, vous avez besoin de Nodejs 20 ou version ultérieure. Vous pouvez exécuter la commande suivante pour installer Gemini CLI.
npm install -g @google/gemini-cli
Pour passer à la dernière version , utilisez la commande suivante :
npm update -g @google/gemini-cli
Exécutez Gemini en saisissant la commande suivante dans votre terminal.
gemini
Authentification
Si vous utilisez l'éditeur Cloud Shell de GCP, vous devriez déjà être authentifié si vous avez accepté d'authentifier le shell lors de son exécution.
Si vous exécutez le code localement et que vous ne vous êtes pas encore authentifié, un écran semblable à celui ci-dessous s'affiche.
Vous pouvez également saisir /auth pour afficher l'écran ci-dessous.
Figure 1 : La CLI Gemini vous propose trois méthodes d'authentification.
Commencez par quitter la CLI Gemini avec la commande /quit.
S'authentifier avec Google : l'exécution de /auth dans la console affiche les options d'authentification. Sélectionnez "Se connecter avec Google" parmi les options. L'écran d'authentification Google s'affiche alors dans votre navigateur. Une fois que vous vous serez connecté, la console sera également authentifiée. Bien que l'authentification soit terminée, vous devez spécifier un projet Google Cloud pour pouvoir utiliser Gemini CLI. Revenez à l'écran de la console et exécutez la commande suivante pour spécifier le projet (vous pouvez également le spécifier dans un fichier .env).
export GOOGLE_CLOUD_PROJECT=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
S'authentifier avec une clé API : pour vous authentifier avec une clé API, vous devez en posséder une. Vous pouvez générer une clé API à partir de aistudio.google.com . Une fois la clé API émise, définissez-la dans la console comme suit :
export GEMINI_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
S'authentifier avec Vertex AI : pour utiliser l'API Gemini via Vertex AI, procédez comme suit.
Tout d'abord, utilisez la commande ci-dessous pour vous authentifier auprès de Google Cloud.
gcloud auth application-default login
Exécutez ensuite les commandes suivantes dans votre terminal.
export GOOGLE_GENAI_USE_VERTEXAI=true export GOOGLE_CLOUD_PROJECT=Your GCP Project Name export GOOGLE_CLOUD_LOCATION=us-central1
4. Essayer la CLI Gemini
Vous êtes maintenant prêt à essayer Gemini CLI. Essayez les cas d'utilisation suivants.
Commencez par créer un dossier de projet, my_cli_project.
mkdir my_cli_project cd my_cli_project
Exécuter Gemini à partir d'un dossier de projet vous permet d'exécuter la CLI Gemini de manière sécurisée dans les limites de ce dossier.
- Exécuter un prompt simple :
What is the weather today in Tokyo
Vous devriez obtenir la météo à Tokyo. Notez que l'exécution automatique de cette commande utilise
Outil Recherche Google !
- Vérifiez les outils installés : exécutez la commande suivante. La liste des outils installés devrait s'afficher.
/tools
Figure 2 : Liste des outils affichés
- Recevoir des actualités d'un site d'actualités local (par exemple, https://mainichi.jp, remplacez-le par le site d'actualités local de votre choix).
Get me the news summary from https://mainichi.jp/
Vous devriez recevoir un résumé de l'actualité du site d'informations locales. Notez que l'agent utilise automatiquement l'outil WebFetch pour télécharger le contenu du site d'actualités et créer le résumé.
- Exécute une tâche en plusieurs étapes(veuillez la modifier pour l'adapter à votre site local) : donne-moi les actualités de https://mainichi.jp/, filtre-les pour ne garder que les actualités sportives et résume-les.
Get me the news from https://mainichi.jp/ and filter in only the sports news and summarize that for me.
- Exécuter des commandes système : appuyez sur ! pour exécuter des commandes système. et saisissez les commandes. Pour revenir au mode normal, saisissez !. à nouveau.
Type ! and Enter key. This starts the command mode. ls pwd Type ! to go back to normal mode.
- Créez un jeu de morpion. Saisissez la requête suivante (version anglaise).
Please develop a Tic-Tac-Toe game that meets the following requirements. The solution should be split into separate HTML, CSS, and JavaScript files, with the JavaScript file handling the majority of the game logic independently.
1. General Requirements
The game format should be a match between one human player and one computer player.
When the game ends (a win/loss is determined, or a draw occurs), display "GAME OVER" on the screen along with the winner's name ("X wins!," "O wins!," or "Draw!").
Provide a "Reset" button to start a new game.
2. HTML (index.html)
Create the basic page structure.
The game board should consist of nine squares (cells). Each cell should be clickable and display the player's mark (X or O).
Provide an element to display the game status (e.g., current player's turn, game result).
Place the reset button for starting a new game.
Link the CSS and JavaScript files appropriately.
3. CSS (style.css)
Style the game board and cells so they are visually clear and easy to understand.
Add borders to the cells to indicate they are clickable areas.
Set appropriate font size and color for the X and O marks to ensure good visibility.
Style the game status display and the "GAME OVER" message to make them stand out.
Consider responsive design to ensure appropriate display on various screen sizes.
4. JavaScript (script.js)
It is strongly requested that the JavaScript file handle all the game logic.
4.1. Game State Management
Define an array or object to manage the game board state (e.g., ['', '', '', '', '', '', '', '', '']).
Define a variable to track the current player (X or O). The initial value should be X.
Define a boolean value to track whether the game has ended (win/loss or draw).
4.2. Game Initialization
Create a function to initialize the game board upon page load.
Clear all cells.
Set the current player to X.
Reset the game end flag.
Clear the game result display.
4.3. Player Interaction
Set up event listeners for cell clicks.
Only place the current player's mark and update the board state if the clicked cell is empty.
After placing the mark, execute the following:
Call the win/draw check function.
If a winner is not yet determined, switch the player (X to O, O to X).
4.4. Computer AI Logic
Create a function that is called when it is the computer's (O) turn.
Implement a simple logic where the computer randomly selects an empty cell to place its mark. (While difficulty can be increased in the future, random selection is sufficient initially.)
After the computer places its mark, perform the win/draw check, and if the game is not over, switch the turn back to the human player.
4.5. Win/Draw Determination
Create a function that determines the win/draw status based on the current board state.
Check the following winning conditions:
Three rows
Three columns
Two diagonals
If a player meets a winning condition, declare that player the winner.
If all cells are filled and no player meets a winning condition, declare a draw.
If a win or draw is determined, set the game end flag to true and display the "GAME OVER" message and the result.
4.6. Game End Handling
When the game ends (win/loss or draw), prevent further clicks on the cells.
Display the text "GAME OVER" followed by the message "X wins!," "O wins!," or "Draw!" underneath it.
4.7. Reset Functionality
When the "Reset" button is clicked, call the function to return the game to its initial state.
Saisissez la requête suivante (version japonaise)
以下の要件を満たす三目並べ（Tic-Tac-Toe）ゲームを開発してください。HTML、CSS、JavaScriptの各ファイルに分割し、JavaScriptはゲームロジックの大部分を単独で処理するようにしてください。
1. 全体要件
プレイヤーは人間1人、コンピューター1人の対戦形式とする。
ゲーム終了時（勝敗が決まった場合、または引き分けの場合）は、画面上に「GAME OVER」と表示し、勝者の名前（「Xの勝利！」「Oの勝利！」または「引き分け！」）も併記すること。
新しいゲームを開始するための「リセット」ボタンを設けること。
2. HTML (index.html)
基本的なページ構造を作成してください。
ゲームボードは、9つのマス目（セル）で構成されるようにしてください。各セルはクリック可能で、プレイヤーのマーク（XまたはO）が表示されるようにします。
ゲームの状態（現在のプレイヤーのターン、ゲーム結果など）を表示する要素を設けてください。
ゲームをリセットするためのボタンを配置してください。
CSSファイルとJavaScriptファイルを適切にリンクしてください。
3. CSS (style.css)
ゲームボードとマス目が視覚的に分かりやすいようにスタイルを設定してください。
マス目には枠線をつけ、クリック可能な領域であることがわかるようにする。
XとOの表示は、見やすいように適切なフォントサイズと色を設定する。
ゲームの状態表示、および「GAME OVER」メッセージが目立つようにスタイルを設定してください。
レスポンシブデザインを考慮し、様々な画面サイズで適切に表示されるようにしてください。
4. JavaScript (script.js)
JavaScriptファイルがゲームロジックの全てを処理することを強く要請します。
4.1. ゲームの状態管理
ゲームボードの状態を管理する配列またはオブジェクト（例: ['', '', '', '', '', '', '', '', '']）を定義してください。
現在のプレイヤー（XまたはO）を追跡する変数を定義してください。初期値はXとする。
ゲームが終了したかどうか（勝敗が決まったか、引き分けか）を追跡するブール値を定義してください。
4.2. ゲームの初期化
ページ読み込み時にゲームボードを初期化する関数を作成してください。
全てのマス目を空にする。
現在のプレイヤーをXに設定する。
ゲーム終了フラグをリセットする。
ゲーム結果表示をクリアする。
4.3. プレイヤーの操作
マス目をクリックした際のイベントリスナーを設定してください。
クリックされたマス目が空の場合のみ、現在のプレイヤーのマークを配置し、ボードの状態を更新する。
マークを配置した後、以下の処理を実行する。
勝敗判定関数を呼び出す。
勝敗が決まっていない場合、プレイヤーを交代する（XからO、OからXへ）。
4.4. コンピューターの思考ロジック
コンピューター（O）が手番の時に呼び出される関数を作成してください。
コンピューターは、空いているマス目の中からランダムに選択してマークを配置するシンプルなロジックを実装してください。（将来的に難易度を上げることも考慮できるが、最初はランダムで十分です）
コンピューターがマークを配置した後、勝敗判定を行い、勝敗が決まっていない場合はプレイヤーを人間に戻す。
4.5. 勝敗判定
現在のボードの状態に基づいて勝敗を判定する関数を作成してください。
以下の勝利条件をチェックする。
3つの行
3つの列
2つの対角線
勝利条件を満たすプレイヤーがいる場合、そのプレイヤーの勝利とする。
全てのマス目が埋まり、かつ勝利条件を満たすプレイヤーがいない場合、引き分けとする。
勝敗または引き分けが決まった場合、ゲーム終了フラグをtrueに設定し、「GAME OVER」メッセージと結果を表示する。
4.6. ゲーム終了時の処理
ゲームが終了した場合（勝敗が決まったか、引き分けか）は、それ以上マス目をクリックできないようにする。
「GAME OVER」というテキストと、その下に「Xの勝利！」「Oの勝利！」または「引き分け！」というメッセージを表示する。
4.7. リセット機能
「リセット」ボタンがクリックされた際に、ゲームを初期状態に戻す関数を呼び出す。
Ouvrez un terminal dans le même dossier et démarrez un serveur HTTP.
python3 -m http.server 8080
Dans le navigateur, ouvrez (CTRL+clic si vous êtes dans Cloud Shell) :
http://localhost:8080
5. Exécuter les extensions de la CLI Gemini
La CLI Gemini fournit des extensions très utiles qui peuvent être installées et exécutées facilement. Ces extensions vous permettent de vous connecter à différents services et de les utiliser. https://geminicli.com/extensions/ : liste des extensions disponibles, qui s'allonge chaque jour. Pour en savoir plus sur les extensions de la CLI Gemini, consultez cette page : https://medium.com/google-cloud/gemini-cli-tutorial-series-part-11-gemini-cli-extensions-69a6f2abb659.
Installons une extension Gemini Nanobanana et exécutons-la.
Pour installer l'extension, exécutez la commande suivante :
gemini extensions install https://github.com/gemini-cli-extensions/nanobanana
Une fois l'extension installée, redémarrez Gemini CLI. Vous pourrez alors exécuter les commandes nanobanana suivantes à partir de Gemini CLI.
/generate: génération d'une ou plusieurs images avec des options de style/variation/edit: retouche photo/restore: restauration d'images/icon: générer des icônes d'application, des favicons et des éléments d'UI de différentes tailles/pattern: générer des motifs et des textures homogènes pour les arrière-plans/story: générer des images séquentielles qui racontent une histoire ou un processus visuel/diagram: générer des diagrammes techniques, des organigrammes et des maquettes d'architecture/nanobanana– Interface en langage naturel
Exécutons quelques commandes
Avant d'exécuter Nanobanana, vous devez obtenir une clé API Gemini sur aistudio.google.com et la définir ici.
export NANOBANANA_GEMINI_API_KEY=YOUR_API_KEY
Pour consulter la version en anglais,
# Single image /generate "a watercolor painting of a fox in a snowy forest" # Multiple variations with preview /generate "sunset over mountains" --count=3 --preview # Style variations /generate "mountain landscape" --styles="watercolor,oil-painting" --count=4 # Specific variations with auto-preview /generate "coffee shop interior" --variations="lighting,mood" --preview
Version japonaise
# Single image /generate "雪の森のキツネの水彩画" # Multiple variations with preview /generate "山にかかる夕焼け" --count=3 --preview # Style variations /generate "山岳風景" --styles="watercolor,oil-painting" --count=4 # Specific variations with auto-preview /generate "コーヒーショップのインテリア" --variations="lighting,mood" --preview
Modifier les images
Remplacez le nom du fichier par le nom de votre fichier local.
/edit my_photo.png "change the color of fox to blue"
6. Terminé
Et voilà ! Bravo ! Pour en savoir plus, consultez les ressources suivantes.