Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La modalità agente consente all'assistente intelligenza artificiale nell'editor di usare gli strumenti PostgreSQL dall'estensione come parte di una singola conversazione in più passaggi. Invece di rispondere solo a una domanda, l'assistente può connettersi a un database, esaminare lo schema, eseguire query, aprire script e facilitare lo spostamento attraverso un flusso di lavoro end-to-end.
La modalità agente viene eseguita sia in Visual Studio Code (con GitHub Copilot) che in cursore (con intelligenza artificiale incorporata). L'estensione espone la stessa superficie dello strumento PostgreSQL in entrambi gli editor; solo il pannello della chat che si apre è diverso.
Usare la modalità Agent quando si vuole che l'intelligenza artificiale eserci azioni strutturate, non solo spiegare o creare una bozza di SQL.
Prerequisiti
Prima di iniziare, assicurarsi di avere:
- L'estensione PostgreSQL è stata installata.
- Copilot/funzionalità di intelligenza artificiale abilitate nell'estensione (
pgsql.copilot.enableètrue). - Almeno una connessione di database configurata nell'estensione.
- Assistente di intelligenza artificiale disponibile nell'editor:
- Visual Studio Code: GitHub Copilot o GitHub Copilot Chat installata e attiva.
- Cursore: nessuna installazione aggiuntiva; l'intelligenza artificiale predefinita viene usata automaticamente.
Avviare la modalità agente
- Connettersi al server o al database di destinazione nell'estensione PostgreSQL.
- Nell'albero Connessioni fare clic con il pulsante destro del mouse sul database da usare.
- Selezionare Connetti intelligenza artificiale.
- Continuare la conversazione nel pannello della chat che si apre con il flusso di lavoro che si vuole completare.
- In Visual Studio Code questo è il pannello Copilot Chat GitHub in modalità Agente.
- In Cursore questo è il pannello nativo dell'intelligenza artificiale del cursore; L'estensione fornisce un breve preambolo orientato a MCP in modo che l'assistente conosca gli strumenti PostgreSQL disponibili.
Una volta avviata la sessione, l'IA può combinare gli strumenti di PostgreSQL dietro le quinte mentre gestisce la tua richiesta.
Scegliere la modalità di accesso corretta
L'impostazione pgsql.copilot.accessMode controlla il livello di accesso al database ricevuto dalla modalità Agente. L'ID dell'impostazione mantiene il prefisso pgsql.copilot.* per garantire la compatibilità; l'etichetta visibile all'utente è modalità di accesso di Copilot in Visual Studio Code e modalità di accesso all'IA in Cursor.
| Modalità | Cosa può fare l'intelligenza artificiale | Uso consigliato |
|---|---|---|
ro |
Operazioni di sola lettura come SELECT, SHOW, EXPLAIN, l'ispezione dello schema e l'analisi |
Sistemi di produzione o ambienti condivisi in cui si vuole eseguire l'analisi senza modifiche |
rw |
Operazioni di lettura e istruzioni di modifica dei dati e DDL, con conferma esplicita prima dell'esecuzione | Sviluppo locale, sandbox eliminabili e ambienti di test controllati |
Caution
Usare ro la modalità per i database di produzione, a meno che non si desideri intenzionalmente che lo schema o le modifiche ai dati siano disponibili tramite la modalità Agente.
Comprendere le famiglie di strumenti
La modalità agente può usare più famiglie di strumenti a seconda del flusso di lavoro.
| Famiglia di strumenti | Funzionamento | Quando lo usi |
|---|---|---|
| Strumenti di connessione | Elencare i profili, connettersi, disconnettere, elencare i database | Avviare o cambiare contesto |
| Strumenti di contesto dello schema | Recuperare le definizioni di oggetti o visualizzare lo schema | Informazioni su tabelle, viste, funzioni, indici e relazioni |
| Strumenti di query | Eseguire query di lettura, esaminare i piani di query, aprire script | Analizzare i dati, convalidare idee o rivedere SQL generato |
| Strumenti di modifica | Eseguire DDL o DML con conferma | Applicare modifiche controllate allo schema o ai dati in rw modalità |
| Strumenti di importazione dei dati | Descrivere i file CSV e caricarli in blocco | Pianificare ed eseguire flussi di lavoro di importazione CSV |
Tip
In Cursor gli stessi strumenti vengono visualizzati anche tramite la registrazione del server MCP. La chat nativa di Cursor può richiamarli direttamente senza usare il punto di accesso Connect AI. Per informazioni dettagliate, vedere Server MCP .
Usare la modalità agente per flussi di lavoro comuni
Negli esempi seguenti viene illustrato come usare la modalità Agent per le attività che vanno dall'esplorazione di un nuovo database alla ridefinizione delle query.
Esplorare un database non familiare
Chiedere all'intelligenza artificiale di connettersi al database, elencare gli oggetti chiave e riepilogare le aree dello schema importanti per l'attività.
Esempio:
Connettersi al database di sviluppo, elencare le tabelle nello schema pubblico e indicare quali elementi sono correlati a clienti e ordini.
Analizzare le prestazioni delle query
Chiedere all'intelligenza artificiale di combinare il contesto dello schema con l'esecuzione di query o l'ispezione del piano.
Esempio:
Connettiti al database di staging, esegui questa query in modalità di sola lettura e spiega quale parte del piano di esecuzione determina il costo.
Caricare o rimodellare i dati
Usare la modalità Agente quando il flusso di lavoro include script o operazioni basate su CSV.
Esempio:
Esaminare questo file CSV, indicare lo schema che implica e preparare un piano di importazione sicuro per la
sales.recordstabella.
Passare dalla bozza alla revisione manuale
Quando si vuole un checkpoint di revisione umana prima dell'esecuzione, chiedere all'intelligenza artificiale di aprire il codice SQL generato nell'editor di query anziché eseguirlo immediatamente.
Sapere quando usare la modalità Agente invece di @pgsql
Usa @pgsql partecipante della chat quando vuoi una risposta basata sullo schema o una bozza di query. Il @pgsql partecipante è disponibile solo in Visual Studio Code.
Usare la modalità agente (disponibile sia in Visual Studio Code che in cursore) quando si vuole che l'intelligenza artificiale:
- connettersi al database appropriato per l'utente,
- concatenare più strumenti in una conversazione,
- esaminare i risultati prima del passaggio successivo o
- preparare uno script o un flusso di lavoro di modifica controllato.
Note
In Cursor, la modalità agente è l'opzione principale perché il partecipante alla chat @pgsql non è disponibile lì. La stessa interfaccia dello strumento è accessibile anche dalla chat nativa di Cursor tramite il server MCP.
Risolvere i problemi relativi alla modalità agente
Se la modalità Agente non si comporta come previsto, controllare prima la modalità di accesso e la disponibilità degli strumenti.
L'intelligenza artificiale non può modificare il database
Verificare pgsql.copilot.accessMode e verificare che la connessione attiva non sia stata risolta in ro.
Lo strumento previsto non è disponibile
Assicurarsi che l'integrazione di Copilot sia abilitata e di essere partiti da un database con un contesto di connessione PostgreSQL valido.
Una richiesta di connessione non riesce
Verificare che il profilo di connessione esista ancora, che le credenziali siano disponibili e che l'estensione possa connettersi allo stesso database all'esterno della modalità Agente.
Voglio un flusso di lavoro più semplice incentrato sulla chat
In Visual Studio Code usare @pgsql partecipante alla chat quando si desidera una spiegazione, una stesura di query o domande sullo schema senza automazione basata sugli strumenti. In Cursore porre gli stessi tipi di domande dalla chat nativa. Gli strumenti MCP dell'estensione sono ancora rilevabili, ma la chat si comporta in modo più colloquiale senza una voce esplicita per la modalità Agente.