Integracja z kopilotem

Rozszerzenie PostgreSQL integruje się z asystentami AI za pośrednictwem trzech interfejsów: uczestnika czatu @pgsql (tylko w programie Visual Studio Code), narzędzi Agent mode oraz dostawcy serwera MCP PostgreSQL Tools. Ta strona pomaga wybrać właściwy punkt wejścia i zrozumieć konfigurację udostępnioną, która ma zastosowanie we wszystkich trzech.

Rozszerzenie działa zarówno w Visual Studio Code (z GitHub Copilot), jak i w Cursor (z wbudowaną funkcją AI). Większość funkcji działa tak samo w obu edytorach; nieliczne zachowania specyficzne dla danego edytora zostały wskazane w całym artykule.

Wymagania wstępne

Przed użyciem dowolnej funkcji wspomaganej przez sztuczną inteligencję upewnij się, że zostały spełnione następujące wymagania:

  • Zainstalowano rozszerzenie PostgreSQL i skonfigurowano co najmniej jedno połączenie z bazą danych.
  • Asystent sztucznej inteligencji jest dostępny w edytorze:
    • Visual Studio Code: zainstaluj GitHub Copilot lub czat GitHub Copilot i zaloguj się przy użyciu aktywnej subskrypcji.
    • Kursor: brak dodatkowej instalacji; wbudowana sztuczna inteligencja jest używana automatycznie.

Note

Funkcje Copilot są domyślnie włączone (pgsql.copilot.enable jest true). Gdy ustawisz tę opcję na false, uczestnik czatu @pgsql (tylko w Visual Studio Code), podmenu edytora Akcje zapytań AI, narzędzia trybu agenta i dostawca serwera MCP są ukrywane.

Wskazówka

Pomoc dotycząca sztucznej inteligencji działa najlepiej, gdy masz już aktywne połączenie z bazą danych. Jeśli jeszcze nie nawiązaliśmy połączenia, zacznij od połączeń i tożsamości.

Wybieranie właściwego punktu wejścia

Jeśli chcesz... Zacznij tutaj Availability Learn more
Zadaj pytanie o swoją bazę danych, uwzględniając jej schemat @pgsql uczestnik czatu tylko Visual Studio Code uczestnik czatu @pgsql
Uruchom tryb Agent z określoną bazą danych już uwzględnioną w kontekście Połącz AI z poziomu węzła bazy danych w drzewie Połączenia Visual Studio Code i kursor Tryb agenta
Wyjaśnienie, ponowne zapisywanie lub analizowanie kodu SQL z poziomu edytora Podmenu AI Query Actions w menu kontekstowym edytora Visual Studio Code i kursor Akcje edytora
Automatyzowanie zadania wieloetapowej bazy danych Łączenie sztucznej inteligencji w węźle bazy danych w celu uruchomienia trybu agenta Visual Studio Code i kursor Tryb agenta
Uwidacznianie narzędzi PostgreSQL na hostach zgodnych z programem MCP Dostawca serwera MCP narzędzi PostgreSQL Visual Studio Code i kursor Serwer MCP

Użyj @pgsql do czatu ze świadomością schematu

Note

Uczestnik czatu @pgsql jest zarejestrowany tylko w Visual Studio Code, gdzie jest podłączony do usługi GitHub Copilot Chat. W Cursor użyj Connect AI z węzła bazy danych w drzewie Connections, aby uruchomić tryb agenta z tym samym kontekstem schematu, albo skorzystaj z serwera MCP w natywnym czacie Cursor.

Rozszerzenie rejestruje uczestnika czatu @pgsql (identyfikator: vscode-postgresql.chat-agent) na potrzeby konwersacji obsługujących schemat w usłudze GitHub Copilot Chat. Wpisz @pgsql, a następnie swoje pytanie, a agent odpowie, korzystając z kontekstu schematu na żywo z połączonej bazy danych.

Aby uruchomić oparty na narzędziu przepływ pracy z bazą danych już w zakresie, kliknij prawym przyciskiem myszy węzeł bazy danych w drzewie Połączenia i wybierz polecenie Połącz sztuczną inteligencję.

Aby uzyskać wskazówki dla użytkowników końcowych, przykładowe polecenia i pomoc w rozwiązywaniu problemów, przejdź do czatu z uczestnikiem @pgsql.

Używanie akcji edytora na potrzeby pomocy ukierunkowanej na zapytania

Po otwarciu bazy danych SQL w edytorze zapytań kliknij prawym przyciskiem myszy, aby znaleźć podmenu Akcje zapytań AI . Zawiera następujące akcje:

Akcja Description
Wyjaśnienie zapytania Zwraca wyjaśnienie prostym językiem, opisujące działanie zapytania.
Ponowne zapisywanie zapytania Sugeruje alternatywną wersję zapytania przy zachowaniu zamierzonego wyniku.
Analizowanie wydajności zapytań Uruchamia EXPLAIN ANALYZE w podłączonej bazie danych, a następnie wysyła plan wykonania do AI do analizy.

Możesz również wybrać pozycję Zapytaj sztuczną inteligencję o tym zapytaniu na pasku narzędzi edytora, aby otworzyć konwersację na czacie uziemiona w bieżącej zawartości edytora.

