Funzionamento di GitHub Copilot con l'estensione MSSQL

L'integrazione GitHub Copilot con l'estensione MSSQL per Visual Studio Code espone diverse superfici in cui l'intelligenza artificiale (AI) supporta lo sviluppo di SQL. Ogni superficie ha funzionalità diverse, accesso diverso allo schema del database e casi d'uso ideali diversi. Questo articolo illustra la superficie di gestione dello scenario, in modo da poter scegliere lo strumento appropriato per ogni attività.

Messaggi chiave:

  • Il partecipante della @mssql chat, gli strumenti in modalità agente, Progettazione schemi e Generatore API dati hanno tutti la consapevolezza dello schema quando si è connessi a un database.
  • I completamenti inline (testo fantasma durante la digitazione in un .sql file) provengono direttamente dal modello di GitHub Copilot e non vedono lo schema del database connesso.
  • Per suggerimenti basati sullo schema durante la scrittura di SQL, usa il partecipante alla chat @mssql invece del testo fantasma in linea.

GitHub Copilot mostra a colpo d'occhio

Surface Fornito da Riconoscimento dello schema? Migliore per
Partecipante alla chat (@mssql) Estensione MSSQL Sì (database collegato) Domande, spiegazioni, creazione di query
Strumenti della modalità agente L'estensione MSSQL fornisce strumenti Sì (tramite chiamate agli strumenti) Flussi di lavoro in più passaggi, modifiche delegate
Modalità piano Visual Studio Code Sì (tramite il contesto @mssql) Ragionamento prima della scrittura del linguaggio DDL (Data Definition Language) SQL
Comandi slash Estensione MSSQL Richieste strutturate per le attività comuni
Completamenti in linea modello di GitHub Copilot direttamente NO Testo fantasma generico durante la digitazione
Progettazione schemi con GitHub Copilot Integrato in Strumento di progettazione schema MSSQL Progettazione dello schema visivo con assistenza per intelligenza artificiale
Generatore API dati con GitHub Copilot Embedded in Generatore di API dati MSSQL Configurazione delle entità per gli endpoint REST, GraphQL e Model Context Protocol (MCP)

Partecipante alla chat: @mssql

Il @mssql partecipante alla chat viene fornito dall'estensione MSSQL. Quando digiti @mssql nella vista Chat di GitHub Copilot, l'estensione riceve la tua richiesta insieme ai metadati sulla connessione al database attiva. L'estensione può:

  • Leggi le informazioni sullo schema (tabelle, colonne, relazioni, procedure memorizzate)
  • Includere il contesto dello schema nel prompt inviato al modello
  • Restituire risposte che fanno riferimento a oggetti reali nel database

Il partecipante alla chat è la principale modalità per ottenere assistenza basata sull'IA consapevole dello schema. Supporta le interazioni in modalità domanda e in modalità modifica quando ti rivolgi a @mssql in chat.

Per una guida dettagliata basata su uno scenario, vedi Avvio rapido: Conversare con il @mssql partecipante (modalità domanda).

Strumenti in modalità agente

La modalità agente consente di GitHub Copilot pianificare ed eseguire il lavoro in modo autonomo. L'estensione MSSQL fornisce una serie di strumenti (ad esempio, connect, list_databases, run_query) che la modalità agente può richiamare per tuo conto, sempre con la tua approvazione.

A differenza del partecipante alla chat (che richiede una menzione esplicita @mssql ), la modalità agente preleva automaticamente gli strumenti dell'estensione MSSQL quando l'estensione è attiva. Si scrivono richieste in linguaggio naturale, ad esempio "Connetti al profilo LocalDev e mostra le tabelle in AdventureWorks" e la modalità agente sceglie gli strumenti da richiamare.

La modalità agente è compatibile con lo schema tramite i relativi strumenti. Ogni chiamata di strumento restituisce dati reali dal database connesso.

Per il riferimento completo dello strumento e i prompt di esempio, consulta Guida introduttiva: usare la modalità agente di GitHub Copilot.

Modalità pianificazione

La modalità Pianifica è una funzionalità di Visual Studio Code che consente a GitHub Copilot di analizzare una richiesta senza apportare modifiche. Quando si passa alla modalità piano, GitHub Copilot produce un piano scritto (spesso salvato come plan.md) che è possibile esaminare prima di passare alla modalità agente o a Progettazione schemi per l'esecuzione.

