Copilot-integratie

De PostgreSQL-extensie kan worden geïntegreerd met AI-assistenten via drie surfaces: de @pgsql chatdeelnemer (alleen Visual Studio Code), hulpprogramma's voor de agentmodus en een MCP-serverprovider van PostgreSQL Tools. Deze pagina helpt u het juiste toegangspunt te kiezen en de gedeelde configuratie te begrijpen die voor alle drie geldt.

De extensie wordt uitgevoerd in zowel Visual Studio Code (met GitHub Copilot) als Cursor (met de ingebouwde AI). De meeste functies werken op dezelfde manier in beide editors; het kleine aantal editorspecifieke gedragingen wordt in dit artikel aangeroepen.

Prerequisites

Voordat u een AI-ondersteunde functie gebruikt, moet u ervoor zorgen dat aan de volgende vereisten wordt voldaan:

  • De PostgreSQL-extensie is geïnstalleerd en u hebt ten minste één databaseverbinding geconfigureerd.
  • Er is een AI-assistent beschikbaar in uw editor:
    • Visual Studio Code: installeer GitHub Copilot of GitHub Copilot Chat en meld u aan met een actief abonnement.
    • Cursor: geen extra installatie; de ingebouwde AI wordt automatisch gebruikt.

Note

Copilot functies zijn standaard ingeschakeld (pgsql.copilot.enableistrue). Wanneer u dit instelt op false, worden de @pgsql-chatdeelnemer (alleen in Visual Studio Code), het editor-submenu AI Query Actions, de tools voor de agentmodus en de MCP-serverprovider allemaal verborgen.

Tip

AI-hulp werkt het beste wanneer u al een actieve databaseverbinding hebt. Als u nog geen verbinding hebt gemaakt, begint u met verbindingen en identiteit.

Het juiste toegangspunt kiezen

Als je wilt... Begin hier Availability Learn more
Een schemabewuste vraag stellen over uw database @pgsql chatdeelnemer Alleen Visual Studio Code @pgsql chatdeelnemer
Agentmodus starten met een specifieke database die al is geselecteerd AI verbinden vanuit een databaseknooppunt in de structuur Verbindingen Visual Studio Code en Cursor Agentmodus
SQL uitleggen, herschrijven of analyseren vanuit de editor Submenu AI-queryacties in het contextmenu van de editor Visual Studio Code en Cursor Editoracties
Een databasetaak met meerdere stappen automatiseren AI verbinden op een databaseknooppunt om de agentmodus te starten Visual Studio Code en Cursor Agentmodus
PostgreSQL-hulpprogramma's beschikbaar maken voor MCP-compatibele hosts PostgreSQL Tools MCP Server Provider Visual Studio Code en Cursor MCP-server

Gebruiken @pgsql voor schemabewust chatten

Note

De @pgsql chatdeelnemer is alleen geregistreerd in Visual Studio Code, waar deze is aangesloten op GitHub Copilot Chat. In Cursor gebruikt u Connect AI vanuit een databaseknooppunt in de structuur Verbindingen om de agentmodus te starten met dezelfde schemacontext, of vertrouwt u op de MCP-server in het systeemeigen chatoppervlak van Cursor.

De extensie registreert een @pgsql chatdeelnemer (ID: vscode-postgresql.chat-agent) voor schemabewuste gesprekken in GitHub Copilot Chat. Type @pgsql gevolgd door uw vraag, en de deelnemer antwoordt op basis van live schemacontext uit uw verbonden database.

Als u een werkstroom op basis van een hulpprogramma wilt starten met een database die al binnen het bereik valt, klikt u met de rechtermuisknop op een databaseknooppunt in de structuur Verbindingen en selecteert u Verbinding maken met AI.

Voor richtlijnen voor eindgebruikers, voorbeeldprompts en probleemoplossing gaat u verder naar @pgsql chatparticipant.

Gebruik editoracties voor querygerichte hulp

Wanneer u SQL hebt geopend in de queryeditor, klikt u met de rechtermuisknop om het submenu AI-queryacties te zoeken. Deze bevat de volgende acties:

Handeling Beschrijving
Query uitleggen Retourneert een uitleg in gewone taal van wat de query doet.
Query herschrijven Hiermee wordt een alternatieve versie van de query voorgesteld terwijl het beoogde resultaat behouden blijft.
Queryprestaties analyseren Voert EXPLAIN ANALYZE uit op de verbonden database en stuurt vervolgens het uitvoeringsplan naar de AI voor analyse.

U kunt ook AI vragen over deze query selecteren in de werkbalk van de editor om een chatgesprek te openen dat is gebaseerd op de huidige inhoud van de editor.