Aby zresetować zapamiętane ustawienia uwzględniania zapytań dla analizy planu, uruchom z Palety poleceń polecenie Wyczyść preferencje uwzględniania zapytań na potrzeby analizy AI.

Używanie trybu agenta dla przepływów pracy opartych na narzędziach

Tryb agenta zapewnia asystentowi sztucznej inteligencji dostęp do narzędzi PostgreSQL, dzięki czemu może łączyć się, sprawdzać schemat, uruchamiać zapytania, otwierać skrypty i wykonywać zadania wieloetapowe w jednej konwersacji. Kliknij prawym przyciskiem myszy węzeł bazy danych w drzewie Połączenia i wybierz polecenie Połącz sztuczną inteligencję, aby uruchomić sesję trybu agenta.

W przypadku rodzin narzędzi, przykładowych przepływów pracy i rozwiązywania problemów, przejdź do trybu agenta.

Używanie serwera MCP na obsługiwanych hostach

Rozszerzenie rejestruje dostawcę serwera MCP Narzędzi PostgreSQL (identyfikator: pgsql-tools-mcp-server-provider), który uwidacznia ten sam obszar narzędzia PostgreSQL za pośrednictwem protokołu kontekstowego modelu. Hosty zgodne z programem MCP mogą odnajdywać i wywoływać te narzędzia bez korzystania z wbudowanych przepływów pracy czatu.

Informacje o obsługiwanych hostach, sposobie automatycznej rejestracji i rodzinach narzędzi udostępnianych za pośrednictwem MCP znajdują się w sekcji Serwer MCP.

Konfigurowanie trybu dostępu

Ustawienie pgsql.copilot.accessMode określa, ile dostępu do bazy danych otrzymuje asystent sztucznej inteligencji w trybie agenta i narzędziach MCP. Wartość domyślna to Odczyt/Zapis (rw).

Wartość ustawienia Etykieta interfejsu użytkownika Co może zrobić asystent sztucznej inteligencji
ro tylko do odczytu Operacje tylko do odczytu: SELECT, , SHOWEXPLAIN, inspekcja schematu
rw Odczyt/zapis Operacje odczytu oraz instrukcje modyfikujące dane i DDL z wyraźnym potwierdzeniem

Przesłonięcia poszczególnych połączeń

Można również ustawić tryb dostępu dla poszczególnych połączeń. W oknie dialogowym połączenia rozwiń sekcję Copilot (AI w Cursor) i ustaw tryb dostępu Copilot (tryb dostępu AI w Cursor) na jeden z następujących trybów:

Option Behavior
Użyj ustawienia globalnego Wraca do wartości globalnej pgsql.copilot.accessMode (wartość domyślna)
tylko do odczytu Wymusza dostęp tylko do odczytu dla tego połączenia niezależnie od ustawienia globalnego
Odczyt/zapis Wymusza dostęp do odczytu/zapisu dla tego połączenia niezależnie od ustawienia globalnego

Rozszerzenie określa efektywny tryb dostępu przy użyciu następującego łańcucha rezerwowego: wartość dla połączenia → ustawienie globalne pgsql.copilot.accessMode → wartość domyślna (rw).

Caution

Używaj trybu Tylko do odczytu w przypadku produkcyjnych baz danych, chyba że celowo chcesz, aby asystent AI mógł wprowadzać zmiany w schemacie lub danych.

Konfiguracja dodatkowych ustawień

Setting Co kontroluje Default
pgsql.copilot.enable Włącza lub wyłącza całą integrację sztucznej inteligencji w rozszerzeniu true
pgsql.copilot.accessMode Globalny tryb dostępu do sztucznej inteligencji (tylko do odczytu lub odczytu/zapisu) rw
pgsql.copilot.autoAttachQuery Czy tekst zapytania SQL jest uwzględniany podczas analizowania planów za pomocą sztucznej inteligencji: pytaj za każdym razem, zawsze dołączaj lub nigdy nie dołączaj ask
pgsql.copilot.modelOptions Zaawansowane dostrajanie modelu (maksymalne tokeny, temperatura, top_p) dla przepływów pracy AI rozszerzenia -

Identyfikatory ustawień zachowują prefiks pgsql.copilot.* w obu edytorach ze względu na zachowanie zgodności wstecznej, nawet tam, gdzie widoczne dla użytkownika etykiety mają oznaczenie „AI”.

Integracje sztucznej inteligencji specyficzne dla funkcji

Kilka funkcji obejmuje dedykowane punkty integracji sztucznej inteligencji:

Funkcja Możliwości sztucznej inteligencji
Wizualizator planu zapytania Analizowanie danych planu wykonania za pomocą funkcji Analizuj za pomocą Copilot (lub analizowania za pomocą sztucznej inteligencji w kursorze)
Pulpit nawigacyjny serwera Otwórz sesje czatu z przycisków Zapytaj funkcję Copilot (Zapytaj sztuczną inteligencję w kursorze) na panelach zapytań, oczekiwań, sesji i wykresów metryk
Wizualizator schematu Wizualizuj relacje schematu w przepływie pracy w trybie agenta

Treści powiązane

  • Last updated on