Eingebaute Tools

Vollständige Referenz für leistungsstarke eingebaute Tools von Gemini CLI

DateisystemShell-BefehleWeb-Tools

Tool-Kategorien

Eingebaute Tools nach Funktionalität organisiert, um Ihnen bei verschiedenen Aufgaben zu helfen

Dateisystem-Tools

Tools zum Lesen, Schreiben und Verwalten von Dateien und Verzeichnissen

read_file

Den Inhalt einer Datei lesen

Parameter:
path(string)erforderlich

Pfad zur zu lesenden Datei

Rückgabe:

string - Der Dateiinhalt

Verwendungsbeispiel:
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

Inhalt in eine Datei schreiben

Parameter:
path(string)erforderlich

Pfad, wo die Datei geschrieben werden soll

content(string)erforderlich

Inhalt, der in die Datei geschrieben werden soll

Rückgabe:

string - Erfolgsbestätigung

Verwendungsbeispiel:
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

Dateien und Verzeichnisse in einem gegebenen Pfad auflisten

Parameter:
path(string)erforderlich

Verzeichnispfad zum Auflisten

recursive(boolean)

Ob rekursiv aufgelistet werden soll

Rückgabe:

array - Liste von Dateien und Verzeichnissen

Verwendungsbeispiel:
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-Tools

Tools zur Ausführung von Shell-Befehlen und Skripten

run_shell_command

Einen Shell-Befehl ausführen

Parameter:
command(string)erforderlich

Der auszuführende Shell-Befehl

cwd(string)

Arbeitsverzeichnis für den Befehl

Rückgabe:

object - Befehlsergebnis mit stdout, stderr und Exit-Code

Verwendungsbeispiel:
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

Eine Skriptdatei ausführen

Parameter:
script_path(string)erforderlich

Pfad zur Skriptdatei

args(array)

Argumente, die an das Skript übergeben werden

Rückgabe:

object - Skript-Ausführungsergebnis

Verwendungsbeispiel:
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-Tools

Tools für Web-Anfragen, Suchen und Online-Inhalte

web_fetch

Inhalt von einer URL abrufen

Parameter:
url(string)erforderlich

URL, von der Inhalt abgerufen werden soll

headers(object)

Anfrage-Header

Rückgabe:

object - Antwort mit Inhalt, Status und Headern

Verwendungsbeispiel:
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

Informationen im Web suchen

Parameter:
query(string)erforderlich

Suchanfrage

num_results(number)

Anzahl der zurückzugebenden Ergebnisse

Rückgabe:

array - Liste der Suchergebnisse

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

Speicher-Tools

Tools zum Speichern und Abrufen von Sitzungsinformationen

remember

Informationen für späteren Gebrauch speichern

Parameter:
key(string)erforderlich

Schlüssel, unter dem die Information gespeichert wird

value(string)erforderlich

Zu speichernder Wert

Rückgabe:

string - Speicherbestätigung

Verwendungsbeispiel:
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

Zuvor gespeicherte Informationen abrufen

Parameter:
key(string)erforderlich

Schlüssel zum Abrufen der Information

Rückgabe:

string - Gespeicherter Wert

Verwendungsbeispiel:
AI: Let me retrieve your preference.

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

Result: "prefer TypeScript for development"

Verzeichnis-Tools

Tools für Verzeichnisoperationen und Navigation

create_directory

Ein neues Verzeichnis erstellen

Parameter:
path(string)erforderlich

Pfad des zu erstellenden Verzeichnisses

recursive(boolean)

Ob übergeordnete Verzeichnisse rekursiv erstellt werden sollen

Rückgabe:

string - Erstellungsbestätigung

Verwendungsbeispiel:
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

Das aktuelle Arbeitsverzeichnis abrufen

Parameter:

Keine Parameter

Rückgabe:

string - Aktueller Verzeichnispfad

Verwendungsbeispiel:
AI: Let me check the current working directory.

Tool call: get_current_directory
Parameters: {}

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

Tool-Konfiguration

Tool-Verhalten und Berechtigungen konfigurieren

Tools Aktivieren/Deaktivieren

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

Tool-Timeouts

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

Verwandte Ressourcen

Erfahren Sie mehr über Tools und Anpassungen

Tools APIBenutzerdefinierte ToolsKonfiguration