Condividi tramite

Guida introduttiva: Usare la modalità agente copilot di GitHub

La modalità agente di GitHub Copilot offre un'esperienza di chat contestuale guidata dalle azioni nell'estensione MSSQL per Visual Studio Code. Con la modalità agente, GitHub Copilot può andare oltre a suggerire codice, ma può eseguire in modo sicuro attività di database reali usando prompt in linguaggio naturale o strumenti predefiniti. È possibile elencare tutte le connessioni, connettersi a server/database specifici ed esplorare gli schemi senza uscire dall'editor.

Tip

Non è necessario menzionare un partecipante come @mssql per usare gli strumenti SQL in modalità Agente. Quando l'estensione MSSQL è attiva, i relativi strumenti sono automaticamente disponibili nell'interfaccia Modalità agente. Per altre informazioni, vedere Strumenti per la modalità agente.

Queste azioni sono basate su strumenti forniti dall'estensione MSSQL e visualizzati direttamente all'interno della modalità agente di GitHub Copilot. Per altre informazioni sul funzionamento della modalità agente, vedere la documentazione di Visual Studio Code sulla modalità agente.

Che cos'è la modalità agente?

La modalità agente consente a GitHub Copilot di andare oltre a suggerire codice. Ora può eseguire azioni sicure e confermate all'interno dell'ambiente di sviluppo SQL, usando variabili di chat come , o frasi naturali come #mssql_connect:

Connect to my Library database using my LocalDev profile

Screenshot dell'interfaccia di chat in modalità agente Copilot di GitHub.

Informazioni di riferimento per lo strumento modalità agente MSSQL

Questa sezione fornisce un riferimento dettagliato per gli strumenti specifici di SQL disponibili in modalità Agente Copilot di GitHub. L'estensione MSSQL contribuisce a questi strumenti, consentendo a GitHub Copilot di eseguire azioni tramite variabili di chat o prompt del linguaggio naturale. Tutti gli strumenti richiedono la conferma dell'utente prima dell'esecuzione.

Screenshot dell'elenco degli strumenti specifici di SQL forniti dall'estensione MSSQL in modalità agente Copilot.

Tip

È anche possibile usare variabili di chat come #mssql_connect richiamare direttamente questi strumenti o scrivere richieste in linguaggio naturale, ad esempio:

Connect to my development database

GitHub Copilot gestisce automaticamente la selezione degli strumenti.

Gestione delle connessioni

Nome dello strumento Description
connect Stabilisce una connessione di database usando un profilo di connessione salvato o una coppia di server/database specificata.
disconnect Termina la sessione di connessione attiva corrente.
change_database Modifica il database per una sessione di connessione esistente.
get_connection_details Ottiene i dettagli della connessione per una connessione MSSQL specifica.
list_servers Elenca tutti i profili di connessione di SQL Server salvati nell'ambiente in uso.
list_databases Elenca tutti i database disponibili per un server MSSQL connesso.

Examples

Le frasi seguenti possono essere usate per interagire con 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

Screenshot dell'esempio che usa uno strumento agente per connettersi a un database nella chat di GitHub Copilot.

Funzionamento della logica di connessione

La modalità agente di GitHub Copilot supporta modi flessibili per connettersi al database SQL, facendo riferimento ai profili salvati o specificando direttamente un server e un database. Ecco come funziona la logica di connessione:

Quando ci si connette tramite profilo salvato:

  1. Un utente può connettersi facendo riferimento al nome di un profilo di connessione salvato.
  2. GitHub Copilot usa lo mssql_list_servers strumento per verificare l'esistenza del profilo.
  3. Lo mssql_connect strumento usa quindi i parametri salvati profileId e i relativi parametri per stabilire la connessione.

Quando ci si connette tramite la specifica del server o del database:

  • Se un profilo salvato corrisponde sia al server che al database specificati:

    1. GitHub Copilot usa mssql_list_servers per trovare la corrispondenza.
    2. Chiama quindi mssql_connect usando il profilo completo.

  • Se un profilo salvato corrisponde solo al server:

    1. GitHub Copilot trova il profilo server corrispondente.
    2. Tenta di connettersi sostituendo il database richiesto dall'utente in tale profilo.
    3. Se la connessione non riesce, viene visualizzato un errore.

  • Se nessun profilo corrisponde al server specificato:

    • GitHub Copilot segnala un errore.

Questo sistema di corrispondenza flessibile consente a GitHub Copilot di gestire una serie di scenari di connessione, riducendo al minimo il lavoro dell'utente garantendo azioni sicure e verificabili.

Esplorazione dello schema

Nome dello strumento Description
show_schema Visualizza un diagramma generale dello schema del database connesso, incluse tabelle e relazioni.
list_schemas Elenca tutti gli schemi in un database per un server MSSQL connesso.
list_tables Elenca tutte le tabelle in un database per un server MSSQL connesso.
list_views Elenca tutte le viste in un database per un server MSSQL connesso.
list_functions Elenca tutte le funzioni in un database per un server MSSQL connesso.

Examples

Le frasi seguenti possono essere usate per interagire con 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?

Screenshot dell'animazione che mostra lo strumento visualizzatore dello schema del database in modalità agente Copilot.

Esecuzione della query

Nome dello strumento Description
run_query Esegue una query SQL sul database connesso.

Examples

Le frasi seguenti possono essere usate per interagire con 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

Screenshot dell'esempio che usa uno strumento agente per connettersi a un database e recuperare i dati.

Screenshot di un altro esempio che usa uno strumento agente per connettersi a un database e recuperare i dati.

Modalità di gestione degli strumenti in modalità agente

GitHub Copilot può richiamare strumenti specifici di MSSQL e altri strumenti forniti dall'estensione durante l'elaborazione della richiesta. Questi strumenti sono visibili nell'interfaccia Modalità agente nel menu Strumenti, in cui è possibile abilitare o disabilitare strumenti specifici.

Quando viene richiamato uno strumento, soprattutto se interagisce con il computer o il database, GitHub Copilot richiede la conferma per garantire l'esecuzione sicura. È possibile consentire lo strumento solo per la sessione corrente, l'area di lavoro o approvarla in modo permanente.

Per altre informazioni sulla visibilità e le approvazioni degli strumenti, vedere Gestire le approvazioni degli strumenti.

Flusso di lavoro di conferma della modalità agente

Quando GitHub Copilot seleziona uno strumento, viene visualizzata una finestra di dialogo di conferma che mostra i dettagli sull'azione richiesta. È necessario approvare in modo esplicito la richiesta prima di poter eseguire tutti i comandi che interagiscono con il computer o il database:

  • Consenti in questa sessione
  • Consenti in quest'area di lavoro
  • Consenti sempre

Questo passaggio di conferma garantisce interazioni intenzionali e sicure con l'ambiente di sviluppo.

Note

Per altre informazioni sul funzionamento della conferma in tutti gli strumenti in modalità agente, vedere la documentazione di Visual Studio Code sulle approvazioni degli strumenti.

Contenuti correlati

  • Last updated on