Copilot-Integration

Die PostgreSQL-Erweiterung lässt sich über drei Schnittstellen in KI-Assistenten integrieren: den @pgsql-Chat-Teilnehmer (nur in Visual Studio Code), Agent mode-Tools und einen MCP-Serveranbieter für PostgreSQL-Tools. Auf dieser Seite können Sie den richtigen Einstiegspunkt auswählen und die gemeinsam genutzte Konfiguration verstehen, die für alle drei Gilt.

Die Erweiterung wird sowohl in Visual Studio Code (mit GitHub Copilot) als auch im Cursor (mit integrierter KI) ausgeführt. Die meisten Features funktionieren in beiden Editoren auf die gleiche Weise; Die geringe Anzahl editorspezifischer Verhaltensweisen wird in diesem Artikel genannt.

Prerequisites

Bevor Sie ein KI-unterstütztes Feature verwenden, stellen Sie sicher, dass die folgenden Anforderungen erfüllt sind:

  • Die PostgreSQL-Erweiterung ist installiert, und Sie haben mindestens eine Datenbankverbindung konfiguriert.
  • Ein KI-Assistent ist in Ihrem Editor verfügbar:
    • Visual Studio Code: Installieren Sie GitHub Copilot oder GitHub Copilot Chat, und melden Sie sich mit einem aktiven Abonnement an.
    • Cursor: keine zusätzliche Installation; Die integrierte KI wird automatisch verwendet.

Note

Copilot Features sind standardmäßig aktiviert (pgsql.copilot.enable ist true). Wenn Sie dies auf false festlegen, werden der @pgsql-Chatteilnehmer (nur in Visual Studio Code), das Editor-Untermenü AI Query Actions, die Tools des Agentmodus und der MCP-Serveranbieter ausgeblendet.

Tip

KI-Unterstützung funktioniert am besten, wenn Sie bereits über eine aktive Datenbankverbindung verfügen. Wenn Sie noch keine Verbindung hergestellt haben, beginnen Sie mit "Connections" und "Identity".

Auswählen des richtigen Einstiegspunkts

Wenn Sie möchten... Beginne hier Verfügbarkeit Weitere Informationen
Stellen Sie eine schemabezogene Frage zu Ihrer Datenbank @pgsql Chat-Teilnehmer nur Visual Studio Code @pgsql Chat-Teilnehmer
Agent-Modus mit einer bestimmten Datenbank starten, die bereits ausgewählt ist Connect AI über einen Datenbankknoten im Connections-Baum Visual Studio Code und Cursor Agentenmodus
Erläutern, Neuschreiben oder Analysieren von SQL aus dem Editor Untermenü "AI-Abfrageaktionen " im Kontextmenü des Editors Visual Studio Code und Cursor Editoraktionen
Automatisieren einer mehrstufigen Datenbankaufgabe Verbinden von KI auf einem Datenbankknoten zum Starten des Agent-Modus Visual Studio Code und Cursor Agentenmodus
Verfügbarmachen von PostgreSQL-Tools für MCP-kompatible Hosts Anbieter für PostgreSQL-Tools-MCP-Server Visual Studio Code und Cursor MCP-Server

Verwenden Sie @pgsql für schemaunterstützten Chat

Note

Der @pgsql-Chatteilnehmer wird nur in Visual Studio Code registriert, wo er in GitHub-Copilot Chat eingebunden wird. Verwenden Sie in CursorConnect AI von einem Datenbankknoten im Verbindungen-Baum aus, um den Agent-Modus mit demselben Schemakontext zu starten, oder verlassen Sie sich auf den MCP-Server in der nativen Chatoberfläche von Cursor.

Die Erweiterung registriert einen @pgsql Chatteilnehmer (ID: vscode-postgresql.chat-agent) für schemabasierte Unterhaltungen in GitHub-Copilot Chat. Geben Sie zuerst @pgsql und anschließend Ihre Frage ein, und der Teilnehmer antwortet mithilfe des Live-Schemakontexts aus Ihrer verbundenen Datenbank.

Wenn Sie einen werkzeuggestützten Workflow starten möchten, wenn sich bereits eine Datenbank im Kontext befindet, klicken Sie im Connections-Baum mit der rechten Maustaste auf einen Datenbankknoten und wählen Sie Connect AI aus.

Für Anleitungen für Endbenutzer, Beispiel-Prompts und Hinweise zur Fehlerbehebung fahren Sie mit @pgsql chat participant fort.

Verwenden von Editoraktionen für abfrageorientierte Hilfe

Wenn SQL im Abfrage-Editor geöffnet ist, klicken Sie mit der rechten Maustaste, um das Untermenü "AI-Abfrageaktionen " zu finden. Sie enthält die folgenden Aktionen:

Action Description
Erläutern der Abfrage Gibt eine allgemeinverständliche Erklärung dessen zurück, was die Abfrage tut.
Abfrage neu schreiben Schlägt eine alternative Version der Abfrage vor, während das beabsichtigte Ergebnis beibehalten wird.
Analysieren der Abfrageleistung Führt EXPLAIN ANALYZE gegen die verbundene Datenbank aus und sendet dann den Ausführungsplan zur Analyse an die KI.

