In diesem Dokument wird beschrieben, wie Sie den Gemini Code Assist-Agent-Modus als Pair-Programmierer in Ihrer integrierten Entwicklungsumgebung (IDE) konfigurieren und verwenden.
Im Agent-Modus können Sie unter anderem Folgendes tun:
- Fragen zu Ihrem Code stellen
- Kontext und integrierte Tools nutzen, um generierte Inhalte zu verbessern
- Konfigurieren Sie MCP-Server, um die Funktionen des Agents zu erweitern.
- Lösungen für komplexe Aufgaben mit mehreren Schritten erhalten
- Code aus Designdokumenten, Problemen und
TODO
-Kommentaren generieren - Sie können das Verhalten des Agents steuern, indem Sie Pläne und die Verwendung von Tools während der Ausführung kommentieren, bearbeiten und genehmigen.
Beschränkungen
Einige Funktionen des Standard-Gemini Code Assist-Chats sind im Agent-Modus möglicherweise nicht verfügbar oder funktionieren anders als im Standard-Chat.
Die Rezitation ist im KI‑Agentenmodus nicht verfügbar. Im Agent-Modus werden keine Quellen zitiert und Sie können keine Codevorschläge deaktivieren, die mit zitierten Quellen übereinstimmen.
Hinweise
VS Code
IntelliJ
KI‑Agent-Modus verwenden
Im Agent-Modus können Sie Gemini bitten, übergeordnete Ziele und komplexe Aufgaben zu erledigen.
Damit Sie den Agent-Modus optimal nutzen können, sollten Sie die Best Practices für Prompts beachten und so viele Details wie möglich angeben.
So wechseln Sie in den Agent-Modus:
VS Code
- Klicken Sie in der Aktivitätsleiste Ihrer IDE auf spark Gemini Code Assist, um den Gemini Code Assist-Chat zu öffnen.
- Klicken Sie auf die Ein/Aus-Schaltfläche Agent, um den Agent-Modus aufzurufen. Der Schalter wird hervorgehoben, wenn er auf den Agentenmodus eingestellt ist, und grau, wenn er sich im normalen Chat befindet.
- Geben Sie im Gemini Code Assist-Chat Ihren Prompt ein.
Gemini gibt eine Antwort auf Ihren Prompt aus oder fordert die Berechtigung zur Verwendung eines Tools an.
Klicken Sie auf
Beenden, um den Agent zu beenden.Wenn Sie den Standard-Chat von Gemini Code Assist verwenden möchten, klicken Sie auf
Neuer Chat, um einen neuen Chat zu erstellen.Der Gemini Code Assist-Agent-Modus basiert auf der Gemini CLI.
IntelliJ
- Klicken Sie in der Leiste des Toolfensters auf spark Gemini. Melden Sie sich an, wenn Sie dazu aufgefordert werden.
- Wählen Sie den Tab Agent aus.
- Beschreiben Sie die Aufgabe, die der Agent ausführen soll.
Während der Kundenservicemitarbeiter die Schritte zur Erledigung der Aufgabe durchgeht, haben Sie die Möglichkeit, alle Änderungen zu prüfen und zu genehmigen.
Optional: Wenn Sie Änderungen automatisch genehmigen möchten, wählen Sie die Einstellungen Agent-Optionen aus und klicken Sie das Kästchen neben Änderungen automatisch genehmigen an.
Tools für den Agent-Modus konfigurieren
Tools sind eine breite Kategorie von Diensten, die ein Agent für Kontext und Aktionen in seiner Antwort auf Ihren Prompt verwenden kann. Beispiele für Tools sind integrierte Tools wie „grep“ und „file read or write“, lokale oder Remote-MCP-Server (Model Context Protocol) und ihre ausführbaren Funktionen oder benutzerdefinierte Dienstimplementierungen.
Verwendung integrierter Tools steuern
Im Agent-Modus haben Sie Zugriff auf Ihre integrierten Tools wie Dateisuche, Dateilesen, Dateischreiben, Terminalbefehle und mehr.
VS Code
Mit den Einstellungen für coreTools
und excludeTools
können Sie festlegen, auf welche Tools Gemini im Agent-Modus zugreifen darf.
coreTools
- Ermöglicht die Angabe einer Liste von Tools, die für das Modell verfügbar sein sollen. Sie können auch befehlsspezifische Einschränkungen für Tools angeben, die diese Funktion unterstützen. Wenn Sie beispielsweise Folgendes in die JSON-Datei für Ihre Gemini-Einstellungen einfügen, darf nur der Shell-Befehl
ls -l
ausgeführt werden:"coreTools": ["ShellTool(ls -l)"]
. excludeTools
- Ermöglicht es Ihnen, eine Liste von Tools anzugeben, die für das Modell nicht verfügbar sein sollen. Sie können auch befehlsspezifische Einschränkungen für Tools angeben, die diese Funktion unterstützen. Wenn Sie beispielsweise Folgendes in die JSON-Datei für Ihre Gemini-Einstellungen einfügen, wird die Verwendung des Befehls
rm -rf
blockiert:"excludeTools": ["ShellTool(rm -rf)"]
.
Ein Tool, das sowohl in excludeTools
als auch in coreTools
aufgeführt ist, wird ausgeschlossen.
So konfigurieren Sie die integrierten Tools, die im Agent-Modus verfügbar sind:
- Öffnen Sie die JSON-Datei mit Ihren Gemini-Einstellungen unter
~/.gemini/settings.json
, wobei~
Ihr Home-Verzeichnis ist. Wenn Sie die Verwendung von Agent-Tools auf eine Liste genehmigter Tools beschränken möchten, fügen Sie der JSON-Datei für Ihre Gemini-Einstellungen die folgende Zeile hinzu:
"coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
Ersetzen Sie
TOOL_NAME_1
undTOOL_NAME_2
durch die Namen der integrierten Tools, auf die der Agent Zugriff haben soll.Sie können beliebig viele integrierte Tools auflisten. Standardmäßig sind alle integrierten Tools für den Agenten verfügbar.
Wenn Sie die Verwendung von Agent-Tools auf bestimmte Tool-Befehle beschränken möchten, fügen Sie die folgende Zeile in Ihre JSON-Datei mit den Gemini-Einstellungen ein:
"coreTools": ["TOOL_NAME(COMMAND)"]
Ersetzen Sie Folgendes:
TOOL_NAME
: der Name des integrierten ToolsCOMMAND
: Der Name des integrierten Tool-Befehls, den der Agent verwenden können soll.
Wenn Sie ein Tool von der Verwendung durch den Agenten ausschließen möchten, fügen Sie der JSON-Datei mit Ihren Gemini-Einstellungen die folgende Zeile hinzu:
"excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
Ersetzen Sie
TOOL_NAME_1
undTOOL_NAME_2
durch die Namen der integrierten Tools, die Sie von der Verwendung durch den Agent ausschließen möchten.Wenn Sie einen Tool-Befehl von der Verwendung durch den Agenten ausschließen möchten, fügen Sie die folgende Zeile in Ihre JSON-Datei mit den Gemini-Einstellungen ein:
"excludeTools": ["TOOL_NAME(COMMAND)"]
Ersetzen Sie Folgendes:
TOOL_NAME
: der Name des integrierten ToolsCOMMAND
: Der Name des integrierten Toolbefehls, den Sie von der Verwendung durch den Agenten ausschließen möchten.
Weitere Informationen zu den Konfigurationseinstellungen für coreTools
und excludeTools
finden Sie in der Dokumentation zur Gemini-CLI-Konfiguration.
IntelliJ
Diese Funktion wird in Gemini Code Assist für IntelliJ oder anderen JetBrains-IDEs nicht unterstützt.
MCP-Server konfigurieren
VS Code
Wenn Sie festlegen möchten, welche Server im Agent-Modus verfügbar sind, fügen Sie sie gemäß der Serverdokumentation zu Ihrer JSON-Datei mit den Gemini-Einstellungen hinzu.
- Installieren Sie alle Abhängigkeiten, die für Ihren MCP-Server erforderlich sind.
- Öffnen Sie die JSON-Datei mit Ihren Gemini-Einstellungen unter
~/.gemini/settings.json
, wobei~
Ihr Home-Verzeichnis ist. Fügen Sie Ihrer JSON-Datei für die Gemini-Einstellungen gemäß den Serveranweisungen lokale oder Remote-MCP-Server hinzu.
Im folgenden Beispiel wird der Remote-Cloudflare-MCP-Server hinzugefügt und die GitHub- und GitLab-Server werden auf dem lokalen Computer installiert.
{ "mcpServers": { "github": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345" } }, "gitlab": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-gitlab" ] }, "cloudflare-observability": { "command": "npx", "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"] }, "cloudflare-bindings": { "command": "npx", "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"] } } }
Öffnen Sie die Befehlspalette und wählen Sie Entwickler: Fenster neu laden aus.
Ihre konfigurierten MCP-Server stehen dem Agent im Agent-Modus zur Verfügung.
IntelliJ
Wenn Sie festlegen möchten, welche Server im Agent-Modus verfügbar sind, fügen Sie sie einer mcp.json
-Datei hinzu und legen Sie diese im Konfigurationsverzeichnis für Ihre IDE ab.
- Installieren Sie alle Abhängigkeiten, die für Ihren MCP-Server erforderlich sind.
- Erstellen Sie eine
mcp.json
-Datei im Konfigurationsverzeichnis Ihrer IDE. Fügen Sie Ihrer JSON-Datei für die Gemini-Einstellungen gemäß den Serveranweisungen lokale oder Remote-MCP-Server hinzu.
Im folgenden Beispiel wird der Remote-Cloudflare-MCP-Server hinzugefügt und die GitHub- und GitLab-Server werden auf dem lokalen Computer installiert.
{ "mcpServers": { "github": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345" } }, "gitlab": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-gitlab" ] }, "cloudflare-observability": { "command": "npx", "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"] }, "cloudflare-bindings": { "command": "npx", "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"] } } }
Ihre konfigurierten MCP-Server stehen dem Agent im Agent-Modus zur Verfügung.
MCP-Serverauthentifizierung
Für einige MCP-Server ist eine Authentifizierung erforderlich. Folgen Sie der Serverdokumentation, um alle erforderlichen Nutzer-Tokens zu erstellen.
VS Code
MCP-Server, für die eine Authentifizierung erforderlich ist, können Sie der JSON-Datei für Ihre Gemini-Einstellungen hinzufügen.
Im folgenden Beispiel wird ein persönliches Zugriffstoken für GitHub hinzugefügt:
{ //other settings... "github": { "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server", "args": ["stdio"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN" } }, // other settings... }
Dabei ist ACCESS_TOKEN
das Zugriffstoken des Nutzers.
IntelliJ
MCP-Server, für die eine Authentifizierung erforderlich ist, können Sie der Datei mcp.json
hinzufügen.
Im folgenden Beispiel wird ein persönliches Zugriffstoken für GitHub hinzugefügt:
{ //other settings... "github": { "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server", "args": ["stdio"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN" } }, // other settings... }
Dabei ist ACCESS_TOKEN
das Zugriffstoken des Nutzers.
Kontextdatei erstellen
Kontext ermöglicht es einem Agent, bessere Antworten auf einen bestimmten Prompt zu generieren. Der Kontext kann aus Dateien in Ihrer IDE, Dateien in Ihren lokalen Systemordnern, Tool-Antworten und Ihren Promptdetails stammen. Weitere Informationen finden Sie unter Kontext des Agent-Modus.
VS Code
Erstellen Sie eine Datei mit dem Namen
GEMINI.md
an einem Speicherort, der dem Bereich entspricht, auf den sich der Kontext beziehen soll. In der folgenden Tabelle sind die Speicherorte für Kontextdateien für verschiedene Bereiche aufgeführt:Umfang Standort Alle Ihre Projekte ~/.gemini/GEMINI.md
Ein bestimmtes Projekt Ihr Arbeitsverzeichnis oder alle übergeordneten Verzeichnisse bis zum Projektstammverzeichnis (durch einen .git
-Ordner gekennzeichnet) oder Ihrem Home-Verzeichnis.Eine bestimmte Komponente, ein bestimmtes Modul oder ein bestimmter Unterabschnitt eines Projekts Unterverzeichnisse Ihres Arbeitsverzeichnisses. Das Speichersystem des Agents wird durch das Laden von Kontextdateien von mehreren Speicherorten erstellt. Kontext aus spezifischeren Dateien, z. B. für bestimmte Komponenten oder Module, überschreibt oder ergänzt Inhalte aus allgemeineren Kontextdateien wie der globalen Kontextdatei unter
~/.gemini/GEMINI.md
.Schreiben Sie alle Regeln, Styleguide-Informationen oder den Kontext, die der Agent verwenden soll, in Markdown und speichern Sie die Datei. Weitere Informationen finden Sie in der Beispielkontextdatei auf GitHub.
Der Agent berücksichtigt die Informationen in Ihrer Kontextdatei zusammen mit allen Prompts, die Sie an ihn senden.
IntelliJ
Erstellen Sie im Stammverzeichnis Ihres Projekts eine Datei mit dem Namen
GEMINI.md
oderAGENT.md
.Schreiben Sie alle Regeln, Styleguide-Informationen oder den Kontext, die der Agent verwenden soll, in Markdown und speichern Sie die Datei.
Der Agent berücksichtigt die Informationen in Ihrer Kontextdatei zusammen mit allen Prompts, die Sie an ihn senden. Sie können auch Kontext hinzufügen, indem Sie eine Datei manuell mit der Syntax @
FILENAME
einfügen. Dabei ist FILENAME
der Name der Datei mit den Kontextinformationen, die Sie einfügen möchten.
Befehle verwenden
Mit /
-Befehlen können Sie schnell Befehle ausführen, die denen in einem Terminalfenster ähneln.
VS Code
Sie können die folgenden Gemini-CLI-Befehle im Agent-Modus verwenden:
/tools
: Zeigt eine Liste der Tools an, die in Ihrer Sitzung im Agent-Modus verfügbar sind./mcp
: Hier werden konfigurierte MCP-Server (Model Context Protocol), ihr Verbindungsstatus, Serverdetails und verfügbare Tools aufgeführt.
Weitere Informationen zu Gemini CLI-Befehlen finden Sie unter Gemini CLI-Befehle. Hinweis: Nicht alle Gemini CLI-Befehle sind im Agent-Modus verfügbar.
IntelliJ
Diese Funktion wird in Gemini Code Assist für IntelliJ oder anderen JetBrains-IDEs nicht unterstützt.
Agent-Aktionen immer zulassen
Sie können alle Agent-Aktionen automatisch zulassen.
So lassen Sie alle Agent-Aktionen automatisch zu:
VS Code
Im YOLO-Modus werden alle Agent-Aktionen automatisch zugelassen. So konfigurieren Sie den YOLO-Modus:
Öffnen Sie die JSON-Datei mit den VS Code-Nutzereinstellungen:
- Öffnen Sie die Befehlspalette (
ctrl
/command
+Shift
+P
). - Wählen Sie Preferences: Open User Settings (JSON) aus.
- Öffnen Sie die Befehlspalette (
Fügen Sie der JSON-Datei mit den VS Code-Nutzereinstellungen Folgendes hinzu:
//other settings... "geminicodeassist.agentYoloMode": true, //other settings...
Öffnen Sie die Befehlspalette und wählen Sie Entwickler: Fenster neu laden aus.
Im Agent-Modus wird der YOLO-Modus verwendet. Sie werden nicht um Erlaubnis gefragt, bevor Aktionen ausgeführt werden, wenn Sie einen Prompt senden. Wenn Sie einen eingeschränkten Arbeitsbereich verwenden, werden Sie vom Agenten vor dem Ausführen von Aktionen unabhängig von dieser Einstellung aufgefordert.
IntelliJ
Wenn Sie Änderungen automatisch genehmigen möchten, wählen Sie auf dem Tab „Gemini Chat-Agent“ Einstellungen Agent-Optionen aus und klicken Sie dann auf das Kästchen neben Änderungen automatisch genehmigen.
Im Agent-Modus werden alle Anfragen automatisch genehmigt. Sie werden nicht um Erlaubnis gefragt, bevor Aktionen ausgeführt werden, wenn Sie einen Prompt senden.
Zusätzliche Prompts
Probieren Sie die folgenden Prompts mit Ihren eigenen Informationen aus:
- „Wozu dient dieses Repository? Hilf mir, die Architektur zu verstehen.“
- „Was macht diese [Klasse/Funktion]?“
- „Füge dieser Codebasis eine Funktion hinzu – [Link oder Pfad zur Codebasis].“
- „Faktoriere die Funktionen [A] und [B] so um, dass sie die gemeinsame Methode [C] verwenden.“
- „Behebe das GitHub-Problem [Link zum GitHub-Problem].“
- „Erstelle eine Anwendung, die [Ziel] mit einer Benutzeroberfläche erreicht, die es dem Nutzer ermöglicht, [Aufgabe] in der [Umgebung] auszuführen.“
- „Migriere die Bibliotheksversionen in diesem Repository von [X] zu [Y].“
- „Optimiere die Leistung dieses Go-Codes, damit er schneller ausgeführt wird.“
- „Verwende [name-of-API], um diese Funktion zu entwickeln.“
- „Implementiere einen Algorithmus für [X], [Y] und [Z].“
Nächste Schritte
- Übersicht über Gemini Code Assist
- Beispiel-MCP-Server
- Weitere MCP-Server auf GitHub
- Feedback über Ihre IDE senden