Share via


Quickstart: GitHub Copilot-agentmodus gebruiken

GitHub Copilot Agent Mode biedt een contextuele, actiegestuurde chatervaring in de MSSQL-extensie voor Visual Studio Code. Met de agentmodus kan GitHub Copilot verder gaan dan het voorstellen van code. Hiermee kunnen echte databasetaken veilig worden uitgevoerd met behulp van prompts in natuurlijke taal of ingebouwde hulpprogramma's. U kunt al uw verbindingen weergeven, verbinding maken met specifieke server/databases en schema's verkennen zonder de editor te verlaten.

Tip

U hoeft een deelnemer zoals @mssql niet te vermelden om SQL-hulpprogramma's in de agentmodus te gebruiken. Zodra de MSSQL-extensie actief is, zijn de hulpprogramma's automatisch beschikbaar in de interface agentmodus. Zie Hulpprogramma's voor agentmodus voor meer informatie.

Deze acties worden mogelijk gemaakt door hulpprogramma's die zijn bijgedragen door de MSSQL-extensie en worden rechtstreeks in de agentmodus van GitHub Copilot weergegeven. Zie de documentatie over Agentmodus in Visual Studio Code voor meer informatie over hoe de Agentmodus werkt.

Wat is agentmodus?

Met de agentmodus kan GitHub Copilot verder gaan dan het voorstellen van code. Het kan nu veilige, bevestigde acties uitvoeren in uw SQL-ontwikkelomgeving, met behulp van chatvariabelen zoals #mssql_connect, of natuurlijke woordgroepen, zoals:

Connect to my Library database using my LocalDev profile

Schermopname van de chatinterface van de GitHub Copilot-agentmodus.

Naslaginformatie voor MSSQL-Agentmodus

Deze sectie bevat een gedetailleerde referentie voor de SQL-specifieke hulpprogramma's die beschikbaar zijn in de GitHub Copilot-agentmodus. De MSSQL-extensie draagt bij aan deze hulpprogramma's, waardoor GitHub Copilot acties kan uitvoeren via chatvariabelen of prompts in natuurlijke taal. Voor alle hulpprogramma's is bevestiging van de gebruiker vereist voordat deze wordt uitgevoerd.

Schermopname van een lijst met SQL-specifieke hulpprogramma's die zijn bijgedragen door de MSSQL-extensie in de Copilot-agentmodus.

Tip

U kunt ook chatvariabelen #mssql_connect gebruiken om deze hulpprogramma's rechtstreeks aan te roepen of schrijfprompts in natuurlijke taal, zoals:

Connect to my development database

GitHub Copilot verwerkt de selectie van hulpprogramma's automatisch.

Verbindingsbeheer

Naam van hulpprogramma Description
connect Hiermee wordt een databaseverbinding tot stand gebracht met behulp van een opgeslagen verbindingsprofiel of een opgegeven server-/databasepaar.
disconnect Hiermee wordt de huidige actieve verbindingssessie beƫindigd.
change_database Hiermee wijzigt u de database voor een bestaande verbindingssessie.
get_connection_details Hiermee haalt u verbindingsgegevens op voor een specifieke MSSQL-verbinding.
list_servers Een lijst met alle opgeslagen SQL Server-verbindingsprofielen in uw omgeving.
list_databases Een lijst met alle beschikbare databases voor een verbonden MSSQL-server.

Examples

De volgende zinnen kunnen worden gebruikt om te communiceren met 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

Schermopname van een voorbeeld van het gebruik van een agenthulpprogramma om verbinding te maken met een database in de GitHub Copilot-chat.

Hoe verbindingslogica werkt

GitHub Copilot Agent Mode ondersteunt flexibele manieren om verbinding te maken met uw SQL-database door te verwijzen naar opgeslagen profielen of door rechtstreeks een server en database op te geven. De verbindingslogica werkt als volgt:

