Freigeben über

Schnellstart: Verwenden des GitHub Copilot-Agent-Modus

Der GitHub Copilot Agent Mode bietet eine kontextbezogene, aktionsgesteuerte Chaterfahrung in die MSSQL-Erweiterung für Visual Studio Code. Mit dem Agent-Modus kann GitHub Copilot nicht nur Code vorschlagen, es kann sichere echte Datenbankaufgaben mithilfe von Eingabeaufforderungen in natürlicher Sprache oder integrierten Tools ausführen. Sie können alle Ihre Verbindungen auflisten, eine Verbindung mit bestimmten Servern/Datenbanken herstellen und Schemas erkunden, ohne den Editor verlassen zu müssen.

Tip

Sie müssen keinen Teilnehmer wie @mssql erwähnen, um SQL-Tools im Agentenmodus zu verwenden. Sobald die MSSQL-Erweiterung aktiv ist, sind seine Tools automatisch in der AgentModus-Schnittstelle verfügbar. Weitere Informationen finden Sie unter "Agent Mode Tools".

Diese Aktionen werden durch Tools unterstützt, die von der MSSQL-Erweiterung beigetragen und direkt im Agent-Modus von GitHub Copilot angezeigt werden. Weitere Informationen zur Funktionsweise des Agentmodus finden Sie in der Visual Studio Code-Dokumentation im Agentmodus.

Was ist der Agentmodus?

Der Agentmodus ermöglicht GitHub Copilot, über den Vorschlagen von Code hinauszugehen. Jetzt können sichere, bestätigte Aktionen in Ihrer SQL-Entwicklungsumgebung ausgeführt werden, entweder mit Chatvariablen wie #mssql_connect oder natürlichen Phrasen wie:

Connect to my Library database using my LocalDev profile

Screenshot der Chatoberfläche des GitHub Copilot Agent Mode.

MSSQL-Agentmodus-Toolreferenz

Dieser Abschnitt enthält eine detaillierte Referenz zu den SQL-spezifischen Tools, die im GitHub Copilot Agent Mode verfügbar sind. Die MSSQL-Erweiterung trägt diese Tools bei, sodass GitHub Copilot Aktionen über Chatvariablen oder Aufforderungen in natürlicher Sprache ausführt. Alle Tools erfordern eine Benutzerbestätigung vor der Ausführung.

Screenshot von der Liste der SQL-spezifischen Tools, die von der MSSQL-Erweiterung im Copilot Agent Mode bereitgestellt werden.

Tip

Sie können auch Chatvariablen wie #mssql_connect verwenden, um diese Tools direkt aufzurufen oder Eingabeaufforderungen in natürlicher Sprache zu schreiben, zum Beispiel, indem Sie Aufforderungen in natürlicher Sprache schreiben:

Connect to my development database

GitHub Copilot behandelt die Toolauswahl automatisch.

Verbindungsverwaltung

TPoolname Description
connect Stellt eine Datenbankverbindung mithilfe eines gespeicherten Verbindungsprofils oder eines angegebenen Server-/Datenbankpaars her.
disconnect Beendet die aktuelle aktive Verbindungssitzung.
change_database Ändert die Datenbank für eine vorhandene Verbindungssitzung.
get_connection_details Ruft Verbindungsdetails für eine bestimmte MSSQL-Verbindung ab.
list_servers Listet alle gespeicherten SQL Server-Verbindungsprofile in Ihrer Umgebung auf.
list_databases Listet alle verfügbaren Datenbanken für einen verbundenen MSSQL-Server auf.

Examples

Die folgenden Ausdrücke können verwendet werden, um mit GitHub Copilot zu interagieren.

- 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

Screenshot eines Beispiels mit einem Agent-Tool zum Herstellen einer Verbindung mit einer Datenbank im GitHub Copilot-Chat.

Funktionsweise der Verbindungslogik

Der GitHub Copilot Agent Mode unterstützt flexible Methoden zum Herstellen einer Verbindung mit Ihrer SQL-Datenbank, entweder durch Verweisen auf gespeicherte Profile oder durch direkte Angabe eines Servers und einer Datenbank. So funktioniert die Verbindungslogik:

Beim Herstellen einer Verbindung über gespeichertes Profil:

  1. Ein Benutzer kann eine Verbindung herstellen, indem er auf den Namen eines gespeicherten Verbindungsprofils verweist.
  2. GitHub Copilot verwendet das mssql_list_servers Tool, um zu überprüfen, ob das Profil vorhanden ist.
  3. Das mssql_connect Tool verwendet dann die gespeicherten profileId und zugehörigen Parameter, um die Verbindung herzustellen.

