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.
L'agente dati di Fabric consente agli utenti di porre domande in linguaggio naturale sui dati SQL in OneLake — Lakehouse, Data Warehouse, database SQL di Fabric e database con mirroring — e ricevere risposte governate e di sola lettura. Dietro le quinte, l'agente usa uno strumento in linguaggio naturale predefinito per convertire ogni domanda in una query T-SQL, convalidarla con lo schema selezionato ed eseguirla tramite l'endpoint di analisi SQL dell'origine.
Questo articolo descrive i due strumenti di generazione di query che l'agente può usare per le origini SQL:
- NL2SQL : strumento disponibile a livello generale, usato dagli agenti dati nel runtime standard.
- NL2SQL avanzato : strumento di anteprima con ragionamento in più passaggi, usato dagli agenti dati nel runtime di anteprima.
Entrambi gli strumenti disegnano la stessa configurazione specificata per ogni origine SQL, ovvero la selezione dello schema, le istruzioni sull'origine dati e le query di esempio. Per informazioni sulla configurazione di questi input, vedere Aggiungere e configurare origini dati nell'agente dati di Fabric.
NL2SQL
NL2SQL è lo strumento di generazione di query predefinito per le origini SQL ed è lo strumento usato dagli agenti dati nel runtime standard. Genera una query T-SQL in un singolo passaggio:
- Legge lo schema selezionato e le istruzioni sull'origine dati fornite.
- Recupera le query di esempio più pertinenti e più simili alla domanda dell'utente, utilizzando la similarità vettoriale nella libreria di query di esempio.
- Genera una query SQL basata su quel contesto, la convalida in base allo schema approvato e la esegue tramite l'endpoint SQL Analytics.
NL2SQL è ottimizzato per un comportamento stabile e prevedibile ed è la scelta consigliata per gli agenti dati di produzione in cui l'output coerente tra le versioni è importante. Per informazioni sulla selezione dello schema, sulle istruzioni relative alle origini dati e sulle query di esempio usate da NL2SQL, vedere Aggiungere e configurare le origini dati nell'agente dati di Fabric.
Nl2SQL avanzato (anteprima)
Nl2SQL avanzato è una nuova versione dello strumento NL2SQL, disponibile nel runtime di anteprima. È lo stesso strumento — dal linguaggio naturale a SQL sulle tue origini dati SQL — con una differenza fondamentale: invece di generare la query in un unico passaggio, può pianificare ed eseguire diversi passaggi di ragionamento prima di restituire una query. Ad esempio, può esaminare lo schema, selezionare esempi pertinenti, risolvere valori di filtro ambigui o porre una domanda chiara prima di eseguire il commit in una query.
Questo ragionamento in più passaggi produce risultati migliori negli scenari in cui NL2SQL ha storicamente lottato:
- L'esempio seguente esegue query più coerenti. NL2SQL non sempre segue attentamente le query di esempio e talvolta aggiunge logica o vincoli non inclusi negli esempi. Nl2SQL avanzato è più conforme ai modelli illustrati nella libreria di query di esempio.
- Sostituzione corretta dei valori di filtro. Quando una domanda implica più filtri categorici o booleani invece di dichiararli in modo esplicito, NL2SQL potrebbe perdere o inapplicare alcuni di essi. NL2SQL avanzato analizza i filtri impliciti e sostituisce i valori corretti nella query.
- Gestione di domande ambigue. Quando una domanda è ambigua, NL2SQL tende ad attenersi a un’ipotesi e a generare comunque una query. NL2SQL avanzato può rilevare l'ambiguità e porre all'utente una domanda chiara prima di generare SQL, riducendo le risposte non corrette causate dalla finalità di lettura errata.
Nl2SQL avanzato usa la stessa configurazione dell'origine dati di NL2SQL, ovvero la selezione dello schema, le istruzioni sull'origine dati e le query di esempio, quindi non è necessario riconfigurare le origini per provarlo.
Usare NL2SQL avanzato
Nl2SQL avanzato fa parte del runtime di anteprima. Per usarlo, imposta il tuo agente dati sul runtime di anteprima. Vedi runtime dell'agente dati di Fabric per informazioni su come cambiare il runtime e quali altre modifiche comporta questa operazione.
Poiché Advanced NL2SQL è in anteprima, il comportamento può cambiare tra le versioni. Usalo per valutare i miglioramenti in arrivo e fornire feedback prima che raggiungano la disponibilità generale (GA); per gli agenti per dati di produzione che richiedono un output coerente, rimani sul runtime standard con NL2SQL.