質問テンプレート、用語、ビジネスロジックを設定して LLM のドメイン知識を拡張します。これにより、ビジネス要件を理解し、正確なデータクエリコードを生成するモデルの能力が大幅に向上します。
概要
ChatBI は、大規模言語モデル (LLM) を使用して自然言語の質問を理解し、SQL クエリを生成します。LLM は強力な汎用能力を持ちますが、ビジネス固有のシナリオで高い精度を実現するには、追加のドメイン知識が必要です。ナレッジベースは、この目的のために設計されたコア機能です。ナレッジベースでは、[Question Template]、[Term Management]、[Business Logic]という 3 種類のオブジェクトをサポートしています。
オブジェクトタイプ | 解決する課題 | 典型的なユースケース |
質問テンプレート | 繰り返し発生する分析クエリに対して迅速な応答を可能にします | 高頻度のクエリ (「店舗別の月間売上ランキング」など)、複雑な複数テーブルの結合、および正確なフィールドマッピングが必要なシナリオ |
用語管理 | 業界固有およびビジネス固有の語彙を正確に認識できるようにします | 略語 (例：前月比の「MoM」や前年比の「YoY」)、多言語の用語、および同義語のマッピング |
ビジネスロジック | ビジネスルールと計算方法を標準化します | ビジネス指標の定義 (「有効な注文とは、注文額が 0 より大きく、ステータスが支払い済みであること」など)、およびデータフィルタリングルール |
機能へのアクセス
ChatBI ポータルにアクセスします。
Alibaba Cloud にログインし、 ChatBI インテリジェントデータインサイトページを開きます。データセットやサーバーレスリソースグループなど、 DataWorks リソースのリージョンに一致するアクセスポイントを選択します。
左側のナビゲーションペインで、ナレッジベース
をクリックしてナレッジベースページに移動します。
ナレッジベースの設定
ChatBI のナレッジベースでは、[Question Template]、[Term Management]、[ビジネスロジック]というオブジェクトを管理します。
質問テンプレートの設定
ナレッジベースページに移動し、Question Template タブをクリックします。質問テンプレートは 2 つの方法で追加できます。
UI からテンプレートを追加します。
ナレッジベースページで 作成 をクリックし、[質問テンプレートの作成] ページを開きます。
質問テンプレートのパラメーターを設定します。
パラメーター
説明
[Question]
セッションでよく使われる質問を定義します。例：
店舗 A における商品 B の月間売上トレンド。質問では、
${parameter_name}形式の変数を使用できます。変数を使用する場合は、[パラメーター] フィールドに列挙値またはサンプル値の指定が必要です。例：Monthly sales trend of ${commodityName} in ${shopName}.[SQL]
質問に基づいて、正確で実行可能な SQL クエリを入力します。質問に
${parameter_name}が含まれている場合、SQL にも同じパラメーター名を含める必要があります。例：SELECT shop_name, commodity_name, sales, month FROM ads_order_table WHERE shop_Name = ${shopName} AND commodity_Name = ${commodityName} ORDER BY month;[パラメータ]
質問と SQL に
${parameter_name}が含まれている場合は、パラメーターの列挙値またはサンプル値を指定します。例：${parameter_name}: ["value1","value2","value3"][データセット]
この質問テンプレートが適用されるデータセットを指定します。空のままにすると、テンプレートはグローバルに適用されます。
設定が完了したら、保存 をクリックします。
ローカルファイルから一括インポートします。
ナレッジベースページで、Import and Add をクリックします。
インポートダイアログボックスで、テンプレートのダウンロード をクリックします。テンプレートファイルで、Question Template、[テンプレートスクリプト]、テンプレートパラメーター、および データセット の列に入力します。パラメーターは UI 設定で使用されるものと同じです。
ローカルファイルをドラッグアンドドロップするか、ダイアログボックスの [+] をクリックしてインポートするファイルを選択します。
ファイルを追加したら、OK をクリックします。
推奨事項
高頻度の質問を優先：最も頻繁に尋ねられる上位 20 の質問を特定し、最初にそれらのテンプレートを設定することを推奨します。
パラメーターを使用して再利用性を向上：店舗名、商品名、時間範囲などの可変部分を ${parameter_name} として定義します。これにより、1 つのテンプレートで複数の類似した質問をカバーできます。
保存前にSQLを検証：データセットに対して SQL クエリを実行し、構文が正しく、結果が期待通りであることを確認することを推奨します。
用語管理の設定
ナレッジベースページに移動し、Term Management タबをクリックします。用語は 2 つの方法で追加できます。
UI から用語を追加します。
作成 をクリックし、[用語の作成] ページを開きます。
用語の主要なパラメーターを設定します。
パラメーター
説明
[Term]
ビジネスコミュニケーションや分析で使用される一般的または専門的な単語。例：前月比。
[エイリアス]
用語の同義語、略語、正式名称、または多言語翻訳。各エイリアスの後で Enter キーを押すと、複数のエイリアスを追加できます。
[データセット]
この用語が適用されるデータセットを指定します。空のままにすると、用語はグローバルに適用されます。
設定が完了したら、保存 をクリックします。
ローカルファイルから一括インポートします。
ナレッジベースページで、Import and Add をクリックします。
インポートダイアログボックスで、テンプレートのダウンロード をクリックします。テンプレートファイルで、Term、エイリアス、説明、および データセット の列に入力します。パラメーターは UI 設定で使用されるものと同じです。
ローカルファイルをドラッグアンドドロップするか、ダイアログボックスの [+] をクリックしてインポートするファイルを選択します。
ファイルを追加したら、OK をクリックします。
推奨事項
ビジネス固有の用語を優先：LLM が知らない可能性が高い業界用語、略語、社内コードネームの追加に重点を置くことを推奨します。
包括的なエイリアスシステムを構築：各用語について、その正式名称、略語、口語表現、その他の形式を設定します。たとえば、「前月比」のエイリアスには ["MoM", "Month over Month", "月次成長率"] などを含めることができます。
一般的な単語との競合を回避：「注文」や「ユーザー」などの一般的な単語は、特別なビジネス上の意味を持たない限り、用語として設定しないでください。
ビジネスロジックの設定
ナレッジベースページに移動し、ビジネスロジック タブをクリックします。ビジネスロジックは 2 つの方法で追加できます。
UI からビジネスロジックを追加します。
[追加] をクリックして、[ビジネスロジックの作成] ページを開きます。
ビジネスロジックの主要なパラメーターを設定します。
パラメーター
説明
[Business Concept]
ビジネスコミュニケーションや分析における一般的な概念の名前。例：有効な注文。
[Logic Explanation]
ビジネスコンセプトの定義。例：ord_cnt_1d > 0 は有効な注文を示します。
[データセット]
このビジネスロジックが適用されるデータセットを指定します。空のままにすると、ロジックはグローバルに適用されます。
[フィールド]
データセットを選択すると、データセット内のテーブルからフィールドを選択して、ビジネスコンセプトを物理的なテーブルとフィールドに関連付けることができます。
設定が完了したら、保存 をクリックします。
ローカルファイルから一括インポートします。
ナレッジベースページで、Import and Add をクリックします。
インポートダイアログボックスで、テンプレートのダウンロード をクリックします。テンプレートファイルで、Business Concept、Logic Explanation、[関連テーブルフィールド]、および データセット の列に入力します。パラメーターは UI 設定で使用されるものと同じです。
ローカルファイルをドラッグアンドドロップするか、ダイアログボックスの [+] をクリックしてインポートするファイルを選択します。
ファイルを追加したら、OK をクリックします。
推奨事項
主要なビジネス指標を定義：「有効な注文」、「アクティブユーザー」、「コンバージョン率」などの主要な KPI の計算ロジックをビジネスロジックとして設定することを推奨します。
ロジックの説明は具体的に：概念が何であるかだけでなく、それをどのように計算するかを説明します。例：「有効な注文 = valid_order_flag = 1 かつ sales_amount > 0」。
物理フィールドを関連付ける：ビジネスロジックに関連するすべてのフィールドを選択し、モデルがフィールド間の関係を理解できるようにします。
ナレッジベースの管理
ユーザーはナレッジベースのオブジェクトを編集および削除できます。
ナレッジベースオブジェクトの編集
左側のナビゲーションペインで、ナレッジベース をクリックしてナレッジベースページに移動します。
目的のオブジェクトタイプのタブで、操作 列の 編集 をクリックして編集ページを開きます。
パラメーターは、「ナレッジベースの設定」で説明されているものと同じです。
ナレッジベースオブジェクトの検索
各ナレッジベースタブの上部にある検索ボックスにキーワードを入力し、Enter キーを押してオブジェクトを検索します。
ナレッジベースオブジェクトをクリックして詳細を表示することもできます。
ナレッジベースオブジェクトの削除
対応するタブでナレッジベースオブジェクトを見つけ、操作 列の 削除 をクリックして、ナレッジベースからオブジェクトを削除します。