Szybki start: korzystanie z trybu agenta GitHub Copilot

Tryb agenta umożliwia GitHub Copilot orkiestrowanie narzędzi dodanych przez rozszerzenie MSSQL dla Visual Studio Code. Gdy rozszerzenie jest zainstalowane i aktywne, GitHub Copilot może wyświetlać listę połączeń Microsoft SQL Server, łączyć się z serwerem i bazą danych, pobierać metadane schematu, wykonywać zapytania oraz badać wydajność Query Store, wszystko to z promptów w języku naturalnym. Wymagania dotyczące zatwierdzenia zależą od narzędzia.

Wszystkie akcje używają tego samego kontekstu połączenia i poświadczeń co rozszerzenie MSSQL. Tryb agenta nie wprowadza innych zmian uwierzytelniania ani uprawnień.

Tip

Użyj trybu agenta dla wieloetapowych przepływów pracy, eksploracji na dużą skalę i delegowanych zmian. Użyj trybu pytania, jeśli potrzebujesz pojedynczej odpowiedzi lub jednorazowego zapytania. Użyj trybu planu , jeśli musisz wnioskować o projekcie przed napisaniem języka definicji danych Transact-SQL (T-SQL) (DDL).

Podjąć klucza

  • Tryb agenta automatycznie pobiera narzędzia rozszerzenia MSSQL. Nie trzeba wspominać o @mssql.
  • Przeglądaj i zatwierdzaj wywołania narzędzi, gdy zostaniesz o to poproszony. Odczyty diagnostyczne Query Store nie wymagają potwierdzenia; wymuszenie lub cofnięcie wymuszenia planu wymaga przeglądu i potwierdzenia.
  • Tryb agenta jest świadomy schematu dzięki swoim narzędziom: każde wywołanie narzędzia zwraca rzeczywiste dane z podłączonej bazy danych.
  • Aby zapoznać się z kontekstem architektonicznym we wszystkich interfejsach, zobacz Jak działa GitHub Copilot z rozszerzeniem MSSQL.

Kiedy używać trybu agenta

Tryb agenta jest najlepszy dla:

  • Wieloetapowe przepływy pracy. Połącz się z LocalDev, przełącz się na bazę danych AdventureWorks, a następnie pokaż mi wszystkie tabele mające klucz obcy do tabeli Customer.
  • Eksploracja na dużą skalę. Znajdź wszystkie procedury składowane, które odwołują się do tabeli SalesOrderHeader, i podsumuj, co robi każda z nich.
  • Badania wydajności. Użyj Query Store, aby znaleźć zapytania o najwyższym użyciu CPU w ciągu ostatnich 24 godzin, a następnie przeanalizuj historię, czasy oczekiwania i plany najwyższego zapytania.
  • Delegowane zmiany. Dodaj kolumny audytowe do każdej tabeli w schemacie Sales i ponownie wygeneruj powiązane procedury składowane.

Użyj trybu pytań, gdy pojedyncze pytanie lub jednorazowe zapytanie wystarczy. Użyj poleceń z ukośnikiem, gdy już wiesz, jakie działanie chcesz wykonać. Użyj trybu planu , jeśli chcesz napisać plan przed wszelkimi zmianami.

Aby uzyskać szczegółowe informacje na temat sposobu wybierania i wykonywania narzędzi w trybie agenta, zobacz dokumentację Visual Studio Code w trybie agenta.

Co to jest tryb agenta?

Tryb agenta pozwala GitHub Copilot wykonywać działania związane z SQL za pomocą rozszerzenia MSSQL. Narzędzia wymagające potwierdzenia prezentują żądaną akcję do przeglądu przed wykonaniem.

Te akcje można wywołać przy użyciu zmiennych czatu, takich jak #mssql_connect, lub wysyłając równoważne żądania języka naturalnego, na przykład:

Connect to my Library database using my LocalDev profile

Zrzut ekranu interfejsu czatu w trybie agenta GitHub Copilot.

Dokumentacja narzędzia MSSQL Agent Mode

