Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Režim agenta umožňuje asistentovi AI v editoru používat nástroje PostgreSQL z rozšíření jako součást jediné konverzace s více kroky. Místo odpovědi na otázku se asistent může připojit k databázi, zkontrolovat schéma, spouštět dotazy, otevírat skripty a procházet koncem pracovního postupu.
Režim agenta běží v Visual Studio Code (s GitHub Copilot) i kurzorem (s integrovanou AI). Rozšíření zveřejňuje stejnou plochu nástrojů PostgreSQL v obou editorech; liší se jenom panel chatu, který se otevře.
Použijte režim Agent, když chcete, aby AI prováděla strukturované akce, nejen vysvětlovala nebo navrhovala SQL.
Prerequisites
Než začnete, ujistěte se, že máte:
- Nainstalované rozšíření PostgreSQL.
- Funkce Copilot/AI povolené v rozšíření (
pgsql.copilot.enablejetrue). - Alespoň jedno připojení k databázi nakonfigurované v rozšíření.
- Asistent AI dostupný v editoru:
- Visual Studio Code: GitHub Copilot nebo GitHub Copilot Chat nainstalovaný a aktivní.
- Kurzor: bez dodatečné instalace; Integrovaná AI se používá automaticky.
Spuštění režimu agenta
- Připojte se k cílovému serveru nebo databázi v rozšíření PostgreSQL.
- Ve stromu Připojení klikněte pravým tlačítkem myši na databázi, kterou chcete použít.
- Vyberte Připojit AI.
- Pokračujte v konverzaci na panelu chatu, který se otevře s pracovním postupem, který chcete dokončit.
- V Visual Studio Code se jedná o panel Copilot Chat GitHubu v režimu agenta.
- V kurzoru je to nativní panel AI kurzoru; rozšíření poskytuje stručnou preambuli zaměřenou na MCP, aby asistent věděl o dostupných nástrojích PostgreSQL.
Po zahájení relace může AI při zpracovávání vašeho požadavku na pozadí kombinovat nástroje PostgreSQL.
Volba správného režimu přístupu
Nastavení pgsql.copilot.accessMode určuje, kolik režimu agenta přístupu k databázi obdrží. ID nastavení si kvůli kompatibilitě ponechává předponu pgsql.copilot.*; popisek zobrazovaný uživateli je ve Visual Studio Code režim přístupu Copilot a v Cursor režim přístupu AI.
| Mode | Co může AI dělat | Doporučené použití |
|---|---|---|
ro |
Operace pouze pro čtení, jako jsou SELECT, SHOW, EXPLAIN, kontrola schématu a analýza |
Produkční systémy nebo sdílená prostředí, ve kterých chcete zkoumat beze změn |
rw |
Operace čtení a příkazy pro úpravy dat a DDL s explicitním potvrzením před spuštěním | Lokální vývoj, dočasná sandboxová prostředí a řízená testovací prostředí |
Caution
Režim ro používejte pro produkční databáze, pokud záměrně nechcete, aby byly změny schématu nebo dat dostupné prostřednictvím režimu Agenta.
Vysvětlení rodin nástrojů
Režim agenta může v závislosti na pracovním postupu používat více rodin nástrojů.
| Řada nástrojů | Jak funguje | Když ji použijete |
|---|---|---|
| Nástroje pro připojení | Vypsat profily, připojit, odpojit, vypsat databáze | Spusťte nebo přepněte kontext |
| Nástroje kontextu schématu | Načtení definic objektů nebo vizualizace schématu | Principy tabulek, zobrazení, funkcí, indexů a relací |
| Nástroje pro dotazování | Spouštění dotazů pro čtení, kontrola plánů dotazů, otevření skriptů | Zkoumání dat, ověření nápadů nebo kontrola vygenerovaného SQL |
| Nástroje pro úpravy | Spusťte DDL nebo DML po potvrzení | Použití kontrolovaných změn schématu nebo dat v rw režimu |
| Nástroje pro import dat | Popsat soubory CSV a hromadně je načíst | Plánování a spuštění pracovních postupů importu CSV |
Tip
V kurzoru se také zobrazují stejné nástroje prostřednictvím registrace serveru MCP. Nativní chat aplikace Cursor je může volat přímo, aniž by používal vstupní bod Connect AI. Podrobnosti najdete na serveru MCP .
Použití režimu agenta pro běžné pracovní postupy
Následující příklady ukazují, jak používat režim agenta pro úlohy v rozsahu od zkoumání nové databáze až po upřesnění dotazů.
Prozkoumání neznámé databáze
Požádejte AI, aby se připojila k databázi, vypsala klíčové objekty a shrnula oblasti schématu, které jsou pro váš úkol důležité.
Příklad:
Připojte se k vývojové databázi, vypište tabulky ve veřejném schématu a řekněte mi, které z nich vypadají v souvislosti se zákazníky a objednávkami.
Zkoumání výkonu dotazů
Požádejte AI, aby zkombinuje kontext schématu s prováděním dotazů nebo kontrolou plánu.
Příklad:
Připojte se k pracovní databázi, spusťte tento dotaz v režimu jen pro čtení a vysvětlete, která část plánu provádění řídí náklady.
Načtení nebo změna tvaru dat
Režim agenta použijte, pokud pracovní postup obsahuje skripty nebo operace založené na csv.
Příklad:
Projděte si tento soubor CSV, řekněte mi, jaké schéma to znamená, a připravte plán bezpečného importu
sales.recordspro tabulku.
Přesunout z návrhu na ruční kontrolu
Pokud chcete kontrolní bod kontroly člověka před spuštěním, požádejte AI, aby otevřela vygenerovaný SQL v editoru dotazů místo toho, aby ho okamžitě spustila.
Zjistěte, kdy používat režim agenta místo @pgsql
Když chcete odpověď se znalostí schématu nebo návrh dotazu, použijte účastníka chatu @pgsql. Účastník @pgsql je k dispozici pouze v Visual Studio Code.
Režim agenta (k dispozici v Visual Studio Code i kurzoru) použijte, pokud chcete, aby AI:
- připojte se ke správné databázi pro vás,
- propojit více nástrojů v jedné konverzaci,
- kontrola výsledků před dalším krokem nebo
- připravte skript nebo řízený pracovní postup úprav.
Note
Ve Cursoru je režim agenta hlavní možností, protože @pgsql účastník chatu tam není k dispozici. Stejná plocha nástrojů je také dostupná z nativního chatu Kurzoru prostřednictvím serveru MCP.
Řešení potíží s režimem agenta
Pokud se režim agenta nechová podle očekávání, nejprve zkontrolujte režim přístupu a dostupnost nástrojů.
AI nemůže upravit databázi.
Zkontrolujte pgsql.copilot.accessMode a ověřte, že aktivní připojení není přeloženo na ro.
Očekávaný nástroj není k dispozici.
Ujistěte se, že je povolená integrace Copilot a že jste začali z databáze s platným kontextem připojení PostgreSQL.
Žádost o připojení selže.
Ověřte, že profil připojení stále existuje, jsou k dispozici přihlašovací údaje a rozšíření se může připojit ke stejné databázi mimo režim agenta.
Chci jednodušší pracovní postup s důrazem na chat
V Visual Studio Code použijte účastníka konverzace @pgsql, když chcete vysvětlení, návrh dotazů nebo odpovědi na otázky ke schématu bez automatizace řízené nástroji. V kurzoru položte stejné druhy otázek z nativního chatu. Nástroje MCP rozšíření jsou stále dohledatelné, ale chat se bez explicitní položky Režim agenta chová více konverzačně.