Sdílet prostřednictvím


Rychlý start: Použití režimu agenta GitHub Copilot

Režim gitHub Copilot Agent přináší kontextové prostředí chatu řízené akcemi do rozšíření MSSQL pro Visual Studio Code. S režimem agenta může GitHub Copilot jít nad rámec návrhu kódu – může bezpečně spouštět skutečné databázové úlohy pomocí výzev přirozeného jazyka nebo integrovaných nástrojů. Můžete vypsat všechna připojení, připojit se k určitému serveru nebo databázím a prozkoumat schémata bez opuštění editoru.

Tip

Nemusíte zmínit účastníka, jako je @mssql, abyste mohli používat nástroje SQL v režimu agenta. Jakmile je rozšíření MSSQL aktivní, jeho nástroje jsou automaticky dostupné v rozhraní režimu agenta. Další informace naleznete v tématu Nástroje režimu agenta.

Tyto akce využívají nástroje, které přispělo rozšíření MSSQL, a zobrazují se přímo v režimu agenta GitHub Copilotu. Další informace o fungování režimu agenta najdete v dokumentaci Visual Studio Code o režimu agenta.

Co je režim agenta?

Režim agenta umožňuje GitHub Copilotu přejít nad rámec návrhu kódu. Teď může provádět zabezpečené a potvrzené akce ve vašem vývojovém prostředí SQL, buď pomocí proměnných chatu jako #mssql_connect, nebo přirozených frází, jako jsou.

Connect to my Library database using my LocalDev profile

Snímek obrazovky rozhraní režimu GitHub Copilot Agent

Referenční informace k nástrojům režimu agenta MSSQL

Tato část obsahuje podrobné referenční informace o nástrojích specifických pro SQL, které jsou k dispozici v režimu agenta Copilot GitHubu. Rozšíření MSSQL přispívá k těmto nástrojům a umožňuje GitHub Copilotu spouštět akce prostřednictvím proměnných chatu nebo výzvy v přirozeném jazyce. Všechny nástroje před spuštěním vyžadují potvrzení uživatele.

Snímek obrazovky se seznamem nástrojů specifických pro SQL, které přispělo rozšíření MSSQL v režimu agenta Copilot

Tip

Můžete také použít proměnné chatu, jako je #mssql_connect, k přímému vyvolání těchto nástrojů nebo psát výzvy v přirozeném jazyce, například:

Connect to my development database

GitHub Copilot zpracovává výběr nástrojů automaticky.

Správa připojení

Název nástroje Description
connect Vytvoří připojení k databázi pomocí uloženého profilu připojení nebo zadaného páru serveru nebo databáze.
disconnect Ukončí aktuální aktivní relaci připojení.
change_database Změní databázi existující relace připojení.
get_connection_details Získá podrobnosti o konkrétním připojení MSSQL.
list_servers Zobrazí seznam všech uložených profilů připojení SQL Serveru ve vašem prostředí.
list_databases Zobrazí seznam všech dostupných databází pro připojený server MSSQL.

Examples

Následující fráze se dají použít k interakci s GitHub Copilotem.

- 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

Snímek obrazovky s příkladem použití nástroje agenta pro připojení k databázi v chatu GitHub Copilot

Jak funguje logika připojení

Režim kopírovacího agenta GitHubu podporuje flexibilní způsoby připojení k databázi SQL, a to buď odkazováním na uložené profily, nebo zadáním serveru a databáze přímo. Tady je postup, jak funguje logika připojení:

Když se připojíte přes uložený profil:

  1. Uživatel se může připojit odkazem na název uloženého profilu připojení.
  2. GitHub Copilot pomocí mssql_list_servers nástroje ověří, že profil existuje.
  3. Nástroj mssql_connect pak použije uložené profileId a jeho parametry k navázání připojení.

Při připojení přes specifikaci serveru nebo databáze:

  • Pokud uložený profil odpovídá zadanému serveru i databázi:

    1. GitHub Copilot používá mssql_list_servers k vyhledání shody.
    2. Potom zavolá mssql_connect pomocí úplného profilu.
  • Pokud uložený profil odpovídá pouze serveru:

    1. GitHub Copilot najde odpovídající profil serveru.
    2. Pokusí se připojit nahrazením uživatelem požadované databáze do daného profilu.
    3. Pokud připojení selže, zobrazí se chyba.
  • Pokud žádný profil neodpovídá zadanému serveru:

    • GitHub Copilot hlásí chybu.

Tento flexibilní odpovídající systém umožňuje GitHub Copilotu zpracovávat celou řadu scénářů připojení, což minimalizuje úsilí uživatelů při zajištění zabezpečených a ověřitelných akcí.

Zkoumání schématu

Název nástroje Description
show_schema Zobrazí základní diagram schématu připojené databáze včetně tabulek a relací.
list_schemas Zobrazí seznam všech schémat v databázi pro připojený server MSSQL.
list_tables Zobrazí seznam všech tabulek v databázi připojeného serveru MSSQL.
list_views Zobrazí seznam všech zobrazení v databázi připojeného serveru MSSQL.
list_functions Zobrazí seznam všech funkcí v databázi připojeného serveru MSSQL.

Examples

Následující fráze se dají použít k interakci s GitHub Copilotem.

- 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?

Snímek obrazovky s animací zobrazující nástroj vizualizéru schématu databáze v režimu agenta Copilot

Provedení dotazu

Název nástroje Description
run_query Spustí dotaz SQL na připojenou databázi.

Examples

Následující fráze se dají použít k interakci s GitHub Copilotem.

- 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

Snímek obrazovky s příkladem pomocí nástroje agenta pro připojení k databázi a načtení dat

Snímek obrazovky s jiným příkladem, který používá nástroj agenta pro připojení k databázi a načtení dat

Správa nástrojů v režimu agenta

GitHub Copilot může při zpracování požadavku vyvolat nástroje specifické pro MSSQL a další nástroje, které přispěly rozšířením. Tyto nástroje jsou viditelné v rozhraní režimu agenta v nabídce Nástroje, kde můžete povolit nebo zakázat konkrétní nástroje.

Při vyvolání nástroje, zejména pokud komunikuje s počítačem nebo databází, GitHub Copilot zobrazí výzvu k potvrzení, aby se zajistilo zabezpečené spuštění. Nástroj můžete povolit pouze pro aktuální relaci, pracovní prostor nebo ho trvale schválit.

Další informace o viditelnosti a schvalování nástrojů najdete v tématu Správa schválení nástrojů.

Pracovní postup potvrzení režimu agenta

Když GitHub Copilot vybere nástroj, zobrazí se výzva s potvrzovacími dialogy s podrobnostmi o požadované akci. Před spuštěním libovolných příkazů, které komunikují s vaším počítačem nebo databází, musíte žádost explicitně schválit:

  • Povolit v této relaci
  • Povolit v tomto pracovním prostoru
  • Vždy povolit

Tento potvrzovací krok pomáhá zajistit zabezpečené a úmyslné interakce s vaším vývojovým prostředím.

Note

Další informace o tom, jak funguje potvrzení ve všech nástrojích v režimu agenta, najdete v dokumentaci editoru Visual Studio Code ke schválení nástrojů.