Встроенные инструменты

Полный справочник мощных встроенных инструментов, предоставляемых Gemini CLI

Файловая системаShell командыВеб-инструменты

Категории инструментов

Встроенные инструменты, организованные по функциональности, чтобы помочь вам выполнять различные задачи

Инструменты файловой системы

Инструменты для чтения, записи и управления файлами и каталогами

`read_file`

Прочитать содержимое файла

Параметры:

path(string)обязательно

Путь к файлу для чтения

Возвращает:

string - Содержимое файла

Пример использования:

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`

Записать содержимое в файл

Параметры:

path(string)обязательно

Путь для записи файла

content(string)обязательно

Содержимое для записи в файл

Возвращает:

string - Подтверждение успеха

Пример использования:

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`

Список файлов и каталогов по указанному пути

Параметры:

path(string)обязательно

Путь каталога для списка

recursive(boolean)

Нужно ли перечислять рекурсивно

Возвращает:

array - Список файлов и каталогов

Пример использования:

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

Shell инструменты

Инструменты для выполнения shell команд и скриптов

`run_shell_command`

Выполнить shell команду

Параметры:

command(string)обязательно

Shell команда для выполнения

cwd(string)

Рабочий каталог для команды

Возвращает:

object - Результат команды с stdout, stderr и кодом выхода

Пример использования:

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`

Выполнить файл скрипта

Параметры:

script_path(string)обязательно

Путь к файлу скрипта

args(array)

Аргументы для передачи скрипту

Возвращает:

object - Результат выполнения скрипта

Пример использования:

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
}

Веб-инструменты

Инструменты для веб-запросов, поиска и онлайн-контента

`web_fetch`

Получить содержимое с URL

Параметры:

url(string)обязательно

URL для получения содержимого

headers(object)

Заголовки запроса

Возвращает:

object - Ответ с содержимым, статусом и заголовками

Пример использования:

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`

Поиск информации в интернете

Параметры:

query(string)обязательно

Поисковый запрос

num_results(number)

Количество результатов для возврата

Возвращает:

array - Список результатов поиска

Пример использования:

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

Инструменты памяти

Инструменты для хранения и извлечения информации сеанса

`remember`

Сохранить информацию для последующего использования

Параметры:

key(string)обязательно

Ключ для хранения информации

value(string)обязательно

Значение для хранения

Возвращает:

string - Подтверждение сохранения

Пример использования:

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`

Извлечь ранее сохраненную информацию

Параметры:

key(string)обязательно

Ключ для извлечения информации

Возвращает:

string - Сохраненное значение

Пример использования:

AI: Let me retrieve your preference.

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

Result: "prefer TypeScript for development"

Инструменты каталогов

Инструменты для операций с каталогами и навигации

`create_directory`

Создать новый каталог

Параметры:

path(string)обязательно

Путь каталога для создания

recursive(boolean)

Нужно ли рекурсивно создавать родительские каталоги

Возвращает:

string - Подтверждение создания

Пример использования:

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`

Получить текущий рабочий каталог

Параметры:

Нет параметров

Возвращает:

string - Путь текущего каталога

Пример использования:

AI: Let me check the current working directory.

Tool call: get_current_directory
Parameters: {}

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

Конфигурация инструментов

Настройка поведения и разрешений инструментов

Включить/Отключить инструменты

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

Таймауты инструментов

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

Связанные ресурсы

Узнайте больше об инструментах и настройке

API инструментов Пользовательские инструменты Конфигурация