Bir Fabric veri ajanında konuları kullanın (önizleme)

Konuları kullanarak, bir Fabric veri ajanının SQL oluşturmasına yardımcı olan büyük, konu tabanlı talimatlar sağlayabilirsiniz. Her soru için tüm konu içeriğini göndermek yerine, veri ajanı içeriği arar ve NL2SQL aracına sadece soruya ilişkin kısımları sağlar.

Konulara göre düzenleyebileceğiniz büyük bir rehberlik setiniz olduğunda konuları kullanın. Örneğin, satış, envanter ve müşteri tutumu için bölümler oluşturabilir ve ardından her konuya uygulanan iş tanımları ve sorgu rehberliğini sağlayabilirsiniz.

Note

Konular önizleme aşamasında ve yalnızca önizleme çalışma zamanında SQL veri kaynakları için kullanılabilir.

Konular ve veri kaynağı talimatları

Konular ve veri kaynağı talimatları, sorgu oluşturma araçlarına farklı türde bağlam sağlar:

Configuration Veri ajanı bunu nasıl kullanıyor? Ne zaman kullanılır?
Konu başlıkları Veri ajanı konu içeriğini arar ve ilgili bölümleri NL2SQL'e gönderir. Konulara ayırabileceğiniz ve sadece bir soru bir konuya bağlı olduğunda ihtiyacınız olan büyük talimatlar için kullanın.
Veri kaynağı yönergeleri Veri ajanı, veri kaynağını her kullandığında sorgu oluşturma aracına talimatları gönderir. Veri kaynağına gönderilen her soruya uygulanması gereken kurallar ve bağlam için kullanım.

Örneğin, her sorgu kullanmak zorundaysa, veri kaynağı talimatlarına organizasyon çapında bir mali yıl tanımı ekleyin. Müşteri tutumu konusuna müşteri tutumu hesaplama için ayrıntılı rehberlik ekleyin, eğer rehberlik sadece tutumla ilgili sorular için gerekiyorsa.

Konuları ve veri kaynağı talimatlarını birlikte kullanabilirsiniz. Bir soru her ikisini de gerektirdiğinde, NL2SQL veri kaynağı talimatlarını ve ilgili konu içeriğini alır.

Konu tabanlı talimatlar ekleyin

Her desteklenen SQL veri kaynağına 1 milyon karaktere kadar konu içeriği ekleyebilirsiniz.

  1. Fabric veri ajanınızı açın ve bir SQL veri kaynağı seçin.

  2. Veri kaynağı yapılandırmasında, Veri kaynağı konuları seçeneğini açın.

  3. Konu tabanlı talimatlarınızı girin. İçeriği farklı konulara düzenlemek için Markdown başlıklarını kullanın.

  4. Veri ajanı yapılandırmasını kaydet.

  5. Bireysel konulara ve birden fazla konuya ihtiyaç duyan sorulara uygun test soruları.

    Markdown konu talimatlarını ve bir taslağı gösteren veri kaynağı konu düzenleyicisinin ekran görüntüsü.

Konu içeriğini yapılandırın

Veri ajanının bir soru için doğru bölümü bulabilmesi için tanımlayıcı Markdown başlıkları kullanın. Bir konu için tüm rehberlikleri ilgili başlık altında sakla.

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

Bir kullanıcı müşteri kaybı hakkında soru sorduğunda, veri aracısı alakasız envanter rehberini NL2SQL'e göndermeden müşteri elde tutma rehberini alabilir.

Alınan konuları koşu adımlarında gözden geçir

Bir soruyu test ettikten sonra, veri ajanının seçtiği konu içeriğini görmek için Open Data Source Topic çalıştırma adımını gözden geçirin. Girdi, başlık yolunu ve konunun neden seçildiğini gösterir. Çıktı, NL2SQL'e verilen talimatları gösterir.

Açık Veri Kaynağı Konu çalıştırma adımının ekran görüntüsü, seçilen başlık yolunu ve alınan talimatları gösteriyor.

En iyi uygulamalar

  • İnsanların sorularında kullandığı terimlerle eşleşen başlıklar kullanın.
  • Her konuyu bağımsız tutun. İlgili iş tanımlarını, tabloları, sütunları, ilişkileri, filtreleri ve hesaplama kurallarını aynı konu başlığı altında ekleyin.
  • Alt başlıklar kullanarak ilgili senaryoları geniş bir konu içinde ayırın.
  • Her SQL sorusuna uygulanması gereken kuralları veri kaynağı talimatlarına koyun, onları birden fazla konuda tekrarlamak yerine.
  • Konular ile veri kaynağı yönergeleri arasında yönergelerin yinelenmesinden veya birbiriyle çelişmesinden kaçının.
  • Doğrudan soruları, alternatif ifadeleri ve birden fazla konudan içerik gerektiren soruları test edin.

İlgili içerik

  • Last updated on