Brug emner i en Fabric dataagent (forhåndsvisning)

Ved at bruge emner kan du give store, emnebaserede instruktioner, der hjælper en Fabric-dataagent med at generere SQL. I stedet for at sende alt emneindhold med hvert spørgsmål, søger dataagenten i indholdet og giver NL2SQL-værktøjet kun de dele, der er relevante for spørgsmålet.

Brug emner, når du har et stort sæt vejledning, som du kan organisere efter emne. For eksempel kan du oprette sektioner for salg, lager og kundefastholdelse og derefter give forretningsdefinitioner og forespørgselsvejledning, der gælder for hvert emne.

Bemærkning

Emnerne er i forhåndsvisning og er kun tilgængelige for SQL-datakilder på forhåndsvisningsruntime.

Emner og instruktioner til datakilder

Emner og datakildeinstruktioner giver forskellige former for kontekst til forespørgselsgenereringsværktøjer:

Konfiguration Hvordan dataagenten bruger det Hvornår skal du bruge den?
Emner Dataagenten søger i emneindholdet og sender de relevante sektioner til NL2SQL. Brug dem til store instruktioner, som du kan opdele i emner, og som du kun har brug for, når et spørgsmål vedrører et emne.
Instruktioner til datakilde Dataagenten sender instruktionerne til forespørgselsgenereringsværktøjet hver gang den bruger datakilden. Brug for regler og kontekst, der skal gælde for hvert spørgsmål, der sendes til datakilden.

For eksempel kan man sætte en organisationsdækkende regnskabsårsdefinition i datakildeinstruktionerne, hvis alle forespørgsler skal bruge den. Sæt detaljeret vejledning til beregning af kundefastholdelse i et emne, hvis vejledningen kun er nødvendig for spørgsmål om fastholdelse.

Du kan bruge emner og datakildeinstruktioner sammen. Når et spørgsmål kræver begge dele, modtager NL2SQL datakildeinstruktionerne og det relevante emneindhold.

Tilføj emnebaserede instruktioner

Du kan tilføje op til 1 million tegn emneindhold til hver understøttet SQL-datakilde.

  1. Åbn din Fabric-dataagent, og vælg en SQL-datakilde.

  2. I datakildekonfigurationen, åbne emner om datakilde.

  3. Indtast dine emnebaserede instruktioner. Brug Markdown-overskrifter til at organisere indholdet i forskellige emner.

  4. Gem konfigurationen af dataagenten.

  5. Test spørgsmål, der passer til individuelle emner, og spørgsmål, der kræver mere end ét emne.

    Skærmbillede af Data source topics editoren, der viser Markdown-emneinstruktioner og en disposition.

Strukturer emneindhold

Brug beskrivende Markdown-overskrifter, så dataagenten kan finde det korrekte afsnit til et spørgsmål. Gem al vejledning for et emne under den 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 bruger spørger om churn, kan dataagenten hente kundefastholdelsesvejledningen uden at sende den urelaterede lagervejledning til NL2SQL.

Gennemgå hentede emner i run-steps

Efter du har testet et spørgsmål, gennemgå Open Data Source Topic-kørselstrinnet for at se, hvilket emneindhold dataagenten har valgt. Inputtet viser overskriftsstien og grunden til, at emnet blev valgt. Outputtet viser instruktionerne, der er givet til NL2SQL.

Skærmbillede af Open Data Source Topic-kørselstrinnet, der viser den valgte overskriftsti og hentede instruktioner.

Bedste praksis

  • Brug overskrifter, der matcher de termer, folk bruger i deres spørgsmål.
  • Hold hvert emne selvstændigt. Inkluder de relevante forretningsdefinitioner, tabeller, kolonner, relationer, filtre og beregningsregler under samme emneoverskrift.
  • Brug underoverskrifter til at adskille relaterede scenarier inden for et bredt emne.
  • Sæt regler, der skal gælde for alle SQL-spørgsmål, i datakildeinstruktioner i stedet for at gentage dem i flere emner.
  • Undgå at duplikere eller modsige vejledninger på tværs af emner og instruktioner til datakilden.
  • Test direkte spørgsmål, alternative formuleringer og spørgsmål, der kræver indhold fra flere emner.

Relateret indhold

  • Last updated on