Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Im Agentmodus kann der KI-Assistent in Ihrem Editor PostgreSQL-Tools aus der Erweiterung als Teil einer einzigen mehrstufigen Unterhaltung verwenden. Anstatt nur eine Frage zu beantworten, kann der Assistent eine Verbindung mit einer Datenbank herstellen, Schema prüfen, Abfragen ausführen, Skripts öffnen und Ihnen helfen, einen Workflow am Ende zu durchlaufen.
Der Agentmodus wird sowohl in Visual Studio Code (mit GitHub Copilot) als auch im Cursor (mit integrierter KI) ausgeführt. Die Erweiterung macht in beiden Editoren dieselbe PostgreSQL-Werkzeugoberfläche verfügbar; nur der Chatbereich, der geöffnet wird, unterscheidet sich.
Verwenden Sie den Agent-Modus, wenn die KI strukturierte Aktionen ausführen soll, nicht nur die Erläuterung oder den Entwurf von SQL.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes haben:
- Die PostgreSQL-Erweiterung installiert.
- Copilot/AI-Features, die in der Erweiterung aktiviert sind (
pgsql.copilot.enableisttrue). - Mindestens eine Datenbankverbindung, die in der Erweiterung konfiguriert ist.
- Ein KI-Assistent, der in Ihrem Editor verfügbar ist:
- Visual Studio Code: GitHub Copilot oder GitHub Copilot Chat installiert und aktiv.
- Cursor: keine zusätzliche Installation; Die integrierte KI wird automatisch verwendet.
Agentmodus starten
- Stellen Sie eine Verbindung mit dem Zielserver oder der Datenbank in der PostgreSQL-Erweiterung her.
- Klicken Sie in der Verbindungsstruktur mit der rechten Maustaste auf die Datenbank, die Sie verwenden möchten.
- Wählen Sie Connect AI aus.
- Fahren Sie die Unterhaltung im Chatbereich fort, der mit dem Workflow geöffnet wird, den Sie abschließen möchten.
- In Visual Studio Code ist dies der GitHub-Copilot Chat Bereich im Agentmodus.
- In Cursor ist dies das systemeigene KI-Panel des Cursors; die Erweiterung bietet eine kurze MCP-orientierte Präambel, damit der Assistent über die verfügbaren PostgreSQL-Tools weiß.
Nachdem die Sitzung begonnen hat, kann die KI hinter den Kulissen PostgreSQL-Tools kombinieren, während sie Ihre Anfrage bearbeitet.
Auswählen des richtigen Zugriffsmodus
Die pgsql.copilot.accessMode-Einstellung steuert, wie viel Datenbankzugriff der Agent-Modus hat. Die Einstellungs-ID behält das pgsql.copilot.* Präfix zur Kompatibilität bei. Die vom Benutzer sichtbare Bezeichnung ist Copilot Zugriffsmodus im Visual Studio Code- und KI-Zugriffsmodus im Cursor.
| Modus | Was die KI tun kann | Empfohlene Verwendung |
|---|---|---|
ro |
Schreibgeschützte Operationen wie SELECT, SHOW, EXPLAIN, Schemaüberprüfung und Analyse |
Produktionssysteme oder freigegebene Umgebungen, in denen Sie eine Untersuchung ohne Änderungen wünschen |
rw |
Leseoperationen sowie datenändernde Anweisungen und DDL, mit expliziter Bestätigung vor der Ausführung | Lokale Entwicklung, temporäre Sandboxes und kontrollierte Testumgebungen |
Caution
Verwenden Sie den ro-Modus für Produktionsdatenbanken, es sei denn, Sie möchten absichtlich, dass Schema- oder Datenänderungen über den Agentmodus verfügbar sind.
Grundlegendes zu den Toolfamilien
Der Agentmodus kann je nach Workflow mehrere Toolfamilien verwenden.
| Toolfamilie | Was es bewirkt | Wenn Sie es verwenden |
|---|---|---|
| Verbindungstools | Profile auflisten, verbinden, trennen, Datenbanken auflisten | Starten oder Wechseln des Kontexts |
| Tools für den Schemakontext | Objektdefinitionen abrufen oder Schema visualisieren | Grundlegendes zu Tabellen, Ansichten, Funktionen, Indizes und Beziehungen |
| Abfragetools | Ausführen von Leseabfragen, Überprüfen von Abfrageplänen, Öffnen von Skripts | Untersuchen von Daten, Überprüfen von Ideen oder Überprüfen generierter SQL-Daten |
| Änderungstools | DDL oder DML mit Bestätigungsabfrage ausführen | Anwenden von kontrollierten Schema- oder Datenänderungen im rw Modus |
| Datenimporttools | CSV-Dateien beschreiben und gesammelt laden | Planen und Ausführen von CSV-Importworkflows |
Tip
In Cursor werden dieselben Tools auch über die MCP-Serverregistrierung angezeigt. Der native Chat des Cursors kann sie direkt aufrufen, ohne den Einstiegspunkt "Connect AI " zu verwenden. Weitere Informationen finden Sie unter MCP-Server .
Verwenden des Agentmodus für allgemeine Workflows
Die folgenden Beispiele zeigen, wie Sie den Agent-Modus für Aufgaben verwenden, die von der Erkundung einer neuen Datenbank bis hin zum Verfeinern von Abfragen reichen.
Erkunden einer unbekannten Datenbank
Bitten Sie die KI, eine Verbindung mit der Datenbank herzustellen, Schlüsselobjekte auflisten und die Schemabereiche zusammenzufassen, die für Ihre Aufgabe wichtig sind.
Beispiel:
Stellen Sie eine Verbindung mit meiner Entwicklungsdatenbank her, listen Sie die Tabellen im öffentlichen Schema auf, und teilen Sie mir mit, welche mit Kunden und Bestellungen zusammenhängen.
Abfrageleistung untersuchen
Bitten Sie die KI, den Schemakontext mit der Abfrageausführung oder Der Planüberprüfung zu kombinieren.
Beispiel:
Stellen Sie eine Verbindung mit der Staging-Datenbank her, führen Sie diese Abfrage im schreibgeschützten Modus aus und erläutern Sie, welcher Teil des Ausführungsplans hauptsächlich für die Kosten verantwortlich ist.
Daten laden oder umformen
Verwenden Sie den Agentmodus, wenn der Workflow Skripts oder CSV-basierte Vorgänge enthält.
Beispiel:
Überprüfen Sie diese CSV-Datei, teilen Sie mir mit, welches Schema sie impliziert, und bereiten Sie einen sicheren Importplan für die
sales.recordsTabelle vor.
Wechseln von Entwurf zu manueller Überprüfung
Wenn Sie vor der Ausführung einen Prüfpunkt für die menschliche Überprüfung benötigen, bitten Sie die KI, das generierte SQL im Abfrage-Editor zu öffnen, anstatt ihn sofort auszuführen.
Wissen, wann der Agentmodus anstelle von @pgsql verwendet werden sollte
Verwenden Sie @pgsql Chatteilnehmer , wenn Sie eine schemabasierte Antwort oder einen Abfrageentwurf wünschen. Der @pgsql Teilnehmer ist nur in Visual Studio Code verfügbar.
Verwenden Sie den Agent-Modus (sowohl in Visual Studio Code als auch im Cursor verfügbar), wenn die KI folgende Aktionen ausführen soll:
- Stellen Sie eine Verbindung mit der richtigen Datenbank für Ihre Anforderungen her,
- Mehrere Tools in einer Unterhaltung verketten,
- Überprüfen der Ergebnisse vor dem nächsten Schritt oder
- Vorbereiten eines Skripts oder kontrollierten Änderungsworkflows.
Note
Im Cursor ist der Agentmodus der primäre Pfad, da der @pgsql Chatteilnehmer dort nicht verfügbar ist. Die gleiche Tooloberfläche kann auch vom nativen Chat des Cursors über den MCP-Server erreicht werden.
Beheben von Problemen im Agentmodus
Wenn sich der Agentmodus nicht wie erwartet verhält, überprüfen Sie zuerst den Zugriffsmodus und die Verfügbarkeit des Tools.
Die KI kann die Datenbank nicht ändern.
Überprüfen Sie pgsql.copilot.accessMode und bestätigen Sie, dass die aktive Verbindung nicht zu ro aufgelöst wird.
Das erwartete Tool ist nicht verfügbar.
Stellen Sie sicher, dass Copilot Integration aktiviert ist und Sie mit einem gültigen PostgreSQL-Verbindungskontext aus einer Datenbank gestartet haben.
Eine Verbindungsanforderung schlägt fehl.
Vergewissern Sie sich, dass das Verbindungsprofil noch vorhanden ist, dass die Anmeldeinformationen verfügbar sind, und die Erweiterung kann eine Verbindung mit derselben Datenbank außerhalb des Agent-Modus herstellen.
Ich möchte einen einfacheren chatbasierten Workflow.
In Visual Studio Code verwenden Sie @pgsql Chat-Teilnehmer, wenn Sie Erklärungen, das Formulieren von Abfragen oder Fragen zum Schema ohne werkzeuggestützte Automatisierung benötigen. Stellen Sie im Cursor die gleichen Fragen aus dem nativen Chat. Die MCP-Tools der Erweiterung sind weiterhin auffindbar, aber der Chat wirkt ohne einen expliziten Eintrag für den Agent-Modus deutlich dialogorientierter.