Ta sekcja zawiera szczegółowe informacje dotyczące narzędzi specyficznych dla języka SQL dostępnych w trybie agenta Copilot usługi GitHub. Rozszerzenie MSSQL współtworzy te narzędzia, umożliwiając usłudze GitHub Copilot wykonywanie akcji za pomocą zmiennych czatu lub monitów języka naturalnego. Narzędzia diagnostyczne Query Store odczytują przechwycone dane wydajności bez żądania potwierdzenia. Przeglądaj i zatwierdzaj inne działania, gdy zostaniesz o to poproszony.

Zrzut ekranu listy narzędzi specyficznych dla SQL dostarczonych przez rozszerzenie MSSQL w trybie Copilot agent.

Tip

Możesz również użyć zmiennych czatu, takich jak #mssql_connect, aby wywołać te narzędzia bezpośrednio, lub pisać monity w języku naturalnym, takie jak:

Connect to my development database

Narzędzie GitHub Copilot automatycznie obsługuje wybór narzędzi.

Zarządzanie połączeniami

Nazwa narzędzia Description
connect Nawiązuje połączenie z bazą danych przy użyciu zapisanego profilu połączenia lub określonego serwera i bazy danych.
disconnect Kończy bieżącą aktywną sesję połączenia.
change_database Zmienia bazę danych dla istniejącej sesji połączenia.
get_connection_details Pobiera szczegóły połączenia dla określonego połączenia MSSQL.
list_servers Wyświetla listę wszystkich zapisanych profilów połączeń programu SQL Server w danym środowisku.
list_databases Wyświetla listę wszystkich dostępnych baz danych dla połączonego serwera MSSQL.

Examples

Użyj poniższych fraz, aby wchodzić w interakcje z rozwiązaniem GitHub Copilot.

- Connect to my LocalDev environment
- Disconnect from my current database
- List my available connection profiles
- List all databases in the localhost server
- Set the active connection to localhost
- Set AdventureWorks as the active database
- Get the connection string for AdventureWorks on localhost

Zrzut ekranu przykładu używania narzędzia agenta do połączenia z bazą danych w czacie GitHub Copilot.

Jak działa logika połączenia

Tryb agenta Copilot usługi GitHub obsługuje elastyczne sposoby nawiązywania połączenia z bazą danych SQL, odwołując się do zapisanych profilów lub przez bezpośrednie określenie serwera i bazy danych. Oto jak działa logika połączenia.

Po nawiązaniu połączenia z zapisanym profilem:

  1. Nawiąż połączenie, odwołując się do nazwy zapisanego profilu połączenia.
  2. GitHub Copilot używa narzędzia mssql_list_servers do weryfikacji istnienia profilu.
  3. Narzędzie mssql_connect następnie używa zapisanego profileId i jego parametrów do nawiązania połączenia.

Podczas nawiązywania połączenia przez określenie serwera i bazy danych:

  • Jeśli zapisany profil jest zgodny zarówno z określonym serwerem, jak i bazą danych:

    1. Narzędzie GitHub Copilot używa mssql_list_servers do znalezienia dopasowania.
    2. Następnie wywołuje mssql_connect przy użyciu pełnego profilu.
  • Jeśli zapisany profil jest zgodny tylko z serwerem:

    1. Narzędzie GitHub Copilot znajduje pasujący profil serwera.
    2. Próbuje nawiązać połączenie, wstawiając bazę danych żądaną przez użytkownika do tego profilu.
    3. Jeśli połączenie zakończy się niepowodzeniem, zostanie wyświetlony błąd.
  • Jeśli żaden profil nie pasuje do określonego serwera:

    • GitHub Copilot zgłasza błąd.

Ten elastyczny system dopasowania pozwala GitHub Copilot obsługiwać szereg scenariuszy połączeń. Minimalizuje nakład pracy użytkownika przy jednoczesnym zapewnieniu bezpiecznych, możliwych do potwierdzenia akcji.

Eksploracja schematu

Nazwa narzędzia Description
show_schema Przedstawia ogólny diagram schematu połączonej bazy danych, w tym tabele i relacje.
list_schemas Wyświetla listę wszystkich schematów w bazie danych dla połączonego serwera MSSQL.
list_tables Wyświetla listę wszystkich tabel w bazie danych dla połączonego serwera MSSQL.
list_views Wyświetla listę wszystkich widoków w bazie danych dla połączonego serwera MSSQL.
list_functions Wyświetla listę wszystkich funkcji w bazie danych dla połączonego serwera MSSQL.