Als u de onthouden query-opnamevoorkeuren voor de plananalyse opnieuw wilt instellen, voert u Voorkeuren voor query-opname voor AI-analyse wissen uit in het Opdrachtenpalet.

Agentmodus gebruiken voor werkstromen op basis van hulpprogramma's

De agentmodus biedt de AI-assistent toegang tot PostgreSQL-hulpprogramma's, zodat deze verbinding kan maken, schema kan inspecteren, query's kan uitvoeren, scripts kan openen en taken met meerdere stappen in één gesprek kan doorlopen. Klik met de rechtermuisknop op een databaseknooppunt in de structuur Verbindingen en selecteer Verbinding maken met AI om een sessie in de agentmodus te starten.

Voor hulpprogrammafamilies, voorbeeldwerkstromen en probleemoplossing, gaat u verder naar de agentmodus.

De MCP-server gebruiken in ondersteunde hosts

De extensie registreert een PostgreSQL Tools MCP Server Provider (ID: pgsql-tools-mcp-server-provider) waarmee hetzelfde PostgreSQL-hulpprogramma wordt weergegeven via het Model Context Protocol. MET MCP compatibele hosts kunnen deze hulpprogramma's detecteren en aanroepen zonder gebruik te maken van de ingebouwde chatwerkstromen.

Voor ondersteunde hosts, gedrag van automatische registratie en de hulpprogrammafamilies die beschikbaar zijn via MCP, gaat u door naar de MCP-server.

Toegangsmodus configureren

De pgsql.copilot.accessMode instelling bepaalt hoeveel databasetoegang de AI-assistent ontvangt in de agentmodus en MCP-hulpprogramma's. De standaardwaarde is Lezen/schrijven (rw).

Waarde instellen Gebruikersinterface-label Wat de AI-assistent kan doen
ro Alleen-lezen Alleen-leesbewerkingen: SELECT, SHOW, EXPLAIN, schema-inspectie
rw Lezen/schrijven Leesbewerkingen plus instructies voor het wijzigen van gegevens en DDL, met expliciete bevestiging

Overschrijving per verbinding

U kunt ook de toegangsmodus voor afzonderlijke verbindingen instellen. Vouw in het verbindingsdialoogvenster de sectie Copilot (AI in Cursor) uit en stel Copilot toegangsmodus (AI-toegangsmodus in Cursor) in op een van:

Option Gedrag
Globale instelling gebruiken Terugvallen op de globale pgsql.copilot.accessMode waarde (standaard)
Alleen-lezen Dwingt alleen-lezentoegang voor deze verbinding af, ongeacht de globale instelling
Lezen/schrijven Dwingt lees-/schrijftoegang voor deze verbinding af, ongeacht de globale instelling

De extensie lost de effectieve toegangsmodus op met behulp van deze terugvalketen: waarde per verbinding → globale pgsql.copilot.accessMode instelling → standaardinstelling (rw).

Caution

Gebruik Alleen-lezen voor productiedatabases, tenzij u opzettelijk schema- of gegevenswijzigingen beschikbaar wilt maken via de AI-assistent.

Aanvullende instellingen configureren

Configuratie Wat het bestuurt Standaard
pgsql.copilot.enable Hiermee schakelt u alle AI-integratie in de extensie in of uit true
pgsql.copilot.accessMode Algemene AI-toegangsmodus (alleen-lezen of lezen/schrijven) rw
pgsql.copilot.autoAttachQuery Of SQL-querytekst wordt opgenomen bij het analyseren van plannen met AI: Elke keer vragen, Altijd opnemen of Nooit opnemen ask
pgsql.copilot.modelOptions Geavanceerde modelafstemming (max. tokens, temperatuur, top_p) voor de AI-werkstromen van de extensie -

Instellings-ID’s behouden in beide editors het voorvoegsel pgsql.copilot.* voor achterwaartse compatibiliteit, ook als de voor de gebruiker zichtbare labels ‘AI’ tonen.

Functiespecifieke AI-integraties

Verschillende functies omvatten specifieke AI-integratiepunten:

Feature AI-mogelijkheid
Visualisatie van queryplannen Analyseer gegevens van het uitvoeringsplan met Analyze with Copilot (of Analyze with AI in Cursor)
Serverdashboard Chatsessies openen via de knoppen Vraag het aan Copilot (Ask AI in Cursor) op de deelvensters Query's, Wachttijden, Sessies en deelvensters met metriekgrafieken
Schema visualiseren Schemarelaties visualiseren vanuit een werkstroom in de agentmodus

Verwante inhoud

  • Last updated on