Agentischen Chat als Co-Programmierer verwenden

In diesem Dokument wird beschrieben, wie Sie den Gemini Code Assist-Agentenmodus als Co-Programmierer in Ihrer integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) konfigurieren und verwenden.

Mit dem KI-Agentenmodus können Sie unter anderem Folgendes tun:

Fragen zu Ihrem Code stellen
Kontext und integrierte Tools nutzen, um generierte Inhalte zu verbessern
MCP-Server konfigurieren, um die Funktionen des KI-Agenten zu erweitern
Lösungen für komplexe Aufgaben mit mehreren Schritten erhalten
Code aus Designdokumenten, Problemen und TODO-Kommentaren generieren
Das Verhalten des KI-Agenten steuern, indem Sie Pläne und die Verwendung von Tools während der Ausführung kommentieren, bearbeiten und genehmigen

Beschränkungen

Einige Funktionen des Standardchats von Gemini Code Assist sind im KI-Agentenmodus möglicherweise nicht verfügbar oder funktionieren anders als im Standardchat.

Die Rezitation ist im KI-Agentenmodus nicht verfügbar. Im KI-Agentenmodus werden von Gemini keine Quellen zitiert und Sie können keine Codevorschläge deaktivieren, die mit zitierten Quellen übereinstimmen.

Vorbereitung

VS Code

Richten Sie Gemini Code Assist ein.

IntelliJ

Richten Sie Gemini Code Assist ein.

KI-Agentenmodus verwenden

Im KI-Agentenmodus können Sie Gemini auffordern, übergeordnete Ziele und komplexe Aufgaben zu erledigen.

Damit Sie den KI-Agentenmodus optimal nutzen können, sollten Sie die Best Practices für die Prompt-Erstellung beachten und so viele Details wie möglich angeben.

So wechseln Sie in den KI-Agentenmodus:

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 KI-Agentenmodus aufzurufen. Die Ein/Aus-Schaltfläche wird hervorgehoben, wenn sie auf den KI-Agentenmodus eingestellt ist, und ist grau, wenn sie 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 Agenten zu beenden.

Wenn Sie den Standardchat von Gemini Code Assist verwenden möchten, klicken Sie auf Neuer Chat, um einen neuen Chat zu erstellen.

Der Gemini Code Assist-Agentenmodus basiert auf der Gemini-Befehlszeile.

IntelliJ

Klicken Sie in der Toolfensterleiste 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 KI-Agent ausführen soll.
Während der KI-Agent 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 settings Agentenoptionen aus und klicken Sie dann auf das Kästchen neben Änderungen automatisch genehmigen.

Achtung: Der KI-Agent hat Zugriff auf das Dateisystem und die Terminalaktionen Ihres Computers sowie auf alle Tools, die Sie für die Verwendung konfiguriert haben. Seien Sie äußerst vorsichtig, wo und wann Sie Änderungen automatisch genehmigen.

Tools für den KI-Agentenmodus konfigurieren

Tools sind eine breite Kategorie von Diensten, die ein KI-Agent für den Kontext und die Aktionen in seiner Antwort auf Ihren Prompt verwenden kann. Beispiele hierfür sind etwa integrierte Tools wie grep, Lesen von Dateien oder Scheiben von Dateien, lokale oder Remote-MCP-Server (Model Context Protocol) und ihre ausführbaren Funktionen oder maßgeschneiderte Dienstimplementierungen.

Verwendung integrierter Tools steuern

Im KI-Agentenmodus haben Sie Zugriff auf Ihre integrierten Tools wie Dateisuche, Lesen von Dateien, Schreiben von Dateien, Terminalbefehle und mehr.

VS Code

Mit den Einstellungen coreTools und excludeTools können Sie festlegen, auf welche Tools Gemini im KI-Agentenmodus zugreifen darf.

coreTools: Ermöglicht Ihnen 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 mit Ihren Gemini-Einstellungen einfügen, darf nur der Shell-Befehl ls -l ausgeführt werden: "coreTools": ["ShellTool(ls -l)"].
excludeTools: Ermöglicht Ihnen die Angabe einer Liste von Tools, 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 mit Ihren 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 KI-Agentenmodus verfügbar sind:

