Freigeben über

Schnellstart: Verwenden des GitHub Copilot-Agent-Modus

Der Agentmodus ermöglicht GitHub Copilot die Verwendung der Tools, die in der MSSQL-Erweiterung für Visual Studio Code verfügbar sind. Wenn die Erweiterung installiert und aktiv ist, kann Copilot SQL Server-Verbindungen auflisten, eine Verbindung mit einem Server und einer Datenbank herstellen und Datenbankmetadaten abrufen.

Alle Aktionen verwenden denselben Verbindungskontext und dieselben Anmeldeinformationen wie die MSSQL-Erweiterung. Der Agentmodus führt keine weiteren Authentifizierungs- oder Berechtigungsänderungen ein.

Tip

Sie müssen nicht explizit auf die MSSQL-Erweiterung (@mssql) verweisen, wenn Sie den Agentmodus verwenden. Wenn die Erweiterung aktiv ist, sind die Tools automatisch verfügbar. Weitere Informationen finden Sie unter "Agent Mode Tools".

Ausführliche Informationen dazu, wie der Agentmodus Tools auswählt und ausführt, finden Sie in der Visual Studio Code-Dokumentation im Agentmodus.

Was ist der Agentmodus?

Im Agentmodus kann GitHub Copilot SQL-bezogene Aktionen mithilfe der MSSQL-Erweiterung ausführen, und die Benutzerbestätigung ist vor der Ausführung erforderlich.

Sie können diese Aktionen aufrufen, indem Sie Chatvariablen wie #mssql_connectz. B. oder entsprechende Anforderungen in natürlicher Sprache ausgeben, z. B.:

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 Verbindung zu einer Datenbank mithilfe eines gespeicherten Verbindungsprofils oder eines angegebenen Servers und einer angegebenen Datenbank 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

Verwenden Sie die folgenden Ausdrücke, 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. Hier erfahren Sie, wie die Verbindungslogik funktioniert.

Wenn Sie eine Verbindung mit einem gespeicherten Profil herstellen:

  1. Sie stellen eine Verbindung her, indem Sie auf den Namen eines gespeicherten Verbindungsprofils verweisen.
  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.

Wenn Sie eine Verbindung herstellen, indem Sie einen Server und eine Datenbank angeben:

  • 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. Dadurch wird der Benutzeraufwand minimiert, während sichere, bestätigbare Aktionen sichergestellt werden.

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

Verwenden Sie die folgenden Ausdrücke, 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

Verwenden Sie die folgenden Ausdrücke, 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 von der Erweiterung bereitgestellte Tools nutzen, während es Ihre Anforderung verarbeitet. Sie können diese Tools in der Agentmodus-Schnittstelle im Menü "Extras " sehen, wo Sie auch bestimmte Tools aktivieren oder deaktivieren können.

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

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 aufgefordert, in dem Details zur angeforderten Aktion angezeigt werden. 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