A Copilot integráció

A PostgreSQL-bővítmény három felületen integrálható az AI-asszisztensekkel: a @pgsql csevegés résztvevőjével (csak Visual Studio Code), az Ügynök mód eszközeivel és a PostgreSQL Tools MCP-kiszolgálószolgáltatójával. Ezen a lapon kiválaszthatja a megfelelő belépési pontot, és megismerheti a háromra vonatkozó megosztott konfigurációt.

A bővítmény Visual Studio Code-ban (GitHub Copilottal) és Cursorban (a beépített MI-jével) is fut. A legtöbb funkció ugyanúgy működik mindkét szerkesztőben; ebben a cikkben a szerkesztőspecifikus viselkedések kis száma jelenik meg.

Prerequisites

Mielőtt bármilyen AI-támogatással rendelkező funkciót használ, győződjön meg arról, hogy a következő követelmények teljesülnek:

  • A PostgreSQL-bővítmény telepítve van, és legalább egy adatbázis-kapcsolat van konfigurálva.
  • A szerkesztőben elérhető egy AI-asszisztens:
    • Visual Studio Code: telepítse GitHub Copilot vagy GitHub Copilot csevegést, és jelentkezzen be aktív előfizetéssel.
    • Kurzor: nincs további telepítés; a beépített AI automatikusan használatban van.

Megjegyzés:

Copilot funkciók alapértelmezés szerint engedélyezve vannak (pgsql.copilot.enable is true). Ha ezt falsea beállítást állítja be, a @pgsql csevegés résztvevője (csak Visual Studio Code), az AI Query Actions szerkesztő almenüje, az Ügynök mód eszközei és az MCP-kiszolgálószolgáltató mind rejtve marad.

Tip

Az AI-támogatás akkor működik a legjobban, ha már rendelkezik aktív adatbázis-kapcsolattal. Ha még nem csatlakozott, kezdje a kapcsolatok és az identitás használatával.

A megfelelő belépési pont kiválasztása

Ha szeretnéd... Kezdje itt Availability Learn more
Sémaérzékeny kérdés feltevése az adatbázissal kapcsolatban @pgsql csevegés résztvevője csak Visual Studio Code @pgsql csevegés résztvevője
Ügynök mód indítása egy adott adatbázissal, amely már hatókörben van AI csatlakoztatása adatbáziscsomópontról a Kapcsolatok fában Visual Studio Code és kurzor Ügynök mód
SQL magyarázata, átírása vagy elemzése a szerkesztőből AI Lekérdezési műveletek almenü a szerkesztő helyi menüjében Visual Studio Code és kurzor Szerkesztőműveletek
Többlépéses adatbázis-feladat automatizálása Connect AI csatlakoztatása egy adatbáziscsomóponton az Agent mód elindításához Visual Studio Code és kurzor Ügynök mód
PostgreSQL-eszközök elérhetővé tétele MCP-kompatibilis hosztok számára PostgreSQL Tools MCP-kiszolgálószolgáltató Visual Studio Code és kurzor MCP-kiszolgáló

Sémaérzékeny csevegéshez használható @pgsql

Megjegyzés:

Az @pgsql csevegőpartner csak a Visual Studio Code-ban van regisztrálva, ahol a GitHub Copilot Chatbe integrálódik. A Kurzorban a Kapcsolatok fa adatbáziscsomópontjáról származó AI csatlakoztatásával indítsa el az Ügynök módot ugyanazzal a sémakörnyezettel, vagy támaszkodjon a Kurzor natív csevegőfelületén található MCP-kiszolgálóra.

A bővítmény regisztrál egy @pgsql csevegő résztvevőt (azonosító: vscode-postgresql.chat-agent) a GitHub Copilot Chat sémaérzékeny beszélgetéseihez. Írja be a(z) @pgsql elemet, majd a kérdését, és a rendszer a csatlakoztatott adatbázis élő sémakörnyezetét használva válaszol.

Ha eszközalapú munkafolyamatot szeretne elindítani egy már hatókörben lévő adatbázissal, kattintson a jobb gombbal egy adatbáziscsomópontra a Kapcsolatok fában, és válassza az AI csatlakoztatása lehetőséget.

A végfelhasználóknak szóló útmutatásért, mintaparancsokért és hibaelhárításért továbbra is a @pgsql chat participant elemhez forduljon.

Szerkesztőműveletek használata lekérdezésközpontú súgóhoz

Ha meg van nyitva az SQL a lekérdezésszerkesztőben, a jobb gombbal kattintva keresse meg az AI Query Actions almenüt . A következő műveleteket tartalmazza:

Action Description
Lekérdezés magyarázata A lekérdezés tevékenységének egyszerű nyelvi magyarázatát adja vissza.
Lekérdezés újraírása A lekérdezés alternatív verzióját javasolja a kívánt eredmény megőrzése mellett.
Lekérdezési teljesítmény elemzése Fut EXPLAIN ANALYZE a csatlakoztatott adatbázison, majd elküldi a végrehajtási tervet az AI-nek elemzés céljából.