Wanneer u verbinding maakt via een opgeslagen profiel:

  1. Een gebruiker kan verbinding maken door te verwijzen naar de naam van een opgeslagen verbindingsprofiel.
  2. GitHub Copilot gebruikt het mssql_list_servers hulpprogramma om te controleren of het profiel bestaat.
  3. Het mssql_connect hulpprogramma gebruikt vervolgens de opgeslagen profileId en de bijbehorende parameters om de verbinding tot stand te brengen.

Wanneer u verbinding maakt via server-/databasespecificatie:

  • Als een opgeslagen profiel overeenkomt met zowel de opgegeven server als de database:

    1. GitHub Copilot gebruikt mssql_list_servers om de overeenkomst te vinden.
    2. Vervolgens roept het mssql_connect aan met behulp van het volledige profiel.
  • Als een opgeslagen profiel alleen overeenkomt met de server:

    1. GitHub Copilot zoekt het overeenkomende serverprofiel.
    2. Er wordt geprobeerd verbinding te maken door de door de gebruiker aangevraagde database in dat profiel te vervangen.
    3. Als de verbinding mislukt, wordt een fout weergegeven.
  • Als er geen profiel overeenkomt met de opgegeven server:

    • GitHub Copilot meldt een fout.

Met dit flexibele overeenkomende systeem kan GitHub Copilot verschillende verbindingsscenario's afhandelen, waardoor de gebruikersinspanning wordt geminimaliseerd terwijl veilige, bevestigbare acties worden gegarandeerd.

Schemaverkenning

Naam van hulpprogramma Description
show_schema Geeft een diagram op hoog niveau weer van uw verbonden databaseschema, inclusief tabellen en relaties.
list_schemas Een lijst met alle schema's in een database voor een verbonden MSSQL-server.
list_tables Geeft een lijst weer van alle tabellen in een database voor een verbonden MSSQL-server.
list_views Een lijst met alle weergaven in een database voor een verbonden MSSQL-server.
list_functions Een lijst met alle functies in een database voor een verbonden MSSQL-server.

Examples

De volgende zinnen kunnen worden gebruikt om te communiceren met 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?

Schermopname van animatie met het hulpprogramma databaseschema visualiseren in de Copilot-agentmodus.

Query uitvoeren

Naam van hulpprogramma Description
run_query Voert een SQL-query uit op de verbonden database.

Examples

De volgende zinnen kunnen worden gebruikt om te communiceren met 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

Schermopname van een voorbeeld van het gebruik van een agenthulpprogramma om verbinding te maken met een database en gegevens op te halen.

Schermopname van een ander voorbeeld met behulp van een agenthulpprogramma om verbinding te maken met een database en gegevens op te halen.

Hoe hulpprogramma's worden beheerd in de agentmodus

GitHub Copilot kan MSSQL-specifieke hulpprogramma's en andere hulpprogramma's met extensie-bijdragen aanroepen tijdens het verwerken van uw aanvraag. Deze hulpprogramma's zijn zichtbaar in de interface van de Agentmodus onder het menu Hulpprogramma's, waar u specifieke hulpprogramma's kunt in- of uitschakelen.

Wanneer een hulpprogramma wordt aangeroepen, met name als er interactie is met uw machine of database, vraagt GitHub Copilot om bevestiging om een veilige uitvoering te garanderen. U kunt het hulpprogramma alleen toestaan voor de huidige sessie, de werkruimte of het permanent goedkeuren.

Ga naar Goedkeuringen van hulpprogramma's beheren voor meer informatie over zichtbaarheid en goedkeuringen van hulpprogramma's.

Bevestigingswerkstroom voor agentmodus

Wanneer GitHub Copilot een hulpprogramma selecteert, wordt er een bevestigingsvenster weergegeven met details over de aangevraagde actie. U moet de aanvraag expliciet goedkeuren voordat deze opdrachten kan uitvoeren die interactie hebben met uw computer of database:

  • Toestaan in deze sessie
  • Toestaan in deze werkruimte
  • Altijd toestaan

Deze bevestigingsstap zorgt voor veilige, opzettelijke interacties met uw ontwikkelomgeving.

Note

Zie de Visual Studio Code-documentatie over goedkeuringen van hulpprogramma's voor meer informatie over hoe bevestiging werkt voor alle hulpprogramma's in de agentmodus.