Integrazione di Copilot

L'estensione PostgreSQL si integra con gli assistenti di intelligenza artificiale tramite tre superfici: il partecipante @pgsql chat (solo Visual Studio Code), gli strumenti in modalità agente e un provider di server MCP degli strumenti PostgreSQL. Questa pagina consente di scegliere il punto di ingresso corretto e di comprendere la configurazione condivisa applicabile a tutte e tre.

L'estensione viene eseguita sia in Visual Studio Code (con GitHub Copilot) che in Cursor (con intelligenza artificiale incorporata). La maggior parte delle funzionalità funziona allo stesso modo in entrambi gli editor; i pochi comportamenti specifici di ciascun editor sono evidenziati nel corso di questo articolo.

Prerequisiti

Prima di usare qualsiasi funzionalità assistita dall'intelligenza artificiale, assicurarsi che siano soddisfatti i requisiti seguenti:

  • L'estensione PostgreSQL è installata ed è configurata almeno una connessione al database.
  • Un assistente di intelligenza artificiale è disponibile nell'editor:
    • Visual Studio Code: installare GitHub Copilot o GitHub Copilot Chat e accedere con una sottoscrizione attiva.
    • Cursore: nessuna installazione aggiuntiva; l'intelligenza artificiale predefinita viene usata automaticamente.

Note

Le funzionalità di Copilot sono abilitate per impostazione predefinita (pgsql.copilot.enable è true). Quando si imposta questa opzione su false, il @pgsql partecipante alla chat (solo Visual Studio Code), il sottomenu dell'editor di azioni di query di intelligenza artificiale, gli strumenti in modalità agente e il provider del server MCP sono tutti nascosti.

Tip

L'assistenza di intelligenza artificiale funziona al meglio quando si dispone già di una connessione al database attiva. Se non si è ancora connessi, iniziare con Connessioni e identità.

Scegliere il punto di ingresso giusto

Se vuoi... Iniziare da qui Availability Ulteriori informazioni
Fai una domanda basata sullo schema del tuo database @pgsql partecipante alla chat solo Visual Studio Code @pgsql partecipante alla chat
Avviare la modalità agente con un database specifico già selezionato Connettere l'intelligenza artificiale da un nodo del database nell'albero Connessioni Visual Studio Code e Cursor Modalità agente
Spiegare, riscrivere o analizzare SQL dall'editor Sottomenu Azioni di query AI nel menu di scelta rapida dell'editor Visual Studio Code e Cursor Azioni dell'editor
Automatizzare un'attività di database in più passaggi Connettere intelligenza artificiale in un nodo del database per avviare la modalità agente Visual Studio Code e Cursor Modalità agente
Esporre gli strumenti PostgreSQL agli host compatibili con MCP Provider di server MCP degli strumenti PostgreSQL Visual Studio Code e Cursor Server MCP

Usare @pgsql per la chat con riconoscimento dello schema

Note

Il partecipante alla chat @pgsql è registrato solo in Visual Studio Code, dove si integra con GitHub Copilot Chat. In Cursor, usa Connect AI da un nodo del database nell'albero Connections per avviare la modalità Agente con lo stesso contesto dello schema, oppure utilizza il server MCP nell'interfaccia di chat nativa di Cursor.

L'estensione registra un partecipante @pgsql chat (ID: vscode-postgresql.chat-agent) per le conversazioni con riconoscimento dello schema in GitHub Copilot Chat. Digita @pgsql seguito dalla tua domanda e il partecipante risponde usando il contesto dello schema in tempo reale del database connesso.

Per avviare un flusso di lavoro basato su strumenti con un database già nell'ambito, fare clic con il pulsante destro del mouse su un nodo di database nell'albero Connessioni e selezionare Connetti intelligenza artificiale.

Per la guida per l'utente finale, i prompt di esempio e la risoluzione dei problemi, passa a partecipante alla chat @pgsql.

Usare le azioni dell'editor per la guida incentrata sulle query

Quando SQL è aperto nell'editor di query, fare clic con il pulsante destro del mouse per trovare il sottomenu Azioni query di intelligenza artificiale . Contiene le azioni seguenti:

Action Descrizione
Spiegare la query Restituisce una spiegazione in linguaggio normale delle operazioni della query.
Riscrittura della query Suggerisce una versione alternativa della query mantenendo il risultato previsto.
Analizzare le prestazioni delle query Esegue EXPLAIN ANALYZE sul database connesso, quindi invia il piano di esecuzione all'IA per l'analisi.

È anche possibile selezionare Chiedi informazioni su questa query dalla barra degli strumenti dell'editor per aprire una conversazione di chat in base al contenuto dell'editor corrente.

