Outils Intégrés

Référence complète des outils intégrés puissants fournis par Gemini CLI

Système de FichiersCommandes ShellOutils Web

Catégories d'Outils

Outils intégrés organisés par fonctionnalité pour vous aider à accomplir diverses tâches

Outils de Système de Fichiers

Outils pour lire, écrire et gérer les fichiers et répertoires

`read_file`

Lire le contenu d'un fichier

Paramètres:

path(string)requis

Chemin vers le fichier à lire

Retourne:

string - Le contenu du fichier

Exemple d'Utilisation:

AI: I'll read the package.json file for you.

Tool call: read_file
Parameters: {"path": "./package.json"}

Result: {
  "name": "my-project",
  "version": "1.0.0",
  "dependencies": {
    "express": "^4.18.0"
  }
}

`write_file`

Écrire du contenu dans un fichier

Paramètres:

path(string)requis

Chemin où écrire le fichier

content(string)requis

Contenu à écrire dans le fichier

Retourne:

string - Confirmation de succès

Exemple d'Utilisation:

AI: I'll create a new README file for you.

Tool call: write_file
Parameters: {
  "path": "./README.md",
  "content": "# My Project\n\nThis is a sample project."
}

Result: File written successfully to ./README.md

`list_files`

Lister les fichiers et répertoires dans un chemin donné

Paramètres:

path(string)requis

Chemin du répertoire à lister

recursive(boolean)

S'il faut lister récursivement

Retourne:

array - Liste des fichiers et répertoires

Exemple d'Utilisation:

AI: Let me list the files in the src directory.

Tool call: list_files
Parameters: {"path": "./src", "recursive": false}

Result: [
  "index.js",
  "utils.js",
  "components/",
  "styles/"
]

Outils Shell

Outils pour exécuter des commandes shell et des scripts

`run_shell_command`

Exécuter une commande shell

Paramètres:

command(string)requis

La commande shell à exécuter

cwd(string)

Répertoire de travail pour la commande

Retourne:

object - Résultat de commande avec stdout, stderr et code de sortie

Exemple d'Utilisation:

AI: I'll check the current Git status.

Tool call: run_shell_command
Parameters: {"command": "git status --porcelain"}

Result: {
  "stdout": " M src/index.js\n?? new-file.txt",
  "stderr": "",
  "exitCode": 0
}

`run_script`

Exécuter un fichier de script

Paramètres:

script_path(string)requis

Chemin vers le fichier de script

args(array)

Arguments à passer au script

Retourne:

object - Résultat d'exécution du script

Exemple d'Utilisation:

AI: I'll run the build script with production flag.

Tool call: run_script
Parameters: {
  "script_path": "./scripts/build.sh",
  "args": ["--production"]
}

Result: {
  "stdout": "Building for production...\nBuild completed successfully!",
  "stderr": "",
  "exitCode": 0
}

Outils Web

Outils pour les requêtes web, les recherches et le contenu en ligne

`web_fetch`

Récupérer le contenu d'une URL

Paramètres:

url(string)requis

URL pour récupérer le contenu

headers(object)

En-têtes de requête

Retourne:

object - Réponse avec contenu, statut et en-têtes

Exemple d'Utilisation:

AI: I'll fetch data from the API endpoint.

Tool call: web_fetch
Parameters: {"url": "https://api.github.com/repos/google-gemini/gemini-cli"}

Result: {
  "status": 200,
  "content": "{\"name\": \"gemini-cli\", \"description\": \"...\"}"
}

`web_search`

Rechercher des informations sur le web

Paramètres:

query(string)requis

Requête de recherche

num_results(number)

Nombre de résultats à retourner

Retourne:

array - Liste des résultats de recherche

Exemple d'Utilisation:

AI: I'll search for information about Gemini CLI.

Tool call: web_search
Parameters: {"query": "Gemini CLI documentation", "num_results": 5}

Result: [
  {
    "title": "Gemini CLI Official Documentation",
    "url": "https://docs.geminicli.cloud",
    "snippet": "Complete documentation for Gemini CLI..."
  }
]

Outils Mémoire

Outils pour stocker et récupérer les informations de session

`remember`

Stocker des informations pour une utilisation ultérieure

Paramètres:

key(string)requis

Clé sous laquelle stocker l'information

value(string)requis

Valeur à stocker

Retourne:

string - Confirmation de stockage

Exemple d'Utilisation:

AI: I'll remember your preference.

Tool call: remember
Parameters: {"key": "user_preference", "value": "prefer TypeScript for development"}

Result: Information stored under key 'user_preference'

`recall`

Récupérer des informations précédemment stockées

Paramètres:

key(string)requis

Clé pour récupérer l'information

Retourne:

string - Valeur stockée

Exemple d'Utilisation:

AI: Let me retrieve your preference.

Tool call: recall
Parameters: {"key": "user_preference"}

Result: "prefer TypeScript for development"

Outils de Répertoire

Outils pour les opérations de répertoire et la navigation

`create_directory`

Créer un nouveau répertoire

Paramètres:

path(string)requis

Chemin du répertoire à créer

recursive(boolean)

S'il faut créer les répertoires parents récursivement

Retourne:

string - Confirmation de création

Exemple d'Utilisation:

AI: I'll create a new project directory.

Tool call: create_directory
Parameters: {"path": "./src/components", "recursive": true}

Result: Directory './src/components' created successfully

`get_current_directory`

Obtenir le répertoire de travail actuel

Paramètres:

Aucun paramètre

Retourne:

string - Chemin du répertoire actuel

Exemple d'Utilisation:

AI: Let me check the current working directory.

Tool call: get_current_directory
Parameters: {}

Result: "/Users/username/projects/my-app"

Configuration des Outils

Configurer le comportement et les permissions des outils

Activer/Désactiver les Outils

gemini config set tools-enabled truegemini config set file-tools-enabled falsegemini config set web-tools-enabled true

Délais d'Expiration des Outils

gemini config set tool-timeout 30gemini config set web-timeout 10gemini config set shell-timeout 60

Ressources Connexes

En savoir plus sur les outils et la personnalisation

API Outils Outils Personnalisés Configuration