Χρήση θεμάτων σε έναν παράγοντα δεδομένων Fabric (έκδοση προεπισκόπησης)

Χρησιμοποιώντας θέματα, μπορείτε να παρέχετε μεγάλες οδηγίες βασισμένες σε θέματα που βοηθούν έναν παράγοντα δεδομένων Fabric να δημιουργήσει SQL. Αντί να στέλνει όλο το περιεχόμενο του θέματος με κάθε ερώτηση, ο πράκτορας δεδομένων αναζητά το περιεχόμενο και παρέχει στο εργαλείο NL2SQL μόνο τα μέρη που σχετίζονται με την ερώτηση.

Χρησιμοποιήστε θέματα όταν έχετε ένα μεγάλο σύνολο οδηγιών που μπορείτε να οργανώσετε ανά θέμα. Για παράδειγμα, μπορείτε να δημιουργήσετε ενότητες για πωλήσεις, απόθεμα και διατήρηση πελατών και, στη συνέχεια, να παρέχετε τους ορισμούς της επιχείρησης και τις οδηγίες ερωτημάτων που ισχύουν για κάθε θέμα.

Σημείωμα

Τα θέματα βρίσκονται σε προεπισκόπηση και είναι διαθέσιμα μόνο για προελεύσεις δεδομένων SQL κατά τον χρόνο εκτέλεσης προεπισκόπησης.

Θέματα και οδηγίες προέλευσης δεδομένων

Τα θέματα και οι οδηγίες προέλευσης δεδομένων παρέχουν διαφορετικά είδη περιβάλλοντος στα εργαλεία δημιουργίας ερωτημάτων:

Διαμόρφωση Πώς το χρησιμοποιεί ο πράκτορας δεδομένων Πότε να χρησιμοποιηθεί
Θέματα Ο πράκτορας δεδομένων αναζητά το περιεχόμενο του θέματος και στέλνει τις σχετικές ενότητες στην NL2SQL. Χρησιμοποιήστε το για μεγάλες οδηγίες που μπορείτε να χωρίσετε σε θέματα και που χρειάζεστε μόνο όταν μια ερώτηση σχετίζεται με ένα θέμα.
Οδηγίες προέλευσης δεδομένων Ο παράγοντας δεδομένων στέλνει τις οδηγίες στο εργαλείο δημιουργίας ερωτημάτων κάθε φορά που χρησιμοποιεί την προέλευση δεδομένων. Χρησιμοποιήστε το για κανόνες και περιβάλλον που πρέπει να ισχύουν για κάθε ερώτηση που αποστέλλεται στην προέλευση δεδομένων.

Για παράδειγμα, βάλτε έναν ορισμό οικονομικού έτους σε ολόκληρο τον οργανισμό στις οδηγίες προέλευσης δεδομένων, εάν κάθε ερώτημα πρέπει να τον χρησιμοποιεί. Βάλτε λεπτομερείς οδηγίες για τον υπολογισμό της διατήρησης πελατών σε ένα θέμα διατήρησης πελατών, εάν οι οδηγίες χρειάζονται μόνο για ερωτήσεις σχετικά με τη διατήρηση.

Μπορείτε να χρησιμοποιήσετε θέματα και οδηγίες προέλευσης δεδομένων μαζί. Όταν μια ερώτηση απαιτεί και τα δύο, η NL2SQL λαμβάνει τις οδηγίες της πηγής δεδομένων και το σχετικό περιεχόμενο του θέματος.

Προσθήκη οδηγιών βάσει θέματος

Μπορείτε να προσθέσετε έως και 1 εκατομμύριο χαρακτήρες περιεχομένου θέματος σε κάθε υποστηριζόμενη προέλευση δεδομένων SQL.

  1. Ανοίξτε τον παράγοντα δεδομένων Fabric και επιλέξτε μια προέλευση δεδομένων SQL.

  2. Στη ρύθμιση παραμέτρων προέλευσης δεδομένων, ανοίξτε τα Θέματα προέλευσης δεδομένων.

  3. Εισαγάγετε τις οδηγίες που βασίζονται σε θέματα. Χρησιμοποιήστε επικεφαλίδες Markdown για να οργανώσετε το περιεχόμενο σε ξεχωριστά θέματα.

  4. Αποθηκεύστε τη ρύθμιση παραμέτρων του παράγοντα δεδομένων.

  5. Δοκιμάστε ερωτήσεις που αντιστοιχούν σε μεμονωμένα θέματα και ερωτήσεις που απαιτούν περισσότερα από ένα θέματα.

    Στιγμιότυπο οθόνης του προγράμματος επεξεργασίας θεμάτων προέλευσης δεδομένων που εμφανίζει οδηγίες θέματος Markdown και μια διάρθρωση.

Δομή περιεχομένου θέματος

Χρησιμοποιήστε περιγραφικές επικεφαλίδες Markdown, ώστε ο παράγοντας δεδομένων να μπορεί να βρει τη σωστή ενότητα για μια ερώτηση. Κρατήστε όλες τις οδηγίες για ένα θέμα κάτω από την αντίστοιχη επικεφαλίδα.

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

Όταν ένας χρήστης ρωτά για την ανατροπή, ο πράκτορας δεδομένων μπορεί να ανακτήσει την καθοδήγηση διατήρησης πελατών χωρίς να στείλει την άσχετη καθοδήγηση αποθέματος στην NL2SQL.

Αναθεώρηση ανακτημένων θεμάτων σε βήματα εκτέλεσης

Αφού δοκιμάσετε μια ερώτηση, εξετάστε το βήμα εκτέλεσης του θέματος "Άνοιγμα αρχείου προέλευσης δεδομένων " για να δείτε ποιο περιεχόμενο θέματος επέλεξε ο παράγοντας δεδομένων. Η είσοδος δείχνει τη διαδρομή της επικεφαλίδας και τον λόγο για τον οποίο επιλέχθηκε το θέμα. Η έξοδος δείχνει τις οδηγίες που παρέχονται στην NL2SQL.

Στιγμιότυπο οθόνης του βήματος εκτέλεσης του Open Data Source Topic που εμφανίζει την επιλεγμένη διαδρομή κατεύθυνσης και τις οδηγίες που ανακτήθηκαν.

Βέλτιστες πρακτικές

  • Χρησιμοποιήστε επικεφαλίδες που ταιριάζουν με τους όρους που χρησιμοποιούν οι χρήστες στις ερωτήσεις τους.
  • Κρατήστε κάθε θέμα αυτοτελές. Συμπεριλάβετε τους σχετικούς ορισμούς επιχειρήσεων, πίνακες, στήλες, σχέσεις, φίλτρα και κανόνες υπολογισμού κάτω από την ίδια επικεφαλίδα θέματος.
  • Χρησιμοποιήστε υπότιτλους για να διαχωρίσετε σχετικά σενάρια σε ένα ευρύ θέμα.
  • Τοποθετήστε κανόνες που πρέπει να ισχύουν για κάθε ερώτηση SQL στις οδηγίες προέλευσης δεδομένων αντί να τους επαναλαμβάνετε σε πολλά θέματα.
  • Αποφύγετε την αντιγραφή ή την αντίφαση των οδηγιών σε θέματα και οδηγίες προέλευσης δεδομένων.
  • Δοκιμάστε άμεσες ερωτήσεις, εναλλακτικές φράσεις και ερωτήσεις που απαιτούν περιεχόμενο από πολλά θέματα.

Σχετικό περιεχόμενο

  • Last updated on