Per reimpostare le scelte di inclusione delle query memorizzate per l'analisi dei piani, eseguire Cancella le preferenze di inclusione di query per l'analisi di intelligenza artificiale dal riquadro comandi.

Usare la modalità agente per i flussi di lavoro basati su strumenti

La modalità agente consente all'assistente intelligenza artificiale di accedere agli strumenti PostgreSQL in modo che possa connettersi, esaminare lo schema, eseguire query, aprire script e usare attività in più passaggi in una conversazione. Fare clic con il pulsante destro del mouse su un nodo di database nell'albero Connessioni e selezionare Connetti intelligenza artificiale per avviare una sessione in modalità agente.

Per le famiglie di strumenti, flussi di lavoro di esempio e risoluzione dei problemi, continuare con la modalità Agente.

Usare il server MCP negli host supportati

L'estensione registra un provider del server MCP per gli strumenti PostgreSQL (ID: pgsql-tools-mcp-server-provider) che espone lo stesso set di strumenti PostgreSQL tramite il Model Context Protocol. Gli host compatibili con MCP possono individuare e richiamare questi strumenti senza usare i flussi di lavoro di chat predefiniti.

Per informazioni sugli host supportati, sul comportamento della registrazione automatica e sulle famiglie di strumenti esposte tramite MCP, continua con server MCP.

Configurare la modalità di accesso

L'impostazione pgsql.copilot.accessMode controlla la quantità di accesso al database ricevuta dall'assistente di intelligenza artificiale attraverso la modalità Agente e gli strumenti MCP. Il valore predefinito è Lettura/Scrittura (rw).

Valore dell'impostazione Etichetta dell'interfaccia utente Cosa può fare l'assistente di intelligenza artificiale
ro Sola lettura Operazioni di sola lettura: SELECT, SHOW, EXPLAINispezione dello schema
rw Lettura/scrittura Operazioni di lettura e istruzioni di modifica dei dati e DDL, con conferma esplicita

Sostituzione per connessione

È anche possibile impostare la modalità di accesso su singole connessioni. Nella finestra di dialogo di connessione espandere la sezione Copilot (intelligenza artificiale in cursore) e impostare Copilot modalità di accesso (modalità di accesso di intelligenza artificiale in Cursore) su una delle opzioni seguenti:

Opzione Behavior
Usare l'impostazione globale Ripristina il valore globale pgsql.copilot.accessMode (impostazione predefinita)
Sola lettura Forza l'accesso di sola lettura per questa connessione indipendentemente dall'impostazione globale
Lettura/scrittura Forza l'accesso in lettura/scrittura per questa connessione indipendentemente dall'impostazione globale

L'estensione risolve la modalità di accesso effettiva usando questa catena di fallback: valore per connessione → impostazione globale pgsql.copilot.accessMode → predefinita (rw).

Caution

Utilizza Sola lettura per i database di produzione, a meno che non si voglia intenzionalmente consentire modifiche allo schema o ai dati tramite l'assistente IA.

Configurare le impostazioni aggiuntive

Impostazione Che cosa controlla Impostazione predefinita
pgsql.copilot.enable Abilita o disabilita tutta l'integrazione di intelligenza artificiale nell'estensione true
pgsql.copilot.accessMode Modalità di accesso globale dell'IA (sola lettura o lettura/scrittura) rw
pgsql.copilot.autoAttachQuery Indica se il testo della query SQL viene incluso durante l'analisi dei piani con intelligenza artificiale: Ask Every Time, Always Include o Never Include ask
pgsql.copilot.modelOptions Ottimizzazione avanzata del modello (max token, temperature, top_p) per i flussi di lavoro di intelligenza artificiale dell'estensione -

Gli ID delle impostazioni mantengono il prefisso pgsql.copilot.* in entrambi gli editor per garantire la retrocompatibilità, anche quando le etichette visibili all'utente riportano "AI".

Integrazioni di IA specifiche per funzionalità

Diverse funzionalità includono punti di integrazione di intelligenza artificiale dedicati:

Feature Funzionalità di intelligenza artificiale
Visualizzatore del piano di esecuzione della query Analizzare i dati del piano di esecuzione usando Analizza con Copilot (oppure Analizza con AI in Cursor)
Dashboard del server Aprire sessioni di chat dai pulsanti Chiedi a Copilot (Ask AI in Cursor) nei pannelli Query, Attese, Sessioni e grafico delle metriche
Visualizzatore di schemi Visualizzare le relazioni dello schema da un flusso di lavoro in modalità Agente

Contenuti correlati

  • Last updated on