Bruk emner i en Fabric-dataagent (forhåndsvisning)

Ved å bruke emner kan du gi store, temabaserte instruksjoner som hjelper en Fabric-dataagent med å generere SQL. I stedet for å sende alt temainnhold med hvert spørsmål, søker dataagenten i innholdet og gir NL2SQL-verktøyet kun de delene som er relevante for spørsmålet.

Bruk emner når du har et stort sett med veiledning som du kan organisere etter tema. For eksempel kan du lage seksjoner for salg, lager og kundelojalitet, og deretter gi forretningsdefinisjoner og spørringsveiledning som gjelder for hvert emne.

Obs!

Temaene er i forhåndsvisning og er kun tilgjengelige for SQL-datakilder på forhåndsvisningskjøringen.

Emner og instruksjoner for datakilder

Emner og instruksjoner for datakilder gir ulike typer kontekst til verktøy for spørringsgenerering:

Konfigurasjon Hvordan dataagenten bruker det Når den skal brukes
Emner Dataagenten søker i temainnholdet og sender de relevante seksjonene til NL2SQL. Bruk for store instruksjoner som du kan dele inn i emner, og som du bare trenger når et spørsmål gjelder et emne.
Datakildeinstruksjoner Dataagenten sender instruksjonene til spørringsgenereringsverktøyet hver gang den bruker datakilden. Bruk for regler og kontekst som må gjelde for hvert spørsmål som sendes til datakilden.

For eksempel, legg inn en organisasjonsomfattende definisjon for regnskapsåret i instruksjonene for datakilder hvis alle spørringer må bruke den. Inkluder detaljert veiledning for beregning av kundelojalitet i et kundelojalitetstema hvis veiledningen kun trengs for spørsmål om lojalitet.

Du kan bruke emner og instruksjoner for datakilder sammen. Når et spørsmål krever begge deler, mottar NL2SQL instruksjonene for datakilden og det relevante temainnholdet.

Legg til temabaserte instruksjoner

Du kan legge til opptil 1 million tegn med temainnhold til hver støttet SQL-datakilde.

  1. Åpne Fabric-dataagenten din, og velg en SQL-datakilde.

  2. I datakildekonfigurasjonen, åpne datakildetemaer.

  3. Skriv inn dine temabaserte instruksjoner. Bruk Markdown-overskrifter for å organisere innholdet i ulike emner.

  4. Lagre dataagent-konfigurasjonen.

  5. Test spørsmål som dekker individuelle temaer og spørsmål som krever mer enn ett tema.

    Skjermbilde av datakilde-emneeditoren som viser Markdown-instruksjoner og en disposisjon.

Strukturer temainnholdet

Bruk beskrivende Markdown-overskrifter slik at dataagenten kan finne riktig seksjon for et spørsmål. Hold all veiledning for et emne under tilsvarende overskrift.

## 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.

Når en bruker spør om churn, kan dataagenten hente kunderetensjonsveiledningen uten å sende den urelaterte lagerveiledningen til NL2SQL.

Gå gjennom hentede temaer i kjøretrinn

Etter at du har testet et spørsmål, gå gjennom steget Open Data Source Topic for å se hvilket temainnhold dataagenten har valgt. Inndata viser overskriftsstien og hvorfor temaet ble valgt. Utdataene viser instruksjonene som ble gitt til NL2SQL.

Skjermbilde av kjøresteget Open Data Source Topic som viser valgt overskriftssti og hentede instruksjoner.

Beste fremgangsmåter

  • Bruk overskrifter som matcher begrepene folk bruker i spørsmålene sine.
  • Hold hvert tema selvstendig. Inkluder relevante forretningsdefinisjoner, tabeller, kolonner, relasjoner, filtre og beregningsregler under samme emneoverskrift.
  • Bruk underoverskrifter for å skille relaterte scenarioer innenfor et bredt tema.
  • Sett regler som må gjelde for alle SQL-spørsmål i datakildeinstruksjoner i stedet for å gjenta dem i flere emner.
  • Unngå å duplisere eller motsi veiledning på tvers av emner og instruksjoner til datakilden.
  • Test direkte spørsmål, alternative formuleringer og spørsmål som krever innhold fra flere temaer.

Relatert innhold

  • Last updated on