Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Tryb agenta umożliwia asystentowi sztucznej inteligencji w edytorze używanie narzędzi PostgreSQL z rozszerzenia w ramach jednej konwersacji wieloetapowej. Zamiast po prostu odpowiadać na pytanie, asystent może łączyć się z bazą danych, analizować jej schemat, wykonywać zapytania, otwierać skrypty i pomagać przejść przez cały przepływ pracy od początku do końca.
Tryb agenta działa zarówno w Visual Studio Code (z GitHub Copilot), jak i w Cursor (z wbudowanym AI). Rozszerzenie uwidacznia tę samą powierzchnię narzędzia PostgreSQL w obu edytorach; tylko otwierany panel czatu jest inny.
Użyj trybu agenta, gdy chcesz, aby sztuczna inteligencja podejmiła akcje ustrukturyzowane, a nie tylko wyjaśnić lub uruchomić wersję roboczą języka SQL.
Wymagania wstępne
Przed rozpoczęciem upewnij się, że masz następujące elementy:
- Zainstalowane rozszerzenie PostgreSQL.
- Funkcje Copilot/AI włączone w tym rozszerzeniu (
pgsql.copilot.enabletotrue). - Co najmniej jedno połączenie bazy danych skonfigurowane w rozszerzeniu.
- Asystent sztucznej inteligencji dostępny w edytorze:
- Visual Studio Code: GitHub Copilot lub GitHub Copilot Chat zainstalowane i aktywne.
- Kursor: brak dodatkowej instalacji; wbudowana sztuczna inteligencja jest używana automatycznie.
Uruchamianie trybu agenta
- Połącz się z serwerem docelowym lub bazą danych w rozszerzeniu PostgreSQL.
- W drzewie Połączenia kliknij prawym przyciskiem myszy bazę danych, której chcesz użyć.
- Wybierz pozycję Połącz sztuczną inteligencję.
- Kontynuuj rozmowę w panelu czatu, który otworzy się z przepływem pracy, który chcesz ukończyć.
- W Visual Studio Code jest to panel usługi GitHub Copilot Chat w trybie agenta.
- W Cursorze jest to natywny panel AI Cursora; rozszerzenie udostępnia krótkie wprowadzenie dotyczące MCP, dzięki czemu asystent wie, jakie narzędzia PostgreSQL są dostępne.
Po rozpoczęciu sesji AI może w tle łączyć narzędzia PostgreSQL podczas realizacji Twojego polecenia.
Wybieranie odpowiedniego trybu dostępu
Ustawienie pgsql.copilot.accessMode określa, ile otrzymuje tryb agenta dostępu do bazy danych. Identyfikator ustawienia zachowuje prefiks pgsql.copilot.* dla zachowania zgodności; etykieta widoczna dla użytkownika to tryb dostępu do Copilota w programie Visual Studio Code oraz tryb dostępu do SI w Cursor.
| Tryb | Co może zrobić sztuczna inteligencja | Zalecane użycie |
|---|---|---|
ro |
Operacje tylko do odczytu, takie jak SELECT, SHOW, EXPLAIN, inspekcja schematu i analiza |
Systemy produkcyjne lub środowiska udostępnione, w których chcesz badać bez zmian |
rw |
Operacje odczytu oraz instrukcje modyfikujące dane i DDL, z wyraźnym potwierdzeniem przed wykonaniem | Lokalne programowanie, jednorazowe piaskownice i kontrolowane środowiska testowe |
Caution
Używaj trybu ro w przypadku produkcyjnych baz danych, chyba że celowo chcesz, aby zmiany schematu lub danych były dostępne w trybie Agent.
Omówienie rodzin narzędzi
Tryb agenta może używać wielu rodzin narzędzi w zależności od przepływu pracy.
| Rodzina narzędzi | Do czego służy | Gdy go używasz |
|---|---|---|
| Narzędzia połączenia | Wyświetl listę profilów, połącz, rozłącz, wyświetl listę baz danych | Uruchamianie lub przełączanie kontekstu |
| Narzędzia kontekstowe schematu | Pobieranie definicji obiektów lub wizualizowanie schematu | Omówienie tabel, widoków, funkcji, indeksów i relacji |
| Narzędzia zapytań | Uruchamianie zapytań odczytu, inspekcja planów zapytań, otwieranie skryptów | Badanie danych, weryfikowanie pomysłów lub przeglądanie wygenerowanego kodu SQL |
| Narzędzia modyfikacji | Wykonaj DDL lub DML po potwierdzeniu | Zastosuj kontrolowane zmiany schematu lub danych w trybie rw |
| Narzędzia do importowania danych | Opisz pliki CSV i załaduj je zbiorczo | Planowanie i wykonywanie przepływów pracy importowania woluminów CSV |
Wskazówka
W Cursor te same narzędzia są również dostępne poprzez rejestrację serwera MCP. Natywny czat kursora może wywoływać je bezpośrednio bez użycia punktu wejścia Connect AI . Aby uzyskać szczegółowe informacje, zobacz Serwer MCP .
Używanie trybu agenta dla typowych przepływów pracy
W poniższych przykładach pokazano, jak używać trybu agenta dla zadań, które mogą obejmować eksplorowanie nowej bazy danych po udoskonalanie zapytań.
Eksplorowanie nieznanej bazy danych
Poproś sztuczną inteligencję o nawiązanie połączenia z bazą danych, wyświetlenie listy obiektów kluczy i podsumowanie obszarów schematu, które mają znaczenie dla zadania.
Example:
Połącz się z moją deweloperską bazą danych, wyświetl listę tabel w schemacie public i powiedz mi, które z nich wydają się związane z klientami i zamówieniami.
Badanie wydajności zapytań
Poproś sztuczną inteligencję o połączenie kontekstu schematu z wykonywaniem zapytań lub inspekcją planu.
Example:
Połącz się z bazą testową, wykonaj to zapytanie w trybie tylko do odczytu i wyjaśnij, która część planu wykonania odpowiada za koszt.
Ładowanie lub zmienianie kształtu danych
Użyj trybu agenta, gdy przepływ pracy zawiera skrypty lub operacje oparte na woluminach CSV.
Example:
Przejrzyj ten plik CSV, poinformuj mnie, jaki schemat implikuje, i przygotuj bezpieczny plan importu dla
sales.recordstabeli.
Przechodzenie z wersji roboczej do ręcznego przeglądu
Jeśli chcesz, aby przed wykonaniem wymagany był punkt kontrolny zatwierdzany przez człowieka, poproś AI o otwarcie wygenerowanego kodu SQL w edytorze zapytań zamiast uruchamiać go od razu.
Dowiedz się, kiedy używać trybu agenta zamiast @pgsql
Użyj @pgsql uczestnika konwersacji, jeśli chcesz uzyskać odpowiedź uwzględniającą schemat lub szkic zapytania. Uczestnik @pgsql jest dostępny tylko w Visual Studio Code.
Użyj trybu agenta (dostępnego zarówno w Visual Studio Code, jak i kursorze), gdy chcesz, aby sztuczna inteligencja:
- nawiąż połączenie z odpowiednią dla Ciebie bazą danych,
- łączenie wielu narzędzi w jednej konwersacji,
- sprawdzanie wyników przed następnym krokiem lub
- przygotuj skrypt lub kontrolowany proces wprowadzania zmian.
Note
W Cursor tryb Agenta jest główną opcją, ponieważ uczestnik konwersacji @pgsql nie jest tam dostępny. Ten sam interfejs narzędzia jest również dostępny z poziomu natywnego czatu Cursora za pośrednictwem serwera MCP.
Rozwiązywanie problemów z trybem agenta
Jeśli tryb agenta nie działa zgodnie z oczekiwaniami, najpierw sprawdź tryb dostępu i dostępność narzędzia.
Sztuczna inteligencja nie może modyfikować bazy danych
Sprawdź pgsql.copilot.accessMode i upewnij się, że aktywne połączenie nie jest rozpoznawane jako ro.
Oczekiwane narzędzie jest niedostępne
Upewnij się, że integracja z Copilotem jest włączona oraz że rozpoczęto pracę z poziomu bazy danych z prawidłowym kontekstem połączenia z PostgreSQL.
Żądanie połączenia kończy się niepowodzeniem
Upewnij się, że profil połączenia nadal istnieje, poświadczenia są dostępne, a rozszerzenie może nawiązać połączenie z tą samą bazą danych poza trybem agenta.
Chcę prostszego przepływu pracy opartego przede wszystkim na czacie
W Visual Studio Code użyj uczestnika czatu @pgsql, gdy chcesz uzyskać wyjaśnienie, wersję roboczą zapytań lub pytania dotyczące schematu bez automatyzacji opartej na narzędziach. W Cursor zadawaj te same pytania co w natywnym czacie. Narzędzia MCP w rozszerzeniu są nadal wykrywalne, ale czat działa w bardziej konwersacyjny sposób bez osobnej pozycji trybu Agenta.