Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Korzystając z tematów, możesz dostarczać duże, tematyczne instrukcje, które pomagają agentowi danych Fabric generować SQL. Zamiast wysyłać całą treść tematu do każdego pytania, agent danych przeszukuje treść i udostępnia narzędziu NL2SQL tylko te części istotne dla pytania.
Używaj tematów, gdy masz szeroki zestaw wskazówek, które możesz uporządkować według przedmiotów. Na przykład możesz tworzyć sekcje dotyczące sprzedaży, zapasów i utrzymania klientów, a następnie przedstawić definicje biznesowe i wskazówki dotyczące zapytań odnoszące się do każdego tematu.
Uwaga / Notatka
Tematy są w podglądzie i dostępne tylko dla źródeł danych SQL w czasie podglądu.
Tematy i instrukcje dotyczące źródeł danych
Tematy i instrukcje dotyczące źródeł danych dostarczają różnych kontekstów narzędziom generującym zapytania:
| Configuration | Jak agent danych ich wykorzystuje | Kiedy należy go używać |
|---|---|---|
| Tematy | Agent danych przeszukuje treść tematu i przesyła odpowiednie sekcje do NL2SQL. | Używaj ich do dużych instrukcji, które można podzielić na tematy i których potrzebujesz tylko wtedy, gdy pytanie dotyczy konkretnego tematu. |
| Instrukcje dotyczące źródła danych | Agent danych wysyła instrukcje do narzędzia generującego zapytania za każdym razem, gdy korzysta ze źródła danych. | Użyj dla reguł i kontekstu, które muszą mieć zastosowanie do każdego pytania wysyłanego do źródła danych. |
Na przykład, umieść definicję roku fiskalnego całej organizacji w instrukcjach źródła danych, jeśli każde zapytanie musi z niej korzystać. Umieść szczegółowe wskazówki dotyczące obliczania retencji klientów w temacie dotyczącym retencji klientów, jeśli są one potrzebne tylko w kwestiach dotyczących retencji.
Możesz używać tematów i instrukcji dotyczących źródeł danych razem. Gdy pytanie wymaga obu tych informacji, NL2SQL otrzymuje instrukcje źródła danych oraz istotną treść tematu.
Dodaj instrukcje tematyczne
Możesz dodać do 1 miliona znaków treści tematycznych do każdego obsługiwanego źródła danych SQL.
Otwórz swojego agenta danych Fabric i wybierz źródło danych SQL.
W konfiguracji źródła danych otwórz Tematy źródła danych.
Wprowadź instrukcje dotyczące tematu. Użyj nagłówków Markdown, aby uporządkować treść na różne tematy.
Zapisz konfigurację agenta danych.
Pytania testowe, które pasują do poszczególnych tematów oraz pytania wymagające więcej niż jednego tematu.
Struktura treści tematycznych
Używaj opisowych nagłówków Markdown, aby agent danych mógł znaleźć właściwą sekcję dla pytania. Wszystkie wskazówki dotyczące danego tematu zachowaj pod odpowiednim nagłówkiem.
## 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.
Gdy użytkownik pyta o odpływ klientów, agent danych może pobrać wytyczne dotyczące utrzymania klientów bez wysyłania do NL2SQL niepowiązanych wytycznych dotyczących stanów magazynowych.
Przegląd pobranych wątków w etapach przebiegu
Po przetestowaniu pytania przejrzyj krok uruchomienia Open Data Source Topic, aby sprawdzić, którą treść tematu wybrał agent danych. Wejście pokazuje ścieżkę kursu oraz powód wybrania tematu. Wynik pokazuje instrukcje dostarczone dla NL2SQL.
Najlepsze rozwiązania
- Używaj nagłówków odpowiadających terminom używanym w pytaniach.
- Niech każdy temat stanowi odrębną całość. Uwzględnij odpowiednie definicje biznesowe, tabele, kolumny, relacje, filtry i reguły obliczeń pod tym samym nagłówkiem.
- Używaj podtytułów, aby oddzielić powiązane scenariusze w ramach szerokiego tematu.
- Umieść reguły, które muszą dotyczyć każdego pytania SQL w instrukcjach źródłowych danych, zamiast powtarzać je w wielu tematach.
- Unikaj powielania wskazówek lub ich wzajemnego wykluczania się w różnych tematach i instrukcjach dotyczących źródeł danych.
- Testuj pytania bezpośrednie, alternatywne sformułowania oraz pytania wymagające treści z różnych tematów.