Usare l'assistente
Apri un editor SQL e clicca AI. Il pannello dell'assistente si apre accanto all'editor. Configura prima un provider — vedi Configurare un provider.
Fare una domanda
- Connessione AI — scegli quale provider configurato usare.
- Query — descrivi ciò che vuoi in linguaggio naturale: «fatturato totale per mese del 2026, solo ordini pagati».
- Includi SQL corrente — invia ciò che è nell'editor, per «perché restituisce duplicati?» o «riscrivi questa senza la subquery».
- Tabelle (per il contesto) — clicca + Aggiungi tabella per scegliere quali tabelle il modello deve conoscere. Le etichette indicano quante tabelle forniscono lo schema e quante un campione di dati.
- ▶ Invia.
Prima di inviare
Anteprima richiesta mostra il JSON esatto che verrà trasmesso, con il conteggio dei caratteri. Aprila ogni volta che la domanda coinvolge tabelle con contenuti sensibili: è la differenza tra supporre cosa lascia la tua macchina e saperlo.
Il conteggio dei caratteri è anche una stima grossolana del costo con i provider a consumo.
Lavorare con la risposta
La risposta arriva nel pannello con quattro azioni:
| Azione | Effetto |
|---|---|
| Copia SQL | Copia solo l'SQL dalla risposta |
| Copia nell'editor | Lo inserisce direttamente nell'editor |
| Mostra risposta completa | La risposta integrale, spiegazioni comprese |
| Cancella | Svuota il pannello |
Leggi l'SQL prima di eseguirlo
Il modello non conosce i tuoi volumi di dati, i tuoi indici o le tue regole di business, e occasionalmente produrrà un'istruzione sintatticamente corretta e semanticamente sbagliata. Controlla in particolare le clausole WHERE e JOIN prima di eseguire qualcosa che scrive.
Per UPDATE e DELETE, esegui prima il SELECT equivalente e guarda cosa torna.
Ottenere risposte migliori
- Aggiungi le tabelle rilevanti. Senza schema il modello indovina i nomi delle colonne — e li indovina in modo plausibile e sbagliato.
- Spiega cosa intendi con i termini. «Clienti attivi» significa una cosa nel tuo schema e un'altra in quello di qualcun altro. «Attivo = nessun cancelled_at e un ordine negli ultimi 90 giorni» produce la query che volevi.
- Itera. Rimanda indietro la query generata con «questa conta due volte i rimborsi, correggila» invece di ricominciare.
- Usa il system prompt per tutto ciò che vale per ogni domanda — il dialetto SQL, le tue convenzioni di denominazione, «usa sempre la sintassi JOIN esplicita».
Quando il modello è lo strumento sbagliato
- Esplorare uno schema sconosciuto → il diagramma ER e il generatore visuale di query.
- Una query lenta → il profiler. Il piano dice cosa succede davvero; il modello può solo tirare a indovinare.
- Lavoro di produzione ripetuto → salva la query una volta che è corretta, così smette di essere rigenerata ogni volta.