Udostępnij przez

Szybki start: korzystanie z trybu agenta Copilot w usłudze GitHub

Tryb agenta Copilot w usłudze GitHub udostępnia kontekstowe, oparte na akcjach środowisko czatu w rozszerzeniu MSSQL dla programu Visual Studio Code. Dzięki trybowi agenta narzędzie GitHub Copilot może wykraczać poza sugerowanie kodu — może bezpiecznie wykonywać prawdziwe zadania bazy danych przy użyciu monitów języka naturalnego lub wbudowanych narzędzi. Możesz wyświetlić listę wszystkich połączeń, połączyć się z określonymi serwerami/bazami danych i eksplorować schematy bez opuszczania edytora.

Tip

Nie musisz wspominać o uczestniku, takim jak @mssql, aby używać narzędzi SQL w trybie agenta. Gdy rozszerzenie MSSQL jest aktywne, jego narzędzia są automatycznie dostępne w interfejsie trybu agenta. Aby uzyskać więcej informacji, zobacz Narzędzia trybu agenta.

Te akcje są obsługiwane przez narzędzia udostępniane przez rozszerzenie MSSQL i udostępniane bezpośrednio w trybie agenta Copilot usługi GitHub. Aby uzyskać więcej informacji na temat działania trybu agenta, zobacz dokumentację programu Visual Studio Code dotyczącą trybu agenta.

Co to jest tryb agenta?

Tryb Agenta pozwala GitHub Copilot na robienie więcej niż tylko sugerowanie kodu. Teraz może wykonywać bezpieczne, potwierdzone akcje wewnątrz środowiska deweloperskiego SQL przy użyciu zmiennych czatu, takich jak , lub naturalnych fraz, takich jak #mssql_connect:

Connect to my Library database using my LocalDev profile

Zrzut ekranu przedstawiający interfejs czatu trybu agenta Copilot w usłudze GitHub.

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. Wszystkie narzędzia wymagają potwierdzenia użytkownika przed wykonaniem.

Zrzut ekranu przedstawiający listę narzędzi specyficznych dla języka SQL współtworzynych przez rozszerzenie MSSQL w trybie agenta Copilot.

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 Ustanawia połączenie z bazą danych przy użyciu zapisanego profilu połączenia lub określonej pary serwera/bazy danych.
disconnect Przerywa 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

Poniższe frazy mogą służyć do interakcji 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 przedstawiający przykład użycia narzędzia agenta w celu nawiązania połączenia z bazą danych w czacie Copilot w usłudze GitHub.

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 za pośrednictwem zapisanego profilu:

  1. Użytkownik może nawiązać 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 za pośrednictwem specyfikacji serwera/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 dopasowywania umożliwia usłudze GitHub Copilot obsługę szeregu scenariuszy połączeń, minimalizując nakład pracy użytkownika przy jednoczesnym zapewnieniu bezpiecznych, potwierdzonych 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

Poniższe frazy mogą służyć do interakcji 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 przedstawiający animację przedstawiającą narzędzie wizualizatora schematu bazy danych w trybie agenta Copilot.

Wykonywanie zapytania

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

Examples

Poniższe frazy mogą służyć do interakcji 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 przedstawiający przykład użycia narzędzia agenta do nawiązywania połączenia z bazą danych i pobierania danych.

Zrzut ekranu przedstawiający inny przykład użycia narzędzia agenta do nawiązywania połączenia z bazą danych i pobierania danych.

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

Narzędzie GitHub Copilot może wywoływać narzędzia specyficzne dla programu MSSQL i inne narzędzia współtworzyne przez rozszerzenie podczas przetwarzania żądania. Te narzędzia są widoczne w interfejsie Tryb agenta w menu Narzędzia, w którym można włączyć lub wyłączyć określone narzędzia.

Po wywołaniu narzędzia — zwłaszcza jeśli wchodzi w interakcję z maszyną lub bazą danych — narzędzie GitHub Copilot monituje o potwierdzenie w celu zapewnienia bezpiecznego wykonania. Możesz zezwolić narzędziu tylko na bieżącą sesję, obszar roboczy lub trwale go zatwierdzić.

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

Procedura potwierdzania trybu agenta

Po wybraniu narzędzia w usłudze GitHub Copilot zostanie wyświetlone okno dialogowe potwierdzenia zawierające szczegółowe informacje o żądanej akcji. Należy jawnie zatwierdzić żądanie przed wykonaniem dowolnych poleceń, które wchodzą w interakcję z maszyną lub bazą danych:

  • Zezwól w tej sesji
  • Zezwalaj na tym obszarze roboczym
  • 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.

Treści powiązane

  • Last updated on