Gunakan topik dalam agen data Fabric (pratinjau)

Dengan menggunakan topik, Anda dapat menyediakan instruksi besar berbasis topik yang membantu agen data Fabric menghasilkan SQL. Alih-alih mengirim semua konten topik dengan setiap pertanyaan, agen data mencari konten tersebut dan hanya menyediakan bagian yang relevan dengan alat NL2SQL.

Gunakan topik ketika Anda memiliki banyak panduan yang bisa diatur berdasarkan subjek. Misalnya, Anda dapat membuat bagian untuk penjualan, inventaris, dan retensi pelanggan, lalu menyediakan definisi bisnis dan panduan kueri yang berlaku untuk setiap subjek.

Note

Topik berada dalam pratinjau dan hanya tersedia untuk sumber data SQL pada runtime pratinjau.

Topik dan instruksi sumber data

Topik dan instruksi sumber data menyediakan berbagai jenis konteks untuk alat pembuatan kueri:

Configuration Bagaimana agen data menggunakannya Kapan harus menggunakannya
Topics Agen data mencari konten topik dan mengirimkan bagian yang relevan ke NL2SQL. Gunakan instruksi besar yang bisa Anda bagi menjadi subjek dan hanya diperlukan ketika pertanyaan berkaitan dengan subjek tersebut.
Instruksi sumber data Agen data mengirimkan instruksi ke alat pembuat kueri setiap kali menggunakan sumber data. Gunakan untuk aturan dan konteks yang harus berlaku untuk setiap pertanyaan yang dikirim ke sumber data.

Misalnya, masukkan definisi tahun fiskal seluruh organisasi dalam instruksi sumber data jika setiap kueri harus menggunakannya. Masukkan panduan rinci untuk menghitung retensi pelanggan dalam topik retensi pelanggan jika panduan tersebut hanya diperlukan untuk pertanyaan tentang retensi.

Anda dapat menggunakan topik dan instruksi sumber data secara bersamaan. Ketika sebuah pertanyaan membutuhkan keduanya, NL2SQL menerima instruksi sumber data dan isi topik yang relevan.

Tambahkan instruksi berbasis topik

Anda dapat menambahkan hingga 1 juta karakter konten topik ke setiap sumber data SQL yang didukung.

  1. Buka agen data Fabric Anda, dan pilih sumber data SQL.

  2. Dalam konfigurasi sumber data, buka topik sumber data.

  3. Masukkan instruksi berbasis topik Anda. Gunakan judul Markdown untuk mengatur konten ke dalam subjek yang berbeda.

  4. Simpan konfigurasi agen data.

  5. Pertanyaan tes yang sesuai dengan masing-masing topik dan pertanyaan yang memerlukan lebih dari satu topik.

    Tangkapan layar editor topik sumber data yang menunjukkan instruksi topik Markdown dan garis besar.

Struktur isi topik

Gunakan judul Markdown deskriptif agar agen data dapat menemukan bagian yang tepat untuk sebuah pertanyaan. Simpan semua panduan untuk suatu subjek di bawah judul yang sesuai.

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

Ketika pengguna menanyakan tentang churn, agen data dapat mengambil panduan retensi pelanggan tanpa harus mengirim panduan inventaris yang tidak terkait ke NL2SQL.

Tinjau topik yang diambil dalam langkah run

Setelah Anda menguji pertanyaan, tinjau langkah menjalankan Open Data Source Topic untuk melihat konten topik yang dipilih oleh agen data. Input menampilkan jalur judul dan alasan topik tersebut dipilih. Output menunjukkan instruksi yang diberikan ke NL2SQL.

Tangkapan layar dari langkah menjalankan Open Data Source Topic yang menunjukkan jalur heading yang dipilih dan instruksi yang diambil.

Praktik terbaik

  • Gunakan judul yang sesuai dengan istilah yang digunakan orang dalam pertanyaan mereka.
  • Pastikan setiap topik dapat berdiri sendiri. Sertakan definisi bisnis yang relevan, tabel, kolom, relasi, filter, dan aturan perhitungan di bawah judul topik yang sama.
  • Gunakan subjudul untuk memisahkan skenario terkait dalam topik yang luas.
  • Letakkan aturan yang harus berlaku untuk setiap pertanyaan SQL dalam instruksi sumber data daripada mengulangnya di beberapa topik.
  • Hindari menduplikasi atau bertentangan dengan panduan antar topik dan instruksi sumber data.
  • Uji pertanyaan langsung, frasa alternatif, dan pertanyaan yang membutuhkan konten dari berbagai topik.

Konten terkait

  • Last updated on