integrace Copilot

Rozšíření PostgreSQL se integruje s asistenty AI prostřednictvím tří rozhraní: účastníka chatu @pgsql (pouze ve Visual Studio Code), nástrojů režimu agenta a poskytovatele serveru PostgreSQL Tools MCP. Tato stránka vám pomůže zvolit správný vstupní bod a pochopit sdílenou konfiguraci, která platí pro všechny tři.

Rozšíření běží v Visual Studio Code (s GitHub Copilot) i kurzorem (s integrovanou AI). Většina funkcí funguje stejným způsobem v obou editorech; V tomto článku se uvádí malý počet chování specifických pro editor.

Prerequisites

Před použitím jakékoli funkce s asistencí umělé inteligence se ujistěte, že jsou splněny následující požadavky:

  • Nainstaluje se rozšíření PostgreSQL a máte nakonfigurované aspoň jedno připojení k databázi.
  • Asistent AI je k dispozici v editoru:
    • Visual Studio Code: Nainstalujte GitHub Copilot nebo GitHub Copilot Chat a přihlaste se pomocí aktivního předplatného.
    • Kurzor: bez dodatečné instalace; Integrovaná AI se používá automaticky.

Note

Funkce Copilotu jsou ve výchozím nastavení zapnuté (pgsql.copilot.enable je true). Když tuto možnost nastavíte na false, účastník chatu @pgsql (pouze ve Visual Studio Code), podnabídka editoru AI Query Actions, nástroje režimu agenta a poskytovatel serveru MCP jsou skryty.

Tip

Pomoc s AI funguje nejlépe, když už máte aktivní připojení k databázi. Pokud jste se ještě nepřipojili, začněte částí Připojení a identita.

Výběr správného vstupního bodu

Pokud chcete... Začněte tady Availability Learn more
Položte otázku o své databázi s ohledem na její schéma @pgsql účastník chatu pouze Visual Studio Code @pgsql účastník chatu
Spusťte režim Agent s již vybranou konkrétní databází Připojení AI z databázového uzlu ve stromu Připojení Visual Studio Code a Cursor Režim agenta
Vysvětlení, přepsání nebo analýza SQL z editoru Podnabídka Akce pro dotazy AI v kontextové nabídce editoru Visual Studio Code a Cursor Akce editoru
Automatizace vícekrokové databázové úlohy Připojení AI k databázovému uzlu a spuštění režimu agenta Visual Studio Code a Cursor Režim agenta
Zveřejnění nástrojů PostgreSQL pro hostitele kompatibilní s MCP Zprostředkovatel serveru PostgreSQL Tools MCP Visual Studio Code a Cursor Server MCP

Použití @pgsql pro chat s podporou schématu

Note

Účastník chatu @pgsql je zaregistrovaný jenom v Visual Studio Code, kde se připojí k Copilot Chat GitHubu. V aplikaci Cursor použijte Connect AI z uzlu databáze ve stromu Connections ke spuštění režimu Agenta se stejným kontextem schématu, nebo se spolehněte na server MCP v nativním chatu aplikace Cursor.

Rozšíření zaregistruje účastníka chatu @pgsql (ID: vscode-postgresql.chat-agent) pro konverzace pracující se schématem v Copilot Chat GitHubu. Zadejte @pgsql a poté svůj dotaz; odpověď se vygeneruje s využitím aktuálního kontextu schématu z vaší připojené databáze.

Pokud chcete spustit pracovní postup s využitím nástrojů s již vybranou databází, klikněte pravým tlačítkem myši na uzel databáze ve stromu Connections a vyberte možnost Connect AI.

Pokyny pro koncové uživatele, ukázky zadání a informace k řešení potíží najdete na @pgsql účastník chatu.

Použití akcí editoru pro nápovědu zaměřenou na dotazy

Pokud máte v editoru dotazů otevřený JAZYK SQL, kliknutím pravým tlačítkem myši vyhledejte podnabídku Akce dotazů AI . Obsahuje následující akce:

Činnost Description
Vysvětlit dotaz Vrátí vysvětlení dotazu ve formátu prostého jazyka.
Přepsání dotazu Navrhuje alternativní verzi dotazu při zachování zamýšleného výsledku.
Analýza výkonu dotazů Spustí EXPLAIN ANALYZE nad připojenou databází a poté odešle plán spuštění umělé inteligenci k analýze.

Na panelu nástrojů v editoru můžete také vybrat možnost Zeptat se AI na tento dotaz, čímž otevřete chat vycházející z aktuálního obsahu editoru.

