Gebruik onderwerpen in een Fabric data-agent (preview)

Door onderwerpen te gebruiken, kun je grote, onderwerpgebaseerde instructies geven die een Fabric-dataagent helpen SQL te genereren. In plaats van alle onderwerpen bij elke vraag te sturen, zoekt de dataagent door de inhoud en geeft de NL2SQL-tool alleen de delen die relevant zijn voor de vraag.

Gebruik onderwerpen wanneer je een grote set richtlijnen hebt die je per onderwerp kunt organiseren. Je kunt bijvoorbeeld secties maken voor verkoop, voorraad en klantbehoud, en vervolgens de bedrijfsdefinities en zoekopdrachten geven die op elk onderwerp van toepassing zijn.

Note

Onderwerpen zijn in preview en alleen beschikbaar voor SQL-databronnen in de preview-runtime.

Onderwerpen en instructies voor gegevensbronnen

Onderwerpen en instructies voor gegevensbronnen bieden verschillende soorten context voor tools voor het genereren van zoekopdrachten:

Configuration Hoe de dataagent het gebruikt Wanneer gebruikt u het?
Onderwerpen De dataagent doorzoekt de onderwerpinhoud en stuurt de relevante secties naar NL2SQL. Gebruik deze voor grote instructies die je in onderwerpen kunt verdelen en die je alleen nodig hebt als een vraag over een onderwerp gaat.
Instructies voor gegevensbron De dataagent stuurt de instructies naar de query-genererende tool telkens wanneer deze de databron gebruikt. Gebruik het voor regels en context die op elke vraag die naar de databron wordt gestuurd, van toepassing moeten zijn.

Zet bijvoorbeeld een organisatiebrede definitie van het fiscale jaar in de instructies voor databronnen als elke query deze moet gebruiken. Zet gedetailleerde richtlijnen voor het berekenen van klantbehoud in een klantretentieonderwerp als de richtlijnen alleen nodig zijn voor vragen over retentie.

Je kunt onderwerpen en databron-instructies samen gebruiken. Wanneer een vraag beide vereist, ontvangt NL2SQL de instructies voor de gegevensbron en de relevante onderwerpsinhoud.

Voeg onderwerpgebaseerde instructies toe

Je kunt tot 1 miljoen tekens aan onderwerpinhoud toevoegen aan elke ondersteunde SQL-databron.

  1. Open je Fabric data-agent en selecteer een SQL-databron.

  2. In de databronconfiguratie, open Data source topics.

  3. Voer je onderwerpgebaseerde instructies in. Gebruik Markdown-koppen om de inhoud in verschillende onderwerpen te organiseren.

  4. Sla de configuratie van de data-agent op.

  5. Test vragen die aansluiten bij individuele onderwerpen en vragen die meer dan één onderwerp vereisen.

    Screenshot van de Data source topics editor met Markdown-instructies en een overzicht.

Structuur van de onderwerpinhoud

Gebruik beschrijvende Markdown-koppen zodat de dataagent het juiste gedeelte voor een vraag kan vinden. Bewaar alle richtlijnen voor een onderwerp onder de bijbehorende kop.

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

Wanneer een gebruiker vraagt naar churn, kan de dataagent de klantretentie-richtlijnen opvragen zonder de niet-gerelateerde voorraadrichtlijnen naar NL2SQL te sturen.

Bekijk de opgehaalde onderwerpen in run steps

Nadat je een vraag hebt getest, bekijk je de stap Open Data Source Topic om te zien welke inhoud van het onderwerp de gegevensagent heeft geselecteerd. De invoer toont het koppad en de reden waarom het onderwerp is gekozen. De uitvoer toont de instructies die aan NL2SQL zijn geleverd.

Screenshot van de Open Data Source Topic-uitvoerstap die het geselecteerde koppad en de opgehaalde instructies toont.

Beste praktijken

  • Gebruik koppen die overeenkomen met de termen die mensen in hun vragen gebruiken.
  • Houd elk onderwerp op zichzelf staand. Neem de relevante bedrijfsdefinities, tabellen, kolommen, relaties, filters en rekenregels op onder dezelfde onderwerpskop.
  • Gebruik subkoppen om gerelateerde scenario's binnen een breed onderwerp te scheiden.
  • Zet regels die op elke SQL-vraag van toepassing moeten zijn in de instructies van de databron, in plaats van ze in meerdere onderwerpen te herhalen.
  • Vermijd het dupliceren of tegenstrijdigen van richtlijnen over onderwerpen en instructies voor gegevensbronnen.
  • Test directe vragen, alternatieve formuleringen en vragen die inhoud uit meerdere onderwerpen vereisen.

Verwante onderwerpen

  • Last updated on