Herramientas Integradas

Referencia completa de las potentes herramientas integradas proporcionadas por Gemini CLI

Sistema de ArchivosComandos ShellHerramientas Web

Categorías de Herramientas

Herramientas integradas organizadas por funcionalidad para ayudarte a realizar diversas tareas

Herramientas del Sistema de Archivos

Herramientas para leer, escribir y gestionar archivos y directorios

`read_file`

Leer el contenido de un archivo

Parámetros:

path(string)requerido

Ruta al archivo a leer

Devuelve:

string - El contenido del archivo

Ejemplo de Uso:

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`

Escribir contenido en un archivo

Parámetros:

path(string)requerido

Ruta donde escribir el archivo

content(string)requerido

Contenido a escribir en el archivo

Devuelve:

string - Confirmación de éxito

Ejemplo de Uso:

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`

Listar archivos y directorios en una ruta dada

Parámetros:

path(string)requerido

Ruta del directorio a listar

recursive(boolean)

Si listar recursivamente

Devuelve:

array - Lista de archivos y directorios

Ejemplo de Uso:

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/"
]

Herramientas Shell

Herramientas para ejecutar comandos shell y scripts

`run_shell_command`

Ejecutar un comando shell

Parámetros:

command(string)requerido

El comando shell a ejecutar

cwd(string)

Directorio de trabajo para el comando

Devuelve:

object - Resultado del comando con stdout, stderr y código de salida

Ejemplo de Uso:

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`

Ejecutar un archivo de script

Parámetros:

script_path(string)requerido

Ruta al archivo de script

args(array)

Argumentos a pasar al script

Devuelve:

object - Resultado de ejecución del script

Ejemplo de Uso:

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
}

Herramientas Web

Herramientas para solicitudes web, búsquedas y contenido en línea

`web_fetch`

Obtener contenido de una URL

Parámetros:

url(string)requerido

URL para obtener contenido

headers(object)

Cabeceras de solicitud

Devuelve:

object - Respuesta con contenido, estado y cabeceras

Ejemplo de Uso:

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`

Buscar información en la web

Parámetros:

query(string)requerido

Consulta de búsqueda

num_results(number)

Número de resultados a devolver

Devuelve:

array - Lista de resultados de búsqueda

Ejemplo de Uso:

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..."
  }
]

Herramientas de Memoria

Herramientas para almacenar y recuperar información de sesión

`remember`

Almacenar información para uso posterior

Parámetros:

key(string)requerido

Clave bajo la cual almacenar la información

value(string)requerido

Valor a almacenar

Devuelve:

string - Confirmación de almacenamiento

Ejemplo de Uso:

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`

Recuperar información previamente almacenada

Parámetros:

key(string)requerido

Clave para recuperar información

Devuelve:

string - Valor almacenado

Ejemplo de Uso:

AI: Let me retrieve your preference.

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

Result: "prefer TypeScript for development"

Herramientas de Directorio

Herramientas para operaciones de directorio y navegación

`create_directory`

Crear un nuevo directorio

Parámetros:

path(string)requerido

Ruta del directorio a crear

recursive(boolean)

Si crear directorios padre recursivamente

Devuelve:

string - Confirmación de creación

Ejemplo de Uso:

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`

Obtener el directorio de trabajo actual

Parámetros:

Sin parámetros

Devuelve:

string - Ruta del directorio actual

Ejemplo de Uso:

AI: Let me check the current working directory.

Tool call: get_current_directory
Parameters: {}

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

Configuración de Herramientas

Configurar comportamiento y permisos de herramientas

Habilitar/Deshabilitar Herramientas

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

Tiempos de Espera de Herramientas

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

Recursos Relacionados

Aprende más sobre herramientas y personalización

API de Herramientas Herramientas Personalizadas Configuración