Kontexte mit der Gemini-Befehlszeile erstellen

In diesem Dokument wird beschrieben, wie Sie mit der Gemini-Befehlszeile und der MCP-Toolbox Kontextdateien für Agents erstellen. Diese Dateien enthalten Vorlagen und Facetten, die Kontext für das Generieren von SQL-Abfragen aus natürlicher Sprache liefern. Sie verwenden auch den MCP-Server für die DB-Kontextanreicherung.

Weitere Informationen zu Daten-Agents finden Sie unter Daten-Agents – Übersicht.

So erstellen Sie den Agent-Kontext:

  • Umgebung vorbereiten
  • Gezielte Vorlagen generieren
  • Gezielte Facetten generieren
  • Optional. Bulk-Vorlagen generieren

Hinweise

Erfüllen Sie die folgenden Voraussetzungen, bevor Sie einen Agent erstellen.

Spanner-Instanz vorbereiten

  • Prüfen Sie, ob eine Spanner-Instanz verfügbar ist. Weitere Informationen finden Sie unter Instanz erstellen.
  • Füllen Sie die Datenbank mit den Daten und dem Schema, auf die der Endnutzer zugreifen möchte.

Erforderliche Rollen und Berechtigungen

Umgebung vorbereiten

Sie können Agent-Kontextdateien in jeder lokalen Entwicklungsumgebung oder IDE erstellen. So bereiten Sie die Umgebung vor:

  • Gemini CLI installieren
  • MCP-Toolbox installieren und einrichten
  • MCP-Server für die Kontextanreicherung der Datenbank installieren und einrichten

Gemini CLI installieren

Informationen zur Installation der Gemini CLI finden Sie unter Erste Schritte mit der Gemini CLI. Achten Sie darauf, dass Sie die Gemini CLI in einem separaten Verzeichnis installieren, in dem auch die MCP-Toolbox und der MCP-Server für die Kontextanreicherung der Datenbank installiert werden.

MCP-Toolbox installieren und einrichten

  1. Installieren Sie die MCP Toolbox Gemini CLI-Erweiterung im selben Verzeichnis, in dem Sie die Gemini CLI installiert haben:

    gemini extensions install https://github.com/gemini-cli-extensions/mcp-toolbox

  2. Erstellen Sie im selben Verzeichnis, in dem Sie die MCP-Toolbox installiert haben, eine tools.yaml-Konfigurationsdatei, um die Datenbankverbindung zu konfigurieren:

      sources:
    my-spanner-source:
      kind: spanner
      project: PROJECT_ID
      instance: INSTANCE_ID
      database: DATABASE_ID

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Ihre Google Cloud Projekt-ID
    • INSTANCE_ID: Die ID Ihrer Spanner-Instanz.
    • DATABASE_ID: Der Name der Datenbank, zu der eine Verbindung hergestellt werden soll.

  3. Prüfen Sie, ob die Datei tools.yaml richtig konfiguriert ist:

    ./toolbox --tools-file "tools.yaml"

MCP-Server für die Kontextanreicherung der Datenbank installieren

Der DB Context Enrichment MCP-Server bietet einen geführten, interaktiven Workflow zum Generieren strukturierter NL2SQL-Vorlagen aus Ihren Datenbankschemas. Sie basiert auf der MCP-Toolbox-Erweiterung für die Datenbankverbindung. Weitere Informationen zur Installation des MCP-Servers für die Kontextanreicherung der Datenbank finden Sie unter MCP-Server für die Kontextanreicherung der Datenbank.

So installieren Sie den DB Context Enrichment MCP-Server:

  1. Installieren Sie im selben Verzeichnis, in dem Sie die Gemini CLI installiert haben, das uv-Python-Paketinstallationsprogramm.

      pip install --user pipx
  pipx ensurepath
  pipx install uv

  2. Installieren Sie den MCP-Server für die Kontextanreicherung der Datenbank.

    gemini extensions install https://github.com/GoogleCloudPlatform/db-context-enrichment

Der Server verwendet die Gemini API für die Generierung. Exportieren Sie den API-Schlüssel als Umgebungsvariable. Weitere Informationen zum Suchen Ihres API-Schlüssels finden Sie unter Gemini API-Schlüssel verwenden.

Führen Sie den folgenden Befehl aus, um den Gemini API-Schlüssel zu exportieren:

export GEMINI_API_KEY="YOUR_API_KEY"

Ersetzen Sie YOUR_API_KEY durch Ihren Gemini API-Schlüssel.

Gezielte Vorlagen generieren