Öffnen Sie die JSON-Datei mit Ihren Gemini-Einstellungen unter ~/.gemini/settings.json, wobei ~ Ihr Basisverzeichnis ist.
Wenn Sie die Toolverwendung durch den KI-Agenten auf eine Liste genehmigter Tools beschränken möchten, fügen Sie der JSON-Datei mit Ihren Gemini-Einstellungen die folgende Zeile hinzu:
```
"coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
Ersetzen Sie TOOL_NAME_1 und TOOL_NAME_2 durch die Namen der integrierten Tools, auf die der KI-Agent Zugriff haben soll.

Sie können beliebig viele integrierte Tools auflisten. Standardmäßig sind alle integrierten Tools für den KI-Agenten verfügbar.
Wenn Sie die Toolverwendung durch den KI-Agenten auf bestimmte Toolbefehle beschränken möchten, fügen Sie der JSON-Datei mit Ihren Gemini-Einstellungen die folgende Zeile hinzu:
```
"coreTools": ["TOOL_NAME(COMMAND)"]
```
Ersetzen Sie Folgendes:
- TOOL_NAME: der Name des integrierten Tools
- COMMAND: der Name des integrierten Toolbefehls, den der KI-Agent verwenden können soll
Wenn Sie ein Tool von der Verwendung durch den KI-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 und TOOL_NAME_2 durch die Namen der integrierten Tools, die Sie von der Verwendung durch den KI-Agenten ausschließen möchten.
Wenn Sie einen Toolbefehl von der Verwendung durch den KI-Agenten ausschließen möchten, fügen Sie der JSON-Datei mit Ihren Gemini-Einstellungen die folgende Zeile hinzu:
```
"excludeTools": ["TOOL_NAME(COMMAND)"]
```
Ersetzen Sie Folgendes:
- TOOL_NAME: der Name des integrierten Tools
- COMMAND: der Name des integrierten Toolbefehls, den Sie von der Verwendung durch den KI-Agenten ausschließen möchten

Weitere Informationen zu den Konfigurationseinstellungen coreTools und excludeTools finden Sie in der Dokumentation zur Konfiguration der Gemini-Befehlszeile.

IntelliJ

Diese Funktion wird in Gemini Code Assist für IntelliJ oder andere JetBrains-IDEs nicht unterstützt.

MCP-Server konfigurieren

VS Code

Wenn Sie festlegen möchten, welche Server im KI-Agentenmodus verfügbar sind, fügen Sie sie gemäß der Serverdokumentation zur JSON-Datei mit Ihren 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 Basisverzeichnis ist.

Fügen Sie der JSON-Datei mit Ihren Gemini-Einstellungen gemäß der Serveranleitung 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 KI-Agenten zur Verwendung im KI-Agentenmodus zur Verfügung.

IntelliJ

Wenn Sie festlegen möchten, welche Server im KI-Agentenmodus verfügbar sind, fügen Sie sie einer mcp.json-Datei hinzu und legen Sie diese im Konfigurationsverzeichnis Ihrer 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 der JSON-Datei mit Ihren Gemini-Einstellungen gemäß der Serveranleitung 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 KI-Agenten zur Verwendung im KI-Agentenmodus zur Verfügung.

MCP-Serverauthentifizierung

Für einige MCP-Server ist eine Authentifizierung erforderlich. Folgen Sie der Serverdokumentation, um alle erforderlichen Nutzertokens zu erstellen.

VS Code

MCP-Server, für die eine Authentifizierung erforderlich ist, können Sie der JSON-Datei mit Ihren 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 mcp.json-Datei 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 KI-Agenten, bessere Antworten auf einen bestimmten Prompt zu generieren. Der Kontext kann aus Dateien in Ihrer IDE, Dateien in Ihren lokalen Systemordnern, Toolantworten und Ihren Promptdetails stammen. Weitere Informationen finden Sie unter Kontext des KI-Agentenmodus.

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:

Bereich	Speicherort
Alle Ihre Projekte	`~/.gemini/GEMINI.md`
Ein bestimmtes Projekt	Ihr Arbeitsverzeichnis oder alle übergeordneten Verzeichnisse bis zum Stammverzeichnis Ihres Projekts (durch einen `.git`-Ordner gekennzeichnet) oder Ihrem Basisverzeichnis
Eine bestimmte Komponente, ein bestimmtes Modul oder ein bestimmter Unterabschnitt eines Projekts	Unterverzeichnisse Ihres Arbeitsverzeichnisses

Das Speichersystem des KI-Agenten wird durch das Laden von Kontextdateien aus mehreren Speicherorten erstellt. Der Kontext aus spezifischeren Dateien, wie solche 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 KI-Agent verwenden soll, in Markdown und speichern Sie die Datei. Weitere Informationen finden Sie in der Beispielkontextdatei auf GitHub.

Der KI-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 oder AGENT.md.
Schreiben Sie alle Regeln, Styleguide-Informationen oder den Kontext, die der KI-Agent verwenden soll, in Markdown und speichern Sie die Datei.

Der KI-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 Slash-Befehlen (/) können Sie schnell Befehle ausführen, die denen in einem Terminalfenster ähneln.

VS Code

Sie können die folgenden Befehle der Gemini-Befehlszeile im KI-Agentenmodus verwenden:

/tools: Zeigt eine Liste der Tools an, die in Ihrer Sitzung im KI-Agentenmodus verfügbar sind.
/mcp: Führt konfigurierte MCP-Server (Model Context Protocol), ihren Verbindungsstatus, Serverdetails und verfügbare Tools auf.

Weitere Informationen finden Sie unter Befehle der Gemini-Befehlszeile. Hinweis: Nicht alle Befehle der Gemini-Befehlszeile sind im KI-Agentenmodus verfügbar.

IntelliJ

Diese Funktion wird in Gemini Code Assist für IntelliJ oder andere JetBrains-IDEs nicht unterstützt.

Aktionen des KI-Agenten immer zulassen

Sie können alle Aktionen des KI-Agenten automatisch zulassen.

So lassen Sie alle Aktionen des KI-Agenten automatisch zu:

VS Code

Im yolo-Modus werden alle Aktionen des KI-Agenten automatisch zugelassen. So konfigurieren Sie den yolo-Modus:

Öffnen Sie die JSON-Datei mit Ihren VS Code-Nutzereinstellungen:
1. Öffnen Sie die Befehlspalette (ctrl/command + Shift + P).
2. Wählen Sie Einstellungen: Nutzereinstellungen öffnen (JSON) aus.

Fügen Sie der JSON-Datei mit Ihren 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 KI-Agentenmodus wird der yolo-Modus verwendet. Sie werden nicht um Erlaubnis gefragt, bevor Aktionen ausgeführt werden, wenn Sie einen Prompt senden.

IntelliJ

Wenn Sie Änderungen automatisch genehmigen möchten, wählen Sie auf dem Tab „Gemini Chat-Agent“ settings Agentenoptionen aus und klicken Sie dann auf das Kästchen neben Änderungen automatisch genehmigen.

Im KI-Agentenmodus 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.“
„Wozu dient diese [Klasse/Funktion]?“
„Füge dieser Codebasis eine Funktion hinzu: ‚[Link oder Pfad zur Codebasis]‘.“
„Refaktoriere die Funktionen [A] und [B] so, 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 [API-Name], um diese Funktion zu erweitern.“
„Implementiere einen Algorithmus, der [X], [Y] und [Z] ausführt.“

Agentischen Chat als Co-Programmierer verwenden Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Beschränkungen

Vorbereitung

VS Code

IntelliJ

KI-Agentenmodus verwenden

VS Code

IntelliJ

Tools für den KI-Agentenmodus konfigurieren

Verwendung integrierter Tools steuern

VS Code

IntelliJ

MCP-Server konfigurieren

VS Code

IntelliJ

MCP-Serverauthentifizierung

VS Code

IntelliJ

Kontextdatei erstellen

VS Code

IntelliJ

Befehle verwenden

VS Code

IntelliJ

Aktionen des KI-Agenten immer zulassen

VS Code

IntelliJ

Zusätzliche Prompts

Weitere Informationen

Agentischen Chat als Co-Programmierer verwenden