A szerkesztő eszköztárán az Kérdezze meg az MI-t erről a lekérdezésről lehetőséget is kiválaszthatja, hogy megnyisson egy, az aktuális szerkesztő tartalmára épülő csevegést.

Ha a tervelemzéshez megjegyzett lekérdezésbefoglalási beállításokat szeretné visszaállítani, futtassa az AI-elemzésre vonatkozó lekérdezésbefoglalási beállítások törlését a parancskatalógusból.

Ügynök mód használata eszközalapú munkafolyamatokhoz

Az ügynök mód hozzáférést biztosít az AI-asszisztensnek a PostgreSQL-eszközökhöz, így csatlakozhat, megvizsgálhatja a sémákat, lekérdezéseket futtathat, szkripteket nyithat meg, és többlépéses feladatokkal dolgozhat egy beszélgetésben. Kattintson a jobb gombbal egy adatbáziscsomópontra a Kapcsolatok fában, és válassza az AI csatlakoztatása lehetőséget az ügynök módú munkamenet elindításához.

Az eszközcsaládok, például munkafolyamatok és hibaelhárítás esetén folytassa az Ügynök üzemmódot.

Az MCP-kiszolgáló használata támogatott gazdaalkalmazásokban

A bővítmény regisztrál egy PostgreSQL Tools MCP-kiszolgálószolgáltatót (azonosító: pgsql-tools-mcp-server-provider) amely ugyanazt a PostgreSQL-eszközfelületet teszi elérhetővé a Model Context Protocolon keresztül. Az MCP-kompatibilis hosztok a beépített csevegési munkafolyamatok használata nélkül is felfedezhetik és meghívhatják ezeket az eszközöket.

A támogatott hosztokkal, az automatikus regisztráció működésével és az MCP-n keresztül elérhető eszközcsaládokkal kapcsolatban lásd: MCP server.

Hozzáférési mód konfigurálása

A pgsql.copilot.accessMode beállítás azt szabályozza, hogy az AI-asszisztens mennyi adatbázis-hozzáférést kap ügynök módban és MCP-eszközökben. Az alapértelmezett érték az Olvasás/Írás (rw).

Beállítás értéke Felhasználói felület címkéje Az AI-asszisztens által elvégezhető műveletek
ro Írásvédett Csak olvasható műveletek: SELECT, SHOW, EXPLAIN, séma vizsgálata
rw Olvasás/írás Olvasási műveletek, valamint adatmódosítási utasítások és DDL, explicit megerősítéssel

Kapcsolatonkénti felülbírálás

A hozzáférési módot az egyes kapcsolatokon is beállíthatja. A kapcsolati párbeszédpanelen bontsa ki a Copilot szakaszt (AI a kurzorban), és állítsa Copilot hozzáférési módot (AI hozzáférési mód a Kurzorban) a következőre:

Option Viselkedés
Globális beállítás használata Visszaesik a globális pgsql.copilot.accessMode értékre (alapértelmezett)
Írásvédett Csak olvasható hozzáférést kényszerít ennél a kapcsolatnál a globális beállítástól függetlenül
Olvasás/írás Olvasási/írási hozzáférés kényszerítése ehhez a kapcsolathoz a globális beállítástól függetlenül

A bővítmény a következő tartaléklánc alapján határozza meg az effektív hozzáférési módot: kapcsolatonkénti érték → globális pgsql.copilot.accessMode beállítás → alapértelmezett érték (rw).

Caution

Éles adatbázisokhoz használja a Csak olvasható beállítást, hacsak nem szeretné kifejezetten, hogy az AI-asszisztensen keresztül séma- vagy adatmódosítások is elérhetők legyenek.

További beállítások konfigurálása

Beállítás Amit vezérel Alapértelmezett
pgsql.copilot.enable Engedélyezi vagy letiltja a bővítmény összes AI-integrációját true
pgsql.copilot.accessMode Globális AI-hozzáférési mód (csak olvasható vagy olvasás/írás) rw
pgsql.copilot.autoAttachQuery Belefoglalják-e az SQL-lekérdezés szövegét a tervek AI általi elemzésekor: Kérdezzen rá minden alkalommal, Mindig foglalja bele vagy Soha ne foglalja bele ask
pgsql.copilot.modelOptions Speciális modellhangolás (maximális tokenszám, hőmérséklet, top_p) a bővítmény MI-munkafolyamataihoz -

A beállításazonosítók mindkét szerkesztőben megőrzik az pgsql.copilot.* előtagot a visszamenőleges kompatibilitás érdekében, még akkor is, ha a felhasználó által látható címkék "AI"-t mondanak.

Funkcióspecifikus AI-integrációk

Számos funkció tartalmaz dedikált AI-integrációs pontokat:

Funkció AI-képesség
Lekérdezésterv-vizualizáció A végrehajtási terv adatainak elemzése Elemzés a Copilottal (vagy Elemzés MI-vel a Cursorban)
Kiszolgáló irányítópultja Csevegési munkamenetek nyitása a Queries, Waits, Sessions és a metrikadiagram-paneleken található A Copilot megkérdezése gombokból (Ask AI a Cursorban)
Sémamegjelenítő Sémakapcsolatok megjelenítése ügynök módú munkafolyamatból