Usa gli argomenti in un data agent Fabric (anteprima)

Utilizzando argomenti, puoi fornire istruzioni ampie basate su argomenti che aiutano un agente dati Fabric a generare SQL. Invece di inviare tutto il contenuto dell'argomento con ogni domanda, l'agente dati cerca il contenuto e fornisce allo strumento NL2SQL solo le parti rilevanti per la domanda.

Usa argomenti quando hai un ampio insieme di indicazioni che puoi organizzare per argomento. Ad esempio, puoi creare sezioni per vendite, inventario e fidelizzazione clienti, e poi fornire le definizioni aziendali e le indicazioni per le query che si applicano a ciascun argomento.

Note

Gli argomenti sono in anteprima e sono disponibili solo per sorgenti dati SQL nel runtime di anteprima.

Argomenti e istruzioni per le sorgenti dei dati

Gli argomenti e le istruzioni per le fonti dati forniscono diversi tipi di contesto agli strumenti di generazione delle query:

Configuration Come l'agente dati lo utilizza Quando usarlo
Argomenti L'agente dati cerca il contenuto dell'argomento e invia le sezioni rilevanti a NL2SQL. Usa istruzioni grandi che puoi suddividere in argomenti e che ti servono solo quando una domanda riguarda un argomento.
Istruzioni sull'origine dati L'agente dati invia le istruzioni allo strumento di generazione delle query ogni volta che utilizza la sorgente dati. Da usare per le regole e il contesto che devono applicarsi a ogni domanda inviata all'origine dati.

Ad esempio, inserire una definizione dell'anno fiscale a livello organizzativo nelle istruzioni della sorgente dati se ogni query deve usarla. Inserisci indicazioni dettagliate per calcolare la fidelizzazione dei clienti in un argomento di fidelizzazione se le indicazioni sono necessarie solo per domande sulla fidelizzazione.

Puoi usare insieme argomenti e istruzioni per le fonti dati. Quando una domanda richiede entrambi, NL2SQL riceve le istruzioni per la fonte dei dati e il contenuto pertinente dell'argomento.

Aggiungi istruzioni basate sull'argomento

Puoi aggiungere fino a 1 milione di caratteri di contenuto argomentato a ciascuna sorgente dati SQL supportata.

  1. Apri il tuo data agent Fabric e seleziona una sorgente dati SQL.

  2. Nella configurazione della sorgente dati, apri Data source topics.

  3. Inserisci le istruzioni basate sull'argomento. Usa le intestazioni Markdown per organizzare i contenuti in argomenti distinti.

  4. Salva la configurazione dell'agente dati.

  5. Domande di test che corrispondono a singoli argomenti e domande che richiedono più di un argomento.

    Screenshot dell'editor di argomenti di sorgenti dati che mostra le istruzioni per i temi Markdown e una scaletta.

Struttura del contenuto dell'argomento

Usa titoli descrittivi Markdown così che l'agente dati possa trovare la sezione corretta per una domanda. Mantieni tutte le linee guida relative a un argomento sotto l'intestazione corrispondente.

## Customer retention

Use the CustomerSubscription table for retention questions.

### Retained customers

A customer is retained when IsActive is 1 and RenewalDate is after the reporting date.

### Churn rate

Calculate churn rate as the number of subscriptions canceled during the period divided by the number of active subscriptions at the start of the period.

## Inventory

Use the InventorySnapshot table for current inventory questions.

### Low-stock products

A product is low in stock when QuantityOnHand is less than ReorderPoint.

Quando un utente chiede informazioni sul churn, l'agente di dati può recuperare le linee guida sulla fidelizzazione dei clienti senza inviare a NL2SQL le linee guida non pertinenti sull'inventario.

Rivedi gli argomenti recuperati nei passaggi di esecuzione

Dopo aver testato una domanda, rivedi il passaggio di esecuzione Open Data Source Topic per vedere quale contenuto tematico l'agente dati ha selezionato. L'input visualizza il percorso dell'intestazione e il motivo per cui è stato selezionato l'argomento. L'output mostra le istruzioni fornite a NL2SQL.

Schermata della fase di esecuzione di Open Data Source Topic che mostra il percorso dell’intestazione selezionata e le istruzioni recuperate.

Procedure consigliate

  • Usa titoli che corrispondono ai termini che le persone usano nelle loro domande.
  • Mantieni ogni argomento autonomo. Includere le definizioni aziendali rilevanti, tabelle, colonne, relazioni, filtri e regole di calcolo sotto lo stesso tema tematico.
  • Usa i sottotitoli per separare gli scenari correlati all'interno di un argomento ampio.
  • Inserisci regole che debbano applicarsi a ogni domanda SQL nelle istruzioni della sorgente dati invece di ripeterle in più argomenti.
  • Evita di duplicare o contraddire le linee guida tra argomenti e istruzioni sulle fonti dei dati.
  • Testa domande dirette, formulazioni alternative e domande che richiedono contenuti su più argomenti.

Contenuti correlati

  • Last updated on