Pokud chcete resetovat zapamatované předvolby zahrnutí dotazů pro analýzu plánu, spusťte z Palety příkazů příkaz Vymazat předvolby zahrnutí dotazů pro analýzu AI.

Použití režimu agenta pro pracovní postupy řízené nástroji

Režim agenta poskytuje asistentovi AI přístup k nástrojům PostgreSQL, aby se mohl připojit, kontrolovat schéma, spouštět dotazy, otevírat skripty a pracovat s více kroky v jedné konverzaci. Klikněte pravým tlačítkem myši na uzel databáze ve stromu Připojení a výběrem možnosti Připojit AI spusťte relaci v režimu agenta.

U rodin nástrojů, například pracovních postupů a řešení potíží, pokračujte do režimu agenta.

Použití serveru MCP v podporovaných hostitelích

Rozšíření registruje poskytovatele serveru PostgreSQL Tools MCP (ID: pgsql-tools-mcp-server-provider), který prostřednictvím protokolu Model Context Protocol zpřístupňuje stejnou sadu nástrojů PostgreSQL. Hostitelé kompatibilní s protokolem MCP mohou tyto nástroje vyhledávat a volat, aniž by používali integrované chatové pracovní postupy.

Informace o podporovaných hostitelích, chování automatické registrace a rodinách nástrojů zpřístupněných prostřednictvím MCP najdete v části server MCP.

Konfigurace režimu přístupu

Nastavení pgsql.copilot.accessMode určuje, kolik databáze získá pomocník s AI v režimu agenta a nástrojích MCP. Výchozí hodnota je read/write (rw).

Nastavení hodnoty Popisek uživatelského rozhraní Co může asistent AI dělat
ro Jen ke čtení Operace jen pro čtení: SELECT, SHOW, EXPLAIN, kontrola schématu
rw Čtení a zápis Operace čtení a příkazy pro úpravy dat a DDL s explicitním potvrzením

Přepsání pro jednotlivá připojení

Režim přístupu můžete nastavit také u jednotlivých připojení. V dialogovém okně připojení rozbalte oddíl Copilot (AI v kurzoru) a nastavte Copilot režim přístupu (režim přístupu AI v kurzoru) na jednu z těchto možností:

Option Behavior
Použít globální nastavení Vrátí se do globální pgsql.copilot.accessMode hodnoty (výchozí)
Jen ke čtení Vynutí přístup pouze pro čtení u tohoto připojení bez ohledu na globální nastavení.
Čtení a zápis Vynutí oprávnění ke čtení a zápisu pro toto připojení bez ohledu na globální nastavení.

Rozšíření vyřeší efektivní režim přístupu pomocí tohoto záložního řetězce: hodnota pro připojení → globální pgsql.copilot.accessMode nastavení → výchozí (rw).

Caution

Používejte jen pro čtení pro produkční databáze, pokud nechcete, aby schéma nebo změny dat byly dostupné prostřednictvím pomocníka s AI.

Konfigurace dalších nastavení

Nastavení Co to řídí Výchozí
pgsql.copilot.enable Povolí nebo zakáže veškerou integraci AI v rozšíření. true
pgsql.copilot.accessMode Globální režim přístupu AI (Jen pro čtení nebo Čtení/zápis) rw
pgsql.copilot.autoAttachQuery Zda se má při analýze plánů pomocí AI zahrnovat text dotazu SQL: Zeptat se vždy, Vždy zahrnout nebo Nikdy nezahrnout ask
pgsql.copilot.modelOptions Pokročilé ladění modelů (maximální počet tokenů, teplota, top_p) pro pracovní postupy AI rozšíření -

ID nastavení ponechávají předponu pgsql.copilot.* v obou editorech kvůli zpětné kompatibilitě, i když uživateli zobrazované popisky uvádějí „AI“.

Integrace AI pro konkrétní funkce

Několik funkcí zahrnuje vyhrazené integrační body pro AI:

funkce Funkce AI
Vizualizér plánu dotazů Analyzujte data plánu spuštění pomocí Analyzovat pomocí Copilotu (nebo Analyzovat pomocí AI v Cursoru)
Řídicí panel serveru Otevřít chatovací relace z tlačítek Zeptejte se Copilota (Ask AI v aplikaci Cursor) na panelech Dotazy, Čekání, Relace a grafů metrik
Vizualizér schématu Vizualizace relací schématu z pracovního postupu režimu agenta

Související obsah

  • Last updated on