Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Med agentläge kan AI-assistenten i redigeringsprogrammet använda PostgreSQL-verktyg från tillägget som en del av en enda konversation i flera steg. I stället för att bara besvara en fråga kan assistenten ansluta till en databas, inspektera schema, köra frågor, öppna skript och hjälpa dig att gå igenom ett arbetsflöde från slutpunkt till slutpunkt.
Agentläget körs i både Visual Studio Code (med GitHub Copilot) och Cursor (med sin inbyggda AI). Tillägget exponerar samma PostgreSQL-verktygsyta i båda redigerarna. endast den chattpanel som öppnas skiljer sig åt.
Använd agentläge när du vill att AI:n ska utföra strukturerade åtgärder, inte bara förklara eller skriva utkast till SQL.
Förutsättningar
Innan du börjar kontrollerar du att du har:
- PostgreSQL-tillägget har installerats.
- Copilot/AI-funktioner aktiverade i tillägget (
pgsql.copilot.enableärtrue). - Minst en databasanslutning som konfigurerats i tillägget.
- En AI-assistent som är tillgänglig i redigeringsprogrammet:
- Visual Studio Code: GitHub Copilot eller GitHub Copilot Chat installerat och aktivt.
- Cursor: ingen extra installation; inbyggd AI används automatiskt.
Starta agentläge
- Anslut till målservern eller databasen i PostgreSQL-tillägget.
- Högerklicka på den databas som du vill använda i trädet Anslutningar .
- Välj Anslut AI.
- Fortsätt konversationen i chattpanelen som öppnas med det arbetsflöde som du vill slutföra.
- I Visual Studio Code är det här github-Copilot Chat-panelen i agentläge.
- I Markören är det här markörens interna AI-panel. tillägget innehåller en kort MCP-orienterad ingress så att assistenten känner till de tillgängliga PostgreSQL-verktygen.
När sessionen har startat kan AI:n kombinera PostgreSQL-verktyg i bakgrunden medan den arbetar med din begäran.
Välj rätt åtkomstläge
Inställningen pgsql.copilot.accessMode styr hur mycket databasåtkomst agentläge tar emot. Inställnings-ID:t behåller sitt pgsql.copilot.* prefix för kompatibilitet. Etiketten som visas av användaren är Copilot åtkomstläge i Visual Studio Code- och AI-åtkomstläge i markören.
| Läge | Vad AI:n kan göra | Rekommenderad användning |
|---|---|---|
ro |
Skrivskyddade operationer som SELECT, SHOW, EXPLAIN, schemainspektion och analys |
Produktionssystem eller delade miljöer där du vill undersöka utan ändringar |
rw |
Läsoperationer samt datamodifierande satser och DDL, med uttrycklig bekräftelse innan körning | Lokal utveckling, disponibla sandbox-miljöer och kontrollerade testmiljöer |
Caution
Använd ro läge för produktionsdatabaser om du inte avsiktligt vill ha schema- eller dataändringar tillgängliga via agentläge.
Förstå verktygsfamiljerna
Agentläget kan använda flera verktygsfamiljer beroende på arbetsflödet.
| Verktygsfamilj | Vad det gör | När du använder den |
|---|---|---|
| Anslutningsverktyg | Lista profiler, ansluta, koppla från och lista databaser | Starta eller växla kontext |
| Schemakontextverktyg | Hämta objektdefinitioner eller visualisera schema | Förstå tabeller, vyer, funktioner, index och relationer |
| Frågeverktyg | Köra läsfrågor, inspektera frågeplaner, öppna skript | Undersöka data, validera idéer eller granska genererad SQL |
| Ändringsverktyg | Kör DDL eller DML med bekräftelse | Tillämpa kontrollerade schema- eller dataändringar i rw läge |
| Dataimportverktyg | Beskriva CSV-filer och massinläsa dem | Planera och köra CSV-importarbetsflöden |
Tip
I Cursor görs samma verktyg också tillgängliga via registrering av MCP-servern. Markörens interna chatt kan anropa dem direkt utan att använda startpunkten Anslut AI . Mer information finns i MCP-servern .
Använda agentläge för vanliga arbetsflöden
I följande exempel visas hur du använder agentläge för uppgifter som sträcker sig från att utforska en ny databas till att förfina frågor.
Utforska en okänd databas
Be AI:n att ansluta till databasen, lista nyckelobjekt och sammanfatta de schemaområden som är viktiga för din uppgift.
Exempel:
Anslut till min utvecklingsdatabas, lista tabellerna i det offentliga schemat och berätta vilka som ser ut som relaterade till kunder och beställningar.
Undersöka frågeprestanda
Be AI:n att kombinera schemakontext med frågekörning eller plangranskning.
Exempel:
Anslut till staging-databasen, kör den här frågan i skrivskyddsläge och förklara vilken del av exekveringsplanen som driver upp kostnaden.
Läsa in eller omforma data
Använd agentläge när arbetsflödet innehåller skript eller CSV-baserade åtgärder.
Exempel:
Granska den här CSV-filen, berätta vilket schema det innebär och förbered en säker importplan för
sales.recordstabellen.
Flytta från utkast till manuell granskning
När du vill ha en kontrollpunkt för mänsklig granskning före körning ber du AI:n att öppna den genererade SQL-filen i frågeredigeraren i stället för att köra den omedelbart.
Vet när agentläget ska användas i stället för @pgsql
Använd @pgsql chattdeltagare när du vill ha ett schemamedvetent svar eller ett frågeutkast. Deltagaren @pgsql är endast tillgänglig i Visual Studio Code.
Använd agentläge (tillgängligt i både Visual Studio Code och markör) när du vill att AI:n ska:
- anslut till rätt databas åt dig,
- kombinera flera verktyg i en och samma konversation,
- inspektera resultaten före nästa steg, eller
- förbered ett skript eller ett arbetsflöde för kontrollerade ändringar.
Note
I Cursor är agentläget det primära alternativet eftersom chattdeltagaren @pgsql inte är tillgänglig där. Samma verktygsyta kan också nås från markörens interna chatt via MCP-servern.
Felsök agentläge
Om agentläget inte fungerar som förväntat kontrollerar du först åtkomstläget och verktygets tillgänglighet.
AI:n kan inte ändra databasen
Kontrollera pgsql.copilot.accessMode och bekräfta att den aktiva anslutningen inte översätts till ro.
Verktyget du förväntar dig är inte tillgängligt
Kontrollera att Copilot integrering är aktiverad och att du har startat från en databas med en giltig PostgreSQL-anslutningskontext.
En anslutningsbegäran misslyckas
Bekräfta att anslutningsprofilen fortfarande finns, att autentiseringsuppgifterna är tillgängliga och att tillägget kan ansluta till samma databas utanför agentläget.
Jag vill ha ett enklare chattarbetsflöde
I Visual Studio Code använder du @pgsql chattdeltagare när du vill ha förklarings-, frågeutkastnings- eller schemafrågor utan verktygsdriven automatisering. I Cursor kan du ställa samma slags frågor som i den inbyggda chatten. Tilläggets MCP-verktyg kan fortfarande identifieras, men chatten beter sig mer konversationsmässigt utan en explicit post i agentläget.