Examples

Użyj poniższych fraz, aby wchodzić w interakcje z rozwiązaniem GitHub Copilot.

- Show me the schema for this database
- Show me all tables in the current database
- List all views from this MSSQL database
- Give me a list of all the functions available in this schema
- What schemas are available in this database?

Zrzut ekranu animacji pokazującej narzędzie wizualizatora schematu bazy danych w trybie Copilot agent.

Wykonywanie zapytania

Nazwa narzędzia Description
run_query Uruchamia zapytanie SQL względem połączonej bazy danych.

Examples

Użyj poniższych fraz, aby wchodzić w interakcje z rozwiązaniem GitHub Copilot.

- Give me the top five posts published this week
- Execute the current file to find how many comments each post has
- Get all categories along with the number of posts in each

Zrzut ekranu przykładu używania narzędzia agenta do łączenia się z bazą danych i pobierania danych.

Zrzut ekranu innego przykładu używania narzędzia agenta do łączenia się z bazą danych i pobierania danych.

Narzędzia wydajnościowe Query Store (podgląd)

Użyj tych narzędzi, aby zbadać wydajność przechwyconych zapytań zamiast ręcznego tworzenia diagnostycznych zapytań SQL. Wymagają bazy danych obsługującej Query Store, danych przechwyconych na żądany okres oraz uprawnień do odczytu tych danych. Możesz zidentyfikować cel poprzez istniejące połączenie lub zapisany profil połączenia i nazwę bazy danych.

Nazwa narzędzia Description
mssql_query_store_status Odczytuje stan Query Store, powody trybu tylko do odczytu oraz dostępną historię.
mssql_query_store_top_queries Znajduje zapytania uszeregowane według metryki zasobu lub liczby wykonań w oknie czasowym.
mssql_query_store_query_details Odczytuje tekst jednego zapytania, statystyki w czasie wykonywania oraz plany wraz z ich statystykami.
mssql_query_store_query_history Odczytuje wydajność zapytania w czasie, w tym statystyki dotyczące planów uruchomionych w każdym interwale.
mssql_query_store_wait_stats Odczytuje czas oczekiwania według kategorii dla bazy danych, zapytania lub planu. Wymaga obsługi zbierania statystyk oczekiwania przez Query Store.
mssql_query_store_plan_summary Podsumowuje informacje o instrukcjach z przechowywanego planu, ostrzeżenia, zalecenia dotyczące brakujących indeksów oraz kosztowne operatory.
mssql_query_store_analyze_query Łączy szczegóły zapytań, plany, historię wykonania, czasy oczekiwania oraz podsumowania głównych planów w jednym wywołaniu diagnostycznym.
mssql_open_performance_dashboard Otwiera panel wydajności zapytań dla bazy danych lub dla określonego zapytania i karty.
mssql_query_store_plan_forcing Wymusza lub cofa wymuszenie planu zapytania po przejrzeniu i potwierdzeniu wygenerowanego SQL.
mssql_query_store_verify_forced_plan Sprawdza, czy egzekucje po wymuszeniu planu korzystały z tego planu.

Aby rozpocząć dochodzenie, zidentyfikuj bazę danych i okres w swoim promptie:

Use Query Store to find the queries with the highest total CPU time in AdventureWorksLT in the past 24 hours. Analyze the top query, explain its execution history and waits, and open it in the performance dashboard. Don't make changes.

Zamień przykładową nazwę bazy danych na swoją bazę danych. Możesz także jawnie odwołać się do narzędzia, na przykład #mssql_query_store_analyze_query, gdy już znasz identyfikator zapytania i docelową bazę danych.

Akcja Czat na pulpicie otwiera tryb agenta i wysyła monit, który wyraźnie odwołuje się #mssql_query_store_analyze_query i podaje serwer, bazę danych, zapisany identyfikator profilu, identyfikator zapytania oraz zakres czasowy wybranego zapytania. Aby uzyskać instrukcję krok po kroku i kolejne pytania, zobacz Zbadaj wydajność Query Store.

Important

