Použití témat v datovém agentu Fabric (náhled)

Používáním témat můžete poskytovat rozsáhlé, tematické instrukce, které pomáhají datovému agentovi Fabric generovat SQL. Místo posílání veškerého obsahu tématu ke každé otázce datový agent vyhledává obsah a poskytuje nástroji NL2SQL pouze ty části, které jsou k otázce relevantní.

Používejte témata, když máte rozsáhlý soubor pokynů, které můžete uspořádat podle předmětů. Například můžete vytvořit sekce pro prodej, zásoby a udržení zákazníků a poté poskytnout obchodní definice a pokyny pro dotazy, které se vztahují na každé téma.

Note

Témata jsou ve verzi Preview a jsou k dispozici pouze pro datové zdroje SQL v náhledovém běhovém prostředí.

Témata a instrukce pro zdroje dat

Témata a instrukce pro zdroje dat poskytují různé druhy kontextu nástrojům pro generování dotazů:

Configuration Jak je datový agent používá Kdy ji použít
Témata Datový agent vyhledává obsah tématu a odesílá příslušné části do NL2SQL. Použijte je pro rozsáhlé instrukce, které můžete rozdělit do témat a které potřebujete pouze tehdy, když se otázka týká určitého tématu.
Pokyny ke zdroji dat Datový agent posílá instrukce nástroji pro generování dotazů pokaždé, když použije datový zdroj. Použití pro pravidla a kontext, které musí platit pro každou otázku zaslanou zdroji dat.

Například vložte celoorganizační definici fiskálního roku do instrukcí zdroje, pokud ji musí používat každý dotaz. Pokud jsou pokyny potřeba pouze pro otázky ohledně udržení zákazníků, uveďte podrobné pokyny pro výpočet udržení zákazníků.

Můžete používat témata a instrukce pro zdroje dat společně. Když otázka vyžaduje obojí, NL2SQL přijímá instrukce ke zdroji dat i relevantní obsah tématu.

Přidat instrukce podle témat

Ke každému podporovanému zdroji SQL dat můžete přidat až 1 milion znaků tématu.

  1. Otevřete svůj Fabric datový agent a vyberte zdroj SQL dat.

  2. V konfiguraci zdroje dat otevřete Témata zdroje dat.

  3. Zadejte své tematické instrukce. Použijte nadpisy Markdown k organizaci obsahu do různých témat.

  4. Uložte konfiguraci datového agenta.

  5. Testovací otázky, které se vztahují na jednotlivá témata, a otázky, které vyžadují více než jedno téma.

    Screenshot editoru témat datových zdrojů s instrukcemi k tématu Markdown a osnovou.

Struktura obsahu tématu

Používejte popisné nadpisy v Markdownu, aby datový agent našel správnou sekci pro otázku. Všechny pokyny k tématu mějte pod příslušným nadpisem.

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

Když se uživatel zeptá na odchod, datový agent může získat pokyny k udržení zákazníků, aniž by posílal nesouvisející pokyny k inventáři do NL2SQL.

Zkontrolujte načtená témata v krocích spuštění

Po otestování otázky si prohlédněte krok spuštění Open Data Source Topic a podívejte se, který obsah tématu datový agent vybral. Vstup ukazuje směrovou trasu a důvod, proč bylo téma vybráno. Výstup zobrazuje instrukce poskytnuté NL2SQL.

Screenshot kroku spuštění Open Data Source Topic zobrazující vybranou cestu směru a získané instrukce.

Osvědčené postupy

  • Používejte nadpisy, které odpovídají výrazům, které lidé používají ve svých otázkách.
  • Udržujte každé téma samostatné. Zahrňte relevantní definice podniků, tabulky, sloupce, vztahy, filtry a pravidla výpočtu pod stejnou tématickou nadpis.
  • Použijte podnadpisy k oddělení souvisejících scénářů v rámci širokého tématu.
  • Do instrukcí zdrojů dat vložte pravidla, která musí platit pro každou SQL otázku, místo abyste je opakovali ve více tématech.
  • Vyhněte se duplikaci nebo rozporu s pokyny napříč tématy a instrukcemi pro datové zdroje.
  • Testujte přímé otázky, alternativní formulace a otázky, které vyžadují obsah z více témat.

Související obsah

  • Last updated on