Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Az ügynök mód lehetővé teszi, hogy a szerkesztő AI-asszisztense egyetlen többlépéses beszélgetés részeként használja a bővítmény PostgreSQL-eszközeit. Ahelyett, hogy csak választ adna egy kérdésre, az asszisztens csatlakozhat egy adatbázishoz, megvizsgálhatja a sémát, lekérdezéseket futtathat, szkripteket nyithat meg, és végighaladhat a munkafolyamatok végéig.
Az ügynökmód a Visual Studio Code-ban (a GitHub Copilottal) és a Cursorben (a beépített AI-jával) is működik. A bővítmény ugyanazt a PostgreSQL-eszközfelületet teszi elérhetővé mindkét szerkesztőben; csak a megnyíló csevegőpanel különbözik.
Az Ügynök módot akkor használja, ha azt szeretné, hogy az AI strukturált műveleteket hajt végre, és ne csak az SQL ismertetését vagy vázlatát.
Prerequisites
Mielőtt hozzákezd, győződjön meg arról, hogy:
- A PostgreSQL-bővítmény telepítve van.
- Copilot/AI-funkciók engedélyezve a bővítményben (
pgsql.copilot.enableistrue). - Legalább egy adatbázis-kapcsolat konfigurálva van a bővítményben.
- A szerkesztőben elérhető AI-asszisztens:
- Visual Studio Code: GitHub Copilot vagy GitHub Copilot Csevegés telepítve és aktív.
- Kurzor: nincs további telepítés; a beépített AI automatikusan használatban van.
Ügynök mód indítása
- Csatlakozzon a célkiszolgálóhoz vagy adatbázishoz a PostgreSQL-bővítményben.
- A Kapcsolatok fában kattintson a jobb gombbal a használni kívánt adatbázisra.
- Válassza a Connect AI (AI csatlakoztatása) lehetőséget.
- Folytassa a beszélgetést a befejezendő munkafolyamattal megnyíló csevegési panelen.
- A Visual Studio Code-ban ez a GitHub Copilot Chat panelje ügynök módban.
- A Kurzorban ez a Kurzor natív AI-panelje; a bővítmény rövid MCP-orientált preambulumot biztosít, hogy az asszisztens tudjon az elérhető PostgreSQL-eszközökről.
A munkamenet megkezdése után az AI a színfalak mögött összekapcsolhatja a PostgreSQL-eszközöket, miközben a kérésedet dolgozza fel.
A megfelelő hozzáférési mód kiválasztása
A pgsql.copilot.accessMode beállítás szabályozza, hogy az Ügynök mód mekkora adatbázis-hozzáférést kap. A beállításazonosító kompatibilitási okokból megtartja a pgsql.copilot.*előtagját; a felhasználók számára látható címke a Visual Studio Code-ban a Copilot hozzáférési mód, a Cursorban pedig a AI-hozzáférési mód.
| Üzemmód | Az AI által elvégezhető műveletek | Ajánlott használat |
|---|---|---|
ro |
Csak olvasási műveletek, például SELECT, SHOW, EXPLAIN, séma ellenőrzése és elemzés |
Éles rendszerek vagy megosztott környezetek, ahol változtatások nélkül szeretne vizsgálatot végezni |
rw |
Olvasási műveletek, valamint adatmódosítási utasítások és DDL, a végrehajtás előtt kifejezett megerősítéssel | Helyi fejlesztés, eldobható tesztkörnyezetek és ellenőrzött tesztkörnyezetek |
Caution
Éles adatbázisokhoz használható ro mód, kivéve, ha szándékosan szeretné, hogy a séma vagy az adatváltozások ügynök módban elérhetők legyen.
Az eszközcsaládok ismertetése
Az ügynök mód a munkafolyamattól függően több eszközcsaládot is használhat.
| Eszközcsalád | Mire szolgál? | Amikor használja |
|---|---|---|
| Kapcsolati eszközök | Profilok listázása, kapcsolódás, leválasztás, adatbázisok listázása | Kontextus indítása vagy váltása |
| Sémakörnyezet eszközei | Objektumdefiníciók lekérése vagy séma vizualizációja | Táblák, nézetek, függvények, indexek és kapcsolatok ismertetése |
| Lekérdezési eszközök | Olvasási lekérdezések futtatása, lekérdezéstervek vizsgálata, szkriptek megnyitása | Adatok vizsgálata, ötletek érvényesítése vagy a létrehozott SQL áttekintése |
| Módosítási eszközök | DDL vagy DML futtatása megerősítéssel | Szabályozott séma vagy adatváltozások rw alkalmazása módban |
| Adatimportálási eszközök | CSV-fájlok leírása és tömeges betöltése | CSV-importálási munkafolyamatok tervezése és végrehajtása |
Tip
A kurzorban ugyanezek az eszközök az MCP-kiszolgáló regisztrációja révén is felszínre kerülnek. A Cursor beépített chatje a Connect AI belépési felület használata nélkül is közvetlenül elérheti őket. Részletekért tekintse meg az MCP-kiszolgálót .
Ügynök mód használata gyakori munkafolyamatokhoz
Az alábbi példák bemutatják, hogyan használható az Ügynök mód az új adatbázis feltárásától a lekérdezések pontosításán át a feladatokig.
Ismeretlen adatbázis felfedezése
Kérje meg az AI-t, hogy csatlakozzon az adatbázishoz, sorolja fel a kulcsobjektumokat, és foglalja össze a tevékenység szempontjából fontos sématerületeket.
Példa:
Csatlakozzon a fejlesztési adatbázisomhoz, listázhassa a nyilvános sémában lévő táblákat, és mondja el, hogy mely táblák kapcsolódnak az ügyfelekhez és a megrendelésekhez.
Lekérdezési teljesítmény vizsgálata
Kérje meg az AI-t, hogy kombinálja a sémakörnyezetet a lekérdezés végrehajtásával vagy a tervvizsgálattal.
Példa:
Csatlakozzon az átmeneti adatbázishoz, futtassa ezt a lekérdezést írásvédett módban, és magyarázza el, hogy a végrehajtási terv mely része vezet a költségekhez.
Adatok betöltése vagy átalakítása
Ügynök mód használata, ha a munkafolyamat parancsfájlokat vagy CSV-alapú műveleteket tartalmaz.
Példa:
Tekintse át ezt a CSV-fájlt, mondja el, milyen sémát jelent, és készítsen biztonságos importálási tervet a
sales.recordstáblához.
Váltás piszkozatról manuális felülvizsgálatra
Ha a végrehajtás előtt emberi ellenőrzőpontot szeretne, kérje meg az AI-t, hogy ahelyett, hogy azonnal futtatja, nyissa meg a létrehozott SQL-t a lekérdezésszerkesztőben.
Tudja, mikor érdemes ügynök üzemmódot használni ahelyett, hogy @pgsql
Ha sémaismerő választ vagy lekérdezéstervezetet szeretne, használja a(z) @pgsql csevegőrésztvevőt. A @pgsql résztvevő csak a Visual Studio Code-ban érhető el.
Az Ügynök mód használata (Visual Studio Code és kurzor esetén is elérhető), ha az AI-t a következőre szeretné használni:
- kapcsolódni az Önnek megfelelő adatbázishoz,
- több eszköz összekapcsolása egy beszélgetésben,
- a következő lépés előtt vizsgálja meg az eredményeket, vagy
- szkript vagy szabályozott módosítási munkafolyamat előkészítése.
Megjegyzés:
A Kurzor módban az ügynök mód az elsődleges elérési út, mert a @pgsql csevegés résztvevője nem érhető el ott. Ugyanez az eszközfelület a Kurzor natív csevegéséből is elérhető az MCP-kiszolgálón keresztül.
Ügynök mód hibaelhárítása
Ha az Ügynök mód nem a várt módon működik, először ellenőrizze a hozzáférési módot és az eszköz rendelkezésre állását.
Az AI nem tudja módosítani az adatbázist
Ellenőrizze a(z) pgsql.copilot.accessMode elemet, és erősítse meg, hogy az aktív kapcsolat nem a(z) ro elemre oldódik fel.
A várt eszköz nem érhető el
Győződjön meg arról, hogy Copilot integráció engedélyezve van, és hogy egy érvényes PostgreSQL-kapcsolati környezettel rendelkező adatbázisból indult.
A kapcsolatkérés meghiúsul
Győződjön meg arról, hogy a kapcsolati profil továbbra is létezik, a hitelesítő adatok elérhetők, és a bővítmény az Ügynök módon kívül is csatlakozhat ugyanahhoz az adatbázishoz.
Egyszerűbb csevegési munkafolyamatot szeretnék
Az Visual Studio Code @pgsql csevegő résztvevőt akkor használja, ha magyarázatra, lekérdezés-összeállításra vagy sémakérdésre van szüksége eszközalapú automatizálás nélkül. A Kurzor alkalmazásban tegye fel ugyanazokat a kérdéseket a natív csevegésből. A bővítmény MCP-eszközei továbbra is elérhetők, de a csevegés külön Agent mód bejegyzés nélkül is inkább társalgási módon működik.