Wenn Sie ein bestimmtes Frage-Antwort-Paar als Abfragevorlage zum Kontext des Agents hinzufügen möchten, können Sie den Befehl /generate_targeted_templates verwenden. Weitere Informationen zu Vorlagen finden Sie unter Data Agents – Übersicht.

So fügen Sie dem Agent-Kontext eine Abfragevorlage hinzu:

  1. Starten Sie Gemini im selben Verzeichnis, in dem Sie die Gemini CLI installiert haben:

    gemini

  2. Schließen Sie die Einrichtung der Authentifizierung für die Gemini CLI ab.

  3. Prüfen Sie, ob die MCP-Toolbox und die Erweiterung zur Datenbankanreicherung einsatzbereit sind:

    /mcp list

  4. Führen Sie den Befehl /generate_targeted_templates aus:

    /generate_targeted_templates

  5. Geben Sie die Abfrage in natürlicher Sprache ein, die Sie der Abfragevorlage hinzufügen möchten.

  6. Geben Sie die entsprechende SQL-Abfrage in die Abfragevorlage ein.

  7. Sehen Sie sich die generierte Abfragevorlage an. Sie können die Abfragevorlage entweder als Agent-Kontextdatei speichern oder an eine vorhandene Kontextdatei anhängen.

Die Agent-Kontextdatei, die my-cluster-psc-primary_postgres_templates_20251104111122.json ähnelt, wird in dem Verzeichnis gespeichert, in dem Sie die Befehle ausgeführt haben.

Weitere Informationen zur Kontextdatei und zur Abfragevorlage finden Sie unter Agent-Kontext.

Gezielte Facetten generieren

Wenn Sie ein bestimmtes Frage-Antwort-Paar als Facette in die Kontextdatei des Agents einfügen möchten, können Sie den Befehl /generate_targeted_fragments verwenden. Weitere Informationen zu Facetten finden Sie unter Data Agents – Übersicht.

So fügen Sie dem Agentenkontext eine Facette hinzu:

  1. Führen Sie den Befehl /generate_targeted_fragments aus:

    /generate_targeted_fragments

  2. Geben Sie die Abfrage in natürlicher Sprache ein, die Sie der Abfragevorlage hinzufügen möchten.

  3. Geben Sie die entsprechende SQL-Abfrage in die Abfragevorlage ein.

  4. Sehen Sie sich die generierte Facette an. Sie können die Facette entweder in einer Agent-Kontextdatei speichern oder an eine vorhandene Kontextdatei anhängen.

Die Agent-Kontextdatei, die my-cluster-psc-primary_postgres_templates_20251104111122.json ähnelt, wird in dem Verzeichnis gespeichert, in dem Sie die Befehle ausgeführt haben.

Weitere Informationen zur Kontextdatei und zu Facetten finden Sie unter Agentenkontext.

Optional: Bulk-Vorlagen generieren

Wenn Sie die Kontextdatei des KI-Agents automatisch auf Grundlage Ihres Datenbankschemas und Ihrer Daten generieren möchten, können Sie den Befehl /generate_bulk_templates verwenden.

So generieren Sie Bulk-Vorlagen automatisch:

  1. Führen Sie den Befehl /generate_bulk_templates aus:

    /generate_bulk_templates

  2. Bei der vorlagenbasierten SQL-Generierung werden Sie anhand Ihres Datenbankschemas durch eine Reihe von Fragen geführt, in denen Sie die Datenbankinformationen bestätigen und Berechtigungen für den Zugriff auf das Datenbankschema erteilen.

  3. Sehen Sie sich die generierte Abfragevorlage an. Sie können die Vorlage entweder genehmigen oder ein Frage-Antwort-Paar aktualisieren, das Sie überarbeiten möchten.

  4. Geben Sie die Abfrage in natürlicher Sprache ein, die Sie der Abfragevorlage hinzufügen möchten.

  5. Geben Sie die entsprechende SQL-Abfrage in die Abfragevorlage ein.

  6. Sehen Sie sich die generierte Abfragevorlage an. Sie können die Abfragevorlage entweder als Agent-Kontextdatei speichern oder an eine vorhandene Kontextdatei anhängen.

  7. Nachdem Sie die Abfragevorlage genehmigt haben, können Sie entweder eine neue Vorlagendatei erstellen oder die Abfragepaare an eine vorhandene Vorlagendatei anhängen. Die Abfragevorlage wird als JSON-Datei in Ihrem lokalen Verzeichnis gespeichert.

Die Agent-Kontextdatei, die my-cluster-psc-primary_postgres_templates_20251104111122.json ähnelt, wird in dem Verzeichnis gespeichert, in dem Sie die Befehle ausgeführt haben.

Weitere Informationen zur Agent-Kontextdatei finden Sie unter Agent-Kontext.

Nächste Schritte