Sie können auch in der Symbolleiste des Editors „KI zu dieser Abfrage fragen“ auswählen, um eine Chatunterhaltung zu öffnen, die auf dem aktuellen Inhalt des Editors basiert.

Um die gespeicherte Auswahl zur Einbeziehung von Abfragen für die Analyse von Ausführungsplänen zurückzusetzen, führen Sie Clear query inclusion preferences for AI analysis in der Befehlspalette aus.

Verwenden des Agentmodus für toolgesteuerte Workflows

Der Agentmodus bietet dem KI-Assistenten Zugriff auf PostgreSQL-Tools, sodass es eine Verbindung herstellen, ein Schema prüfen, Abfragen ausführen, Skripts öffnen und in einer Unterhaltung mehrere Schritte ausführen kann. Klicken Sie mit der rechten Maustaste in der Verbindungsstruktur auf einen Datenbankknoten, und wählen Sie "KI verbinden" aus, um eine Agentmodussitzung zu starten.

Für Toolfamilien, z. B. Workflows und Problembehandlung, fahren Sie mit dem Agentmodus fort.

Verwenden des MCP-Servers in unterstützten Hosts

Die Erweiterung registriert einen PostgreSQL Tools MCP Server Provider (ID: pgsql-tools-mcp-server-provider), der die gleiche PostgreSQL-Tooloberfläche über das Model Context Protocol verfügbar macht. MCP-kompatible Hosts können diese Tools ermitteln und aufrufen, ohne die integrierten Chatworkflows zu verwenden.

Für unterstützte Hosts, automatisches Registrierungsverhalten und die Toolfamilien, die über MCP verfügbar gemacht werden, fahren Sie mit dem MCP-Server fort.

Konfigurieren des Zugriffsmodus

Die pgsql.copilot.accessMode Einstellung steuert, wie viel Datenbankzugriff der KI-Assistent über den Agentmodus und MCP-Tools erhält. Der Standardwert ist Lese-/Schreibzugriff (rw).

Einstellungswert UI-Beschriftung Was der KI-Assistent tun kann
ro Nur Lesen Schreibgeschützte Operationen: SELECT, SHOW, EXPLAIN, Schemaüberprüfung
rw Lesen/Schreiben Lesevorgänge plus Datenmodifizierungsanweisungen und DDL, mit expliziter Bestätigung

Außerkraftsetzung pro Verbindung

Sie können den Zugriffsmodus auch für einzelne Verbindungen festlegen. Erweitern Sie im Verbindungsdialogfeld den abschnitt Copilot (AI im Cursor), und legen Sie Copilot Zugriffsmodus (AI-Zugriffsmodus im Cursor) auf eine der folgenden Optionen fest:

Auswahl Behavior
Globale Einstellung verwenden Fällt auf den globalen pgsql.copilot.accessMode Wert zurück (Standard)
Nur Lesen Erzwingt schreibgeschützten Zugriff für diese Verbindung, unabhängig von der globalen Einstellung
Lesen/Schreiben Erzwingt Lese-/Schreibzugriff für diese Verbindung, unabhängig von der globalen Einstellung

Die Erweiterung ermittelt den effektiven Zugriffsmodus anhand dieser Fallback-Reihenfolge: verbindungsspezifischer Wert → globale pgsql.copilot.accessMode-Einstellung → Standardeinstellung (rw).

Caution

Verwenden Sie Nur Lesen für Produktionsdatenbanken, es sei denn, Sie möchten bewusst, dass Schema- oder Datenänderungen über den KI-Assistenten möglich sind.

Zusätzliche Einstellungen konfigurieren

Einstellung Was sie steuert Vorgabe
pgsql.copilot.enable Aktiviert oder deaktiviert alle KI-Integration in der Erweiterung true
pgsql.copilot.accessMode Globaler KI-Zugriffsmodus (Nur lesen oder Lesen/Schreiben) rw
pgsql.copilot.autoAttachQuery Gibt an, ob SQL-Abfragetext beim Analysieren von Plänen mit KI enthalten ist: "Jedes Mal fragen", "Immer einschließen" oder "Nie einschließen" ask
pgsql.copilot.modelOptions Erweiterte Modelloptimierung (max. Token, Temperatur, top_p) für die KI-Workflows der Erweiterung -

Einstellungs-IDs behalten in beiden Editoren aus Gründen der Abwärtskompatibilität das Präfix pgsql.copilot.* bei, selbst dort, wo die für den Benutzer sichtbaren Bezeichnungen „AI“ lauten.

Featurespezifische KI-Integrationen

Zu den verschiedenen Features gehören dedizierte KI-Integrationspunkte:

Funktion KI-Funktion
Abfrageplan-Visualisierung Analysieren Sie Daten des Ausführungsplans mit „Mit Copilot analysieren“ (oder „Mit KI analysieren“ in Cursor)
Serverdashboard Öffnen von Chatsitzungen über Copilot fragen Schaltflächen (Ask AI in Cursor) in den Bereichen "Abfragen", "Warten", "Sitzungen" und "Metrikdiagramme"
Schema-Visualisierung Visualisieren von Schemabeziehungen aus einem Agentmodus-Workflow

Verwandte Inhalte

  • Last updated on