Verwenden Sie Themen in einem Fabric-Datenagenten (Vorschau)

Durch die Verwendung von Themen können Sie große, themenbasierte Anweisungen bereitstellen, die einem Fabric-Datenagenten helfen, SQL zu generieren. Anstatt mit jeder Frage alle Themeninhalte zu senden, durchsucht der Data Agent die Inhalte und stellt dem NL2SQL-Tool nur die für die Frage relevanten Teile zur Verfügung.

Verwenden Sie Themen, wenn Sie einen großen Satz an Anleitung haben, die Sie nach Themen organisieren können. Zum Beispiel können Sie Abschnitte für Vertrieb, Lagerbestand und Kundenbindung erstellen und dann die Geschäftsdefinitionen und Abfragehinweise bereitstellen, die für jedes Thema gelten.

Note

Themen sind in der Vorschau und nur für SQL-Datenquellen im Vorschau-Runtime verfügbar.

Themen und Anleitungen zur Datenquelle

Themen und Datenquellenanweisungen bieten unterschiedliche Arten von Kontext zu Werkzeugen zur Abfragegenerierung:

Konfiguration Wie der Datenagent es nutzt Wann wird es verwendet?
Themen Der Datenagent durchsucht die Themeninhalte und sendet die entsprechenden Abschnitte an NL2SQL. Verwenden Sie große Anweisungen, die Sie in Fächer unterteilen können und die Sie nur benötigen, wenn eine Frage ein Thema betrifft.
Anweisungen zur Datenquelle Der Data Agent sendet die Anweisungen jedes Mal an das Query-Generierungstool, wenn es die Datenquelle verwendet. Verwenden Sie Regeln und Kontext, die für jede Frage, die an die Datenquelle gesendet wird, gelten müssen.

Zum Beispiel kann man eine organisationsweite Definition für das Geschäftsjahr in die Anweisungen der Datenquellen einbauen, wenn jede Abfrage sie verwenden muss. Fügen Sie detaillierte Leitlinien zur Berechnung der Kundenbindung in ein Thema ein, wenn diese nur für Fragen zur Kundenbindung benötigt wird.

Du kannst Themen und Datenquellenanleitungen zusammen verwenden. Wenn eine Frage beides erfordert, erhält NL2SQL die Anweisungen zur Datenquelle und den relevanten Themeninhalt.

Themenbasierte Anweisungen hinzufügen

Du kannst bis zu 1 Million Zeichen Themeninhalt zu jeder unterstützten SQL-Datenquelle hinzufügen.

  1. Öffnen Sie Ihren Fabric-Datenagenten und wählen Sie eine SQL-Datenquelle aus.

  2. In der Datenquellen-Konfiguration: Open Data Source Topics.

  3. Geben Sie Ihre themenbezogenen Anweisungen ein. Verwenden Sie Markdown-Überschriften, um den Inhalt in unterschiedliche Themen zu ordnen.

  4. Speichere die Konfiguration des Datenagenten.

  5. Teste Fragen, die auf einzelne Themen abgestimmt sind, und Fragen, die mehr als ein Thema erfordern.

    Screenshot des Datenquellen-Themen-Editors, der Markdown-Themenanweisungen und eine Gliederung zeigt.

Themeninhalte strukturieren

Verwenden Sie beschreibende Markdown-Überschriften, damit der Datenagent den richtigen Abschnitt für eine Frage finden kann. Bewahren Sie alle Anweisungen für ein Fach unter der entsprechenden Überschrift auf.

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

Wenn ein Nutzer nach Kundenabwanderung fragt, kann der Data Agent die Leitlinien zur Kundenbindung abrufen, ohne die nicht relevanten Leitlinien zum Inventar an NL2SQL zu senden.

Überprüfen Sie abgerufene Themen in Ausführungsschritten

Nachdem Sie eine Frage getestet haben, überprüfen Sie den Ausführungsschritt Open Data Source Topic, um zu sehen, welchen Themeninhalt der Data Agent ausgewählt hat. Die Eingabe zeigt den Überschriftspfad und den Grund für die Auswahl des Themas. Die Ausgabe zeigt die an NL2SQL bereitgestellten Befehle.

Screenshot des Open Data Source Topic-Laufschritts, der den ausgewählten Überschriftenpfad und die abgerufenen Anweisungen zeigt.

Bewährte Methoden

  • Verwenden Sie Überschriften, die zu den Begriffen passen, die Menschen in ihren Fragen verwenden.
  • Halten Sie jedes Thema in sich geschlossen. Fügen Sie die relevanten Geschäftsdefinitionen, Tabellen, Spalten, Beziehungen, Filter und Berechnungsregeln unter derselben Themenüberschrift ein.
  • Verwenden Sie Unterüberschriften, um verwandte Szenarien innerhalb eines breiten Themas zu trennen.
  • Setze Regeln, die auf jede SQL-Frage gelten müssen, in die Datenquellenanweisungen, anstatt sie in mehreren Themen zu wiederholen.
  • Vermeiden Sie es, Anweisungen über Themen und Datenquellen hinweg zu duplizieren oder zu widersprechen.
  • Teste direkte Fragen, alternative Formulierungen und Fragen, die Inhalte aus mehreren Themen erfordern.

Verwandte Inhalte

  • Last updated on