Odczyty diagnostyczne nie modyfikują bazy danych ani nie wymagają potwierdzenia. Wymuszanie lub wymuszanie planu to osobna zmiana: narzędzie prezentuje dokładny SQL oraz wszelkie ostrzeżenia do przeglądu i potwierdzenia. Weryfikacja wymuszonego planu jest operacją tylko do odczytu. Zdiagnozuj problem i przejrzyj dowody przed złożeniem wniosku o zmianę planu.

Ustawienia retencji i przechwytywania Query Store określają dostępne dane. Jeśli Query Store jest wyłączony lub żądany okres nie zawiera przechwyconych danych, narzędzia nie mogą zapewnić diagnozy wydajności dla tego okresu. Szczegóły instalacji znajdziesz w sekcji Wymagania wstępne panelu wydajności zapytań.

Jak narzędzia są zarządzane w trybie agenta

Narzędzie GitHub Copilot może używać narzędzi specyficznych dla programu MSSQL i innych narzędzi współtworzynych przez rozszerzenie podczas przetwarzania żądania. Te narzędzia można wyświetlić w interfejsie Tryb agenta w menu Narzędzia , gdzie można również włączyć lub wyłączyć określone narzędzia.

Gdy narzędzie wymaga potwierdzenia, GitHub Copilot prosi o sprawdzenie żądanej akcji przed jej uruchomieniem. Możesz zezwolić narzędziu tylko na bieżącą sesję, obszar roboczy lub trwale. Odczyty diagnostyczne Query Store nie wymagają potwierdzenia; wymuszanie i cofanie wymuszania planu wymagają.

Aby uzyskać więcej informacji na temat widoczności i zatwierdzeń narzędzi, zobacz Zarządzanie zatwierdzeniami narzędzi.

Procedura potwierdzania trybu agenta

Dla narzędzi wymagających potwierdzenia GitHub Copilot pokazuje szczegóły dotyczące żądanej akcji. Przejrzyj wniosek przed wyborem opcji zatwierdzenia:

  • Zezwól w tej sesji
  • Zezwól w tej przestrzeni roboczej
  • Zawsze zezwalaj

Ten krok potwierdzenia pomaga zapewnić bezpieczne, zamierzone interakcje ze środowiskiem projektowym.

Note

Aby uzyskać więcej informacji na temat sposobu działania potwierdzenia we wszystkich narzędziach w trybie agenta, zobacz dokumentację programu Visual Studio Code dotyczącą zatwierdzeń narzędzi.

Katalog monitów trybu agenta

Użyj tych monitów języka naturalnego, aby wywołać narzędzia rozszerzenia MSSQL za pośrednictwem trybu agenta. Dla każdej kategorii podano odsyłacze do równoważnej komendy z ukośnikiem lub monitu trybu pytań.

Zarządzanie połączeniami

Connect to my LocalDev profile and set AdventureWorks as the active database.
List all my saved connection profiles and tell me which one I'm currently connected to.
Disconnect from my current database.

Równoważne polecenia z ukośnikiem: /connect, /listServers, /changeDatabase, /disconnect.

Eksploracja schematu

Show me every table in the SalesLT schema, grouped by whether they're
referenced by a foreign key from another table.
Find all stored procedures that reference SalesLT.SalesOrderHeader and
summarize what each one does in one sentence.
Which tables in the current database have no primary key?

Monity dotyczące odpowiedników: zobacz Czat z @mssql uczestnikiem.

Wykonywanie zapytania

Run a query to count the number of active customers in SalesLT.Customer,
then show me the top 10 by order total.
Show me the execution plan for this query: SELECT ... FROM ...
Execute the last query I ran against my Dev database instead.

Przepływy pracy wieloetapowe

Connect to LocalDev, switch to AdventureWorks, list all tables with a
foreign key to SalesLT.Customer, and save the list to a file called
customer-dependents.md.
Find every stored procedure that uses dynamic SQL and open each one
in a new editor tab so I can review them.

Delegowane zmiany schematu

Note

Zmiany schematu warto najpierw uruchomić w trybie planowania. Zaplanuj zmiany, przejrzyj je, a następnie przekaż plan trybowi agenta do wykonania.

Add createdAt and updatedAt audit columns to every table in the Sales
schema that doesn't already have them. Use DATETIME2(7) with a default
of GETUTCDATE().
Regenerate every stored procedure that inserts into SalesLT.Customer
to include the new email column.