トピックを使うことで、FabricのデータエージェントがSQLを生成するのを助ける大規模なトピックベースの指示を提供できます。 すべてのトピックコンテンツを質問ごとに送るのではなく、データエージェントはその内容を検索し、質問に関連する部分のみをNL2SQLツールに提供します。
トピックごとに整理できる豊富なガイドがあれば、トピックを使いましょう。 例えば、売上、在庫、顧客維持のセクションを作成し、それぞれのテーマに適用されるビジネス定義やクエリのガイダンスを提供することができます。
Note
トピックはプレビュー中で、 プレビューランタイムのSQLデータソースのみが利用可能です。
トピックとデータソースの指示
トピックやデータソースの指示は、クエリ生成ツールにさまざまなコンテキストを提供します:
| コンフィギュレーション | データエージェントがそれをどのように使用するか | いつ使用するか |
|---|---|---|
| トピック | データエージェントはトピック内容を検索し、関連するセクションをNL2SQLに送信します。 | テーマごとに分けられる大きな指示書は、質問がテーマに関連している場合にのみ必要です。 |
| データ ソースの説明書 | データエージェントはデータソースを使用するたびにクエリ生成ツールに指示を送信します。 | データソースに送られるすべての質問に適用されるルールと文脈を活用してください。 |
例えば、すべてのクエリが使わなければならない場合、組織全体の会計年度定義をデータソースの指示に含めることができます。 顧客維持率の計算に関する詳細なガイダンスを顧客維持に関する質問だけに適用する場合は、そのガイダンスを顧客維持トピックに盛り込んでください。
トピックとデータソースの指示を組み合わせて使うことができます。 問題が両方を必要とする場合、NL2SQLはデータソースの指示と関連するトピック内容を受け取ります。
トピックベースの指示を追加してください
サポートされた各SQLデータソースには最大100万文字のトピックコンテンツを追加できます。
Fabricのデータエージェントを開き、SQLデータソースを選択します。
データソースの設定では、 データソースのトピックをオープンにします。
トピックベースの指示を入力してください。 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に提供された命令を示します。
ベスト プラクティス
- 質問で使われる用語に合った見出しを使いましょう。
- 各トピックは自己完結型にまとめておきましょう。 関連するビジネス定義、テーブル、列、関係、フィルター、計算ルールを同じトピック見出しの下に含めてください。
- サブヘッドを使って、広いトピック内の関連シナリオを区切ってください。
- 複数のトピックで繰り返すのではなく、すべてのSQL質問に適用されるルールをデータソースの指示に設けましょう。
- トピックやデータソースの指示を重複したり矛盾させたりしないでください。
- 直接的な質問、代替表現、複数のトピックの内容を必要とする問題をテストしましょう。