La modalità Plan è particolarmente adatta alla progettazione di database. Un documento dei requisiti per i prodotti in linguaggio naturale diventa un modello di dati ragionato che include tabelle, tabelle di giunzione, direzione della chiave esterna e vincoli prima della scrittura di qualsiasi DDL SQL.

Per una procedura dettagliata che associa la modalità di piano a un documento relativo ai requisiti del prodotto, vedere Guida introduttiva: Usare la modalità di piano per la progettazione di database basata su specifiche.

Completamenti in linea

I completamenti inline sono il testo fantasma visualizzato durante la digitazione nell'editor. Nei .sql file questi suggerimenti provengono direttamente dal modello di GitHub Copilot.

I completamenti inline non visualizzano lo schema del database connesso. L'API di completamento inline di Visual Studio Code supporta di fatto un solo provider: quando GitHub Copilot è abilitato, le estensioni di terze parti (inclusa l'estensione MSSQL) non possono fornire ghost text sensibile allo schema. Per i suggerimenti SQL con riconoscimento dello schema, usare invece il partecipante alla@mssql chat.

Si tratta di un comportamento della piattaforma, non di una limitazione dell'estensione MSSQL. Si applica a ogni estensione di terze parti che vuole contribuire ai completamenti SQL inline. Per uno sguardo più approfondito a ciò che offrono i completamenti inline, consulta Avvio rapido: usare i completamenti inline di GitHub Copilot nei file SQL.

Progettazione di schemi con GitHub Copilot integrato

Il Designer di schemi dell'estensione MSSQL ha GitHub Copilot integrato direttamente nel canvas. Si tratta di una pipeline separata dalla modalità chat e agente. Lo strumento di progettazione degli schemi ha una propria infrastruttura dei prompt e un proprio modo di applicare il contesto degli schemi. È possibile chiedere GitHub Copilot di creare tabelle dal codice selezionato, aggiungere relazioni, generare dati di test o importare artefatti esterni e osservare l'aggiornamento live del diagramma visivo.

Schema Designer con GitHub Copilot riconosce lo schema perché opera direttamente sul database connesso.

Per esempi basati su scenari, vedere Guida introduttiva: Progettare schemi visivamente con scenari di GitHub Copilot incorporati.

Generatore di API per i dati con GitHub Copilot integrato

L'area di progettazione di Data API Builder incorpora anche un'interfaccia di chat di GitHub Copilot. È possibile usare il linguaggio naturale per configurare entità, autorizzazioni e tipi di output (REST, GraphQL, MCP). Come Schema Designer, questa interfaccia è consapevole dello schema e usa una propria pipeline di prompt.

Per il flusso di lavoro completo, vedere Generatore API dati.

Le istruzioni personalizzate si applicano tra le superfici

Indipendentemente dalla superficie usata, GitHub Copilot applica le istruzioni personalizzate create per il progetto. I file di istruzioni (.github/instructions/*.instructions.md) insegnano a GitHub Copilot le convenzioni del team e vengono inclusi in ogni richiesta il cui modello glob applyTo corrisponde.

Ciò significa che le convenzioni di denominazione, i modelli di file e le preferenze relative ai tipi di dati influenzano allo stesso modo la modalità ask, la modalità agente, la modalità pianificazione e i completamenti in linea. Per informazioni su come configurare questa impostazione, vedere Avvio rapido: Usare istruzioni personalizzate per allineare GitHub Copilot alle convenzioni T-SQL.

Privacy e gestione dei dati

Ogni interazione passa attraverso il proxy di GitHub Copilot che tutela la privacy. I prompt e i completamenti generati non vengono archiviati né usati per addestrare i modelli. Per informazioni dettagliate, vedere Limitazioni e problemi noti e centro protezione GitHub Copilot.

Condividere la propria esperienza

Per ottimizzare e migliorare GitHub Copilot per l'estensione MSSQL, usare il modello di problema GitHub seguente per inviare commenti e suggerimenti: Commenti e suggerimenti su GitHub Copilot

Quando si inviano commenti e suggerimenti, è consigliabile includere:

  • Scenari testati: segnalare le aree su cui ci si è concentrati, ad esempio la creazione dello schema, la generazione di query, la sicurezza, la localizzazione.

  • Cosa ha funzionato bene: descrivere tutte le esperienze che si sono sentite fluide, utili o superate le aspettative.

  • Problemi o bug: includere eventuali problemi, incoerenze o comportamenti confusi. Screenshot o registrazioni dello schermo sono particolarmente utili.

  • Suggerimenti per il miglioramento: condividere idee per migliorare l'usabilità, espandere la copertura o migliorare le risposte di GitHub Copilot.