Beim Herstellen einer Verbindung über die Server-/Datenbankspezifikation:

  • Wenn ein gespeichertes Profil mit dem angegebenen Server und der angegebenen Datenbank übereinstimmt:

    1. GitHub Copilot verwendet mssql_list_servers , um die Übereinstimmung zu finden.
    2. Anschließend wird mssql_connect mit dem vollständigen Profil aufgerufen.

  • Wenn ein gespeichertes Profil nur mit dem Server übereinstimmt:

    1. GitHub Copilot findet das entsprechende Serverprofil.
    2. Es wird versucht, eine Verbindung herzustellen, indem die vom Benutzer angeforderte Datenbank in dieses Profil eingefügt wird.
    3. Wenn die Verbindung fehlschlägt, wird ein Fehler angezeigt.

  • Wenn kein Profil mit dem angegebenen Server übereinstimmt:

    • GitHub Copilot meldet einen Fehler.

Mit diesem flexiblen Abgleichssystem kann GitHub Copilot eine Reihe von Verbindungsszenarien verarbeiten und gleichzeitig den Benutzeraufwand minimieren und gleichzeitig sichere, bestätigbare Aktionen sicherstellen.

Schema-Untersuchung

TPoolname Description
show_schema Zeigt ein allgemeines Diagramm ihres verbundenen Datenbankschemas an, einschließlich Tabellen und Beziehungen.
list_schemas Listet alle Schemas in einer Datenbank für einen verbundenen MSSQL-Server auf.
list_tables Listet alle Tabellen in einer Datenbank für einen verbundenen MSSQL-Server auf.
list_views Listet alle Ansichten in einer Datenbank für einen verbundenen MSSQL-Server auf.
list_functions Listet alle Funktionen in einer Datenbank für einen verbundenen MSSQL-Server auf.

Examples

Die folgenden Ausdrücke können verwendet werden, um mit GitHub Copilot zu interagieren.

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

Screenshot einer Animation, die das Datenbankschema-Visualisierungswerkzeug im Copilot-Agent-Modus zeigt.

Abfrageausführung

TPoolname Description
run_query Führt eine SQL-Abfrage für die verbundene Datenbank aus.

Examples

Die folgenden Ausdrücke können verwendet werden, um mit GitHub Copilot zu interagieren.

- 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

Screenshot eines Beispiels mit einem Agenttool zum Herstellen einer Verbindung mit einer Datenbank und Abrufen von Daten.

Screenshot eines weiteren Beispiels mit einem Agenttool zum Herstellen einer Verbindung mit einer Datenbank und Abrufen von Daten.

Wie Tools im Agentmodus verwaltet werden

GitHub Copilot kann MSSQL-spezifische Tools und andere Tools, die bei der Erweiterung beigetragen haben, aufrufen, während Sie Ihre Anforderung verarbeiten. Diese Tools sind in der Agentmodus-Schnittstelle im Menü "Extras" sichtbar, in der Sie bestimmte Tools aktivieren oder deaktivieren können.

Wenn ein Tool aufgerufen wird – insbesondere, wenn es mit Ihrem Computer oder Ihrer Datenbank interagiert – fordert GitHub Copilot zur Bestätigung auf, um eine sichere Ausführung sicherzustellen. Sie können das Tool nur für die aktuelle Sitzung, den Arbeitsbereich oder dauerhaft genehmigen.

Weitere Informationen zur Sichtbarkeit und Genehmigung von Tools finden Sie unter Verwalten von Toolgenehmigungen.

Bestätigungsworkflow für den Agentmodus

Wenn GitHub Copilot ein Tool auswählt, werden Sie mit einem Bestätigungsdialogfeld mit Details zur angeforderten Aktion aufgefordert. Sie müssen die Anforderung explizit genehmigen, bevor sie alle Befehle ausführen kann, die mit Ihrem Computer oder Ihrer Datenbank interagieren:

  • Zulassen in dieser Sitzung
  • In diesem Arbeitsbereich zulassen
  • Immer zulassen

Dieser Bestätigungsschritt trägt dazu bei, sichere, absichtliche Interaktionen mit Ihrer Entwicklungsumgebung sicherzustellen.

Note

Weitere Informationen dazu, wie die Bestätigung für alle Tools im Agentmodus funktioniert, finden Sie in der Visual Studio Code-Dokumentation zu Toolgenehmigungen.

Verwandte Inhalte

  • Last updated on