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 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
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.
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
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:
- Nawiąż połączenie, odwołując się do nazwy zapisanego profilu połączenia.
- GitHub Copilot używa narzędzia
mssql_list_serversdo weryfikacji istnienia profilu. - Narzędzie
mssql_connectnastępnie używa zapisanegoprofileIdi 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:
- Narzędzie GitHub Copilot używa
mssql_list_serversdo znalezienia dopasowania. - Następnie wywołuje
mssql_connectprzy użyciu pełnego profilu.
- Narzędzie GitHub Copilot używa
Jeśli zapisany profil jest zgodny tylko z serwerem:
- Narzędzie GitHub Copilot znajduje pasujący profil serwera.
- Próbuje nawiązać połączenie, wstawiając bazę danych żądaną przez użytkownika do tego profilu.
- 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?
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
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.
Treści powiązane
- Jak GitHub Copilot działa z rozszerzeniem MSSQL
- Panel wydajności zapytań (podgląd)
-
Szybki start: Czat z uczestnikiem
@mssql(tryb pytań) - Szybki start: Użyj trybu planu do projektowania bazy danych opartej na specyfikacji
- Szybki start: Korzystanie z poleceń z ukośnikiem w GitHub Copilot
- Szybki start: Użyj niestandardowych instrukcji, aby dostosować GitHub Copilot do konwencji T-SQL
- Szybki start: Generuj kod
- Szybki start: Projektuj schematy wizualnie za pomocą osadzonych scenariuszy GitHub Copilot
- Szybki start: Użyj inteligentnego kreatora zapytań
- Szybki start: Asystent optymalizatora zapytań
- Integracje mapowania obiektowo-relacyjnego z GitHub Copilot
- Ograniczenia i znane problemy