Käytä aiheita Fabric-dataagentissa (esikatselu)

Käyttämällä aiheita voit tarjota suuria, aihepohjaisia ohjeita, jotka auttavat Fabric-dataagenttia luomaan SQL:ää. Sen sijaan, että kaikki aiheen sisältö lähetettäisiin jokaisen kysymyksen mukana, dataagentti hakee sisällön ja tarjoaa NL2SQL-työkalulle vain ne osat, jotka liittyvät kysymykseen.

Käytä aiheita, kun sinulla on laaja valikoima ohjeita, jotka voit järjestää aiheen mukaan. Voit esimerkiksi luoda osioita myynnille, varastolle ja asiakasuskollisuudelle sekä antaa liiketoiminnan määritelmät ja kyselyohjeet, jotka koskevat kutakin aihetta.

Muistio

Aiheet ovat esikatseluvaiheessa ja saatavilla vain SQL-tietolähteille esikatseluajon.

Aiheet ja tietolähteiden ohjeet

Aiheet ja tietolähteiden ohjeet tarjoavat erilaisia kontekstia kyselyjen generointityökaluille:

Määritys Miten dataagentti käyttää sitä Milloin sitä kannattaa käyttää
Aiheet Dataagentti hakee aiheen sisällön ja lähettää asiaankuuluvat osiot NL2SQL:ään. Käytä suuria ohjeita, jotka voi jakaa aiheisiin ja joita tarvitsee vain, kun kysymys liittyy aiheeseen.
Tietolähdeohjeet Dataagentti lähettää käskyt kyselyjen generointityökalulle aina, kun se käyttää tietolähdettä. Käytä sääntöjä ja kontekstia, jotka koskevat jokaista tietolähteelle lähetettyä kysymystä.

Esimerkiksi laita organisaation kattava tilivuosimääritelmä tietolähdeohjeisiin, jos jokaisen kyselyn täytyy käyttää sitä. Laita yksityiskohtainen ohjeistus asiakasuskollisuuden laskemiseen asiakasuskollisuuden aiheeseen, jos ohjeistusta tarvitaan vain pysäyttämistä koskeviin kysymyksiin.

Voit käyttää aiheita ja tietolähdeohjeita yhdessä. Kun kysymys vaatii molempia, NL2SQL vastaanottaa tietolähteen ohjeet ja asiaankuuluvan aiheen sisällön.

Lisää aihekohtaiset ohjeet

Voit lisätä jopa miljoona merkkiä aihesisältöä jokaiseen tuettuun SQL-tietolähteeseen.

  1. Avaa Fabric-dataagentti ja valitse SQL-tietolähde.

  2. Tietolähdekonfiguraatiossa avaa Data source -aiheet.

  3. Syötä aihekohtaiset ohjeet. Käytä Markdown-otsikoita järjestääksesi sisällön eri aiheisiin.

  4. Tallenna dataagentin konfiguraatio.

  5. Testikysymykset, jotka vastaavat yksittäisiä aiheita ja kysymyksiä, jotka vaativat useamman aiheen.

    Kuvakaappaus tietolähteen aiheiden editorista, jossa näkyy Markdownin aiheohjeet ja luonnos.

Aiheen sisällön rakenne

Käytä kuvailevia Markdown-otsikoita, jotta dataagentti löytää oikean osan kysymykselle. Pidä kaikki ohjeet aiheesta vastaavan otsikon alla.

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

Kun käyttäjä kysyy poistumisesta, dataagentti voi hakea asiakasuskollisuusohjeistukset ilman, että se lähettää erilaista varastonhallintaohjeistusta NL2SQL:ään.

Kertaa haetut aiheet juoksuvaiheilla

Kun olet testannut kysymyksen, tarkista Open Data Source Topic -suoritusvaihe nähdäksesi, minkä aihesisällön dataagentti valitsi. Syöte näyttää otsikkopolun ja syyn, miksi aihe valittiin. Tuloste näyttää NL2SQL:lle annetut käskyt.

Kuvakaappaus Open Data Source Topic -suoritusvaiheesta, jossa näytetään valittu otsikkopolku ja haetut ohjeet.

Parhaat käytännöt

  • Käytä otsikoita, jotka vastaavat ihmisten kysymyksissä käyttämiä termejä.
  • Pidä jokainen aihe itsenäisenä. Sisällytä asiaankuuluvat liiketoimintamääritelmät, taulukot, sarakkeet, suhteet, suodattimet ja laskentasäännöt saman aiheen otsikon alle.
  • Käytä alaotsikoita erottaaksesi toisiinsa liittyvät tilanteet laajassa aiheessa.
  • Laita säännöt, jotka koskevat jokaista SQL-kysymystä, tietolähdeohjeisiin sen sijaan, että toistaisit niitä useissa aiheissa.
  • Vältä ohjeiden päällekkäisyyttä tai ristiriitaisia aiheiden ja tietolähdeohjeiden välillä.
  • Testaa suoria kysymyksiä, vaihtoehtoisia ilmaisuja ja kysymyksiä, jotka vaativat sisältöä useista aiheista.