AI/BI Genieスペースの設定と管理

この記事では、ビジネスユーザーがデータについて自然言語で質問するためのチャットインターフェースであるGenieスペースを設定および管理する方法について説明します。

技術要件と制限

Genie spacesの使用には、次の要件と制限が適用されます。

Unity Catalog: Genieスペースのデータは Unity Catalogに登録されている必要があります。
コンピュート: プロまたはサーバレス SQLウェアハウスを使用する必要があります。
スループット: 各ワークスペースは、すべての Genie spacesで 1 分あたり最大 20 の質問を処理できます。

必要な権限

Genie spacesを作成、編集、および使用するには、次の権限が必要です。

コンピュートの権限: Genieスペースの作成者、編集者、およびユーザーには、スペースに指定されたデフォルト SQLウェアハウスへの CAN USE アクセス権が必要です。作成者は、スペースを作成するときに Default SQLウェアハウスを選択します。権限を持つ任意のSQL ウェアハウスを選択できます。CAN RUN
データアクセス権限：スペースを操作するすべてのユーザーは、スペースで使用されるデータに対して少なくともSELECT権限が必要です。
Genieスペースの権限：ユーザーがGenieやスペースで使用されるデータを操作するには、Genieスペースでの実行可能（CAN RUN）権限が必要です。Genieスペースの権限と能力の完全なマッピングについては、「 GenieスペースのACL」を参照してください。

注：

データとコンピュートへのアクセスを設定するには、通常は管理者に制限されている上位の権限が必要です。「SQLウェアハウスの作成」と「Unity Catalogでの特権の管理」を参照してください。

Genie アクセスの管理

Genieは、アカウントレベルで有効にする必要があるパートナー主導の支援機能を使用します。アカウントのこれらの機能を管理する方法については、「 Databricks Assistant の使用」を参照してください。

注：

この機能へのアクセスを管理するには、アカウント管理者である必要があります。パートナーを利用した機能を無効にしても、 SQL エンタイトルメントを持つユーザーはサイドバーの Genie アイコンをクリックできますが、 Genie spacesにはアクセスできません。

新しいGenieスペースを作成する

Genie spaces 、データアナリストは、次の手順を実行して、ビジネスユーザー向けのドメイン固有の Genieスペースエクスペリエンスを作成できます。

サイドバーの 「Genie 」をクリックします。
画面の右上隅にある [新規 ] をクリックします。
[新規] ダイアログで、初期設定を選択します。オプションについては、次のように説明します。

タイトル: タイトルは、他のワークスペースオブジェクトとともにワークスペースブラウザーに表示されます。エンドユーザーがGenieスペースを見つけるのに役立つタイトルを選択します。
説明: ユーザーが Genieスペースを開くと、説明が表示されます。このテキスト領域を使用して、スペースの目的を説明します。説明フィールドは Markdown の書式設定をサポートしているため、テキストのスタイルを設定し、役立つコンテキストや参照へのリンクを提供できます。マークダウン構文の詳細については、このガイドを参照してください。
デフォルトウェアハウス: このコンピュートリソースは、SQL で生成されるGenie spaces ステートメントを強化します。エンドユーザーは、スペースを操作するためにこのウェアハウスにアクセスする必要があります。 Genieスペースでは、プロまたはサーバレスウェアハウスSQL使用できます。最適なパフォーマンスを得るために、 Databricks はサーバレス SQLウェアハウスを使用することをお勧めします。
テーブル: Genieスペースは 1 つ以上のテーブルに基づくことができます。[テーブルを追加] ボタンをクリックすると新しいダイアログが開き、追加するUnity Catalogテーブルを選択できます。
質問サンプル：質問サンプルは任意です。チャットに表示され、ユーザーが質問できるタイプの例を提供します。作成中に追加することも、後でスペースの設定から追加することもできます。

指示を与える

指示は、 Genieの応答をガイドして、特定のドメイン内の固有の専門用語、ロジック、および概念を処理できるようにするのに役立ちます。包括的な指示は、シームレスで直感的な Genieスペースエクスペリエンスに不可欠です。指示を入力するための指示ペインを開くには、Genieスペースのサイドバーの指示をクリックします。このペインを使用して、 一般的な命令、 SQL クエリの例、 および SQL 関数を追加します。

Genieスペースには、合計で最大100の指示を追加できます。次のものがカウントに寄与します。

一般的な命令のテキストのブロック全体が 1 つとしてカウントされます。
各 SQL クエリの例は 1 つとしてカウントされます。
各 SQL 関数は 1 つとしてカウントされます。

一般的な指示

Genieが従うべきビジネスまたは応答の好みを伝えるプレーンテキストの指示を提供します。指示を 1 つの包括的なメモとして書式設定したり、トピックごとに分類して整理しやすくしたりできます。

以下は、一般的な手順に含めることができる情報の例を示しています。

会社固有のビジネス情報:
- 「私たちの会計年度は2月に始まります」
値、エイリアス、または共通フィルタ：
- 「フィルターを適用するときは、常に小文字に変換し、like演算子を使用してください。」
- 「フィルター値のステータスに略語を使用してください。」
質問に答える関数を指定し、戻り値の指示を提供します。
- 「四半期には adventureworks.oneb.get_quarter(date) UDFを使用してください。 get_quarter() の出力は四半期で、1、2、3、または 4 のいずれかです。これを使用して、必要に応じてデータをフィルタリングします。

SQL クエリの例

SQL クエリの例は、Genie のトレーニングを支援するために準備する SQL クエリです。 Genieは、関連するクエリをインテリジェントに選択して、質問に答えるときに応答を生成するのに役立ちます。サンプルクエリを追加すると、データを使用して質問に答える方法をGenieに示すことができます。また、サンプルの質問を追加して、サンプルクエリが回答すると予想される質問の種類についてGenieに教えることもできます。 Genieは、一致する質問を受け取った場合、サンプルクエリを直接使用して回答を提供できます。同様の質問が返された場合は、サンプルクエリの手がかりを使用して、応答で提供されるSQLを構造化できます。次の例のように、組織とデータに固有のロジックを強調するサンプルの提供に重点を置きます。

  -- Return our current total open pipeline by region.
  -- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

SQL クエリにパラメーターを追加する

パラメーターを使用すると、実行時に置き換えられる特定の値のプレースホルダーを使用してクエリの例を記述できます。パラメーターを使用すると、 Genie ユーザーの質問から特定の入力を受け取り、サンプルクエリの構造を再利用して、検証済みの回答を信頼できる資産として提供できます。たとえば、前の SQL クエリを調整して、 o.forecastcategory 値でフィルター処理するパラメーターを含めると、クエリでさまざまな予測カテゴリにタグ付けされた営業案件に関する質問に対処できます。パラメーター化されたクエリを使用して、信頼できる資産としてラベル付けされた応答を生成する方法の詳細については、「AI/BI Genie spacesで信頼できる資産を使用する」を参照してください。

次のコードスニペットは、 o.forecastcategory 値のパラメーターを追加して変更した前の例を示しています。パラメーターは、名前付きパラメーターマーカーと同じ構文を使用します。名前付きパラメーターマーカーを参照してください。

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

クエリにパラメーターを追加するには:

クエリ内のパラメーターを配置する場所にカーソルを置きます。
[パラメーターを追加]をクリックし、新しいパラメーターを追加します。

これにより、デフォルト名が parameterの新しいパラメーターが作成されます。デフォルト名を変更するには、クエリエディタで名前を置き換えます。エディターにコロンの後にパラメーター名 (:parameter_name) を入力して、パラメーターを追加することもできます。

クエリーパラメータの編集

パラメーターを編集するには、次の手順を実行します。

パラメーター名の横にあるをクリックします。パラメーターの詳細ダイアログが表示され、次の構成オプションが含まれます。
- キーワード: クエリ内のパラメーターを表すキーワード。キーワードは、クエリ内のテキストを直接更新することによってのみ変更できます。
- 表示名: Genie がチャットエクスペリエンスで使用する人間が読める名前。 Genie がパラメーター化されたクエリを使用して応答を生成すると、表示名と関連する値が応答に含まれます。
- 種類: サポートされている種類には、 文字列、日付、 日付と時刻、数値があります。
  - デフォルト型は 文字列です。
  - 数値データ型では、10 進数と整数のどちらかを指定できます。デフォルトの数値型は 10 進数です。
  注：
  
  実際の入力値が選択したパラメーターの種類と一致しない場合、 Genie は入力値を誤った種類として扱い、結果が不正確になる可能性があります。
UI の別の部分をクリックして、ダイアログを閉じます。

SQL 関数

SQL 関数は、Unity Catalog に保存され、Genie が特定の質問に答えるために使用するカスタム関数です。 Genie は、これらの関数を呼び出して、ユーザー指定のパラメーターを挿入できますが、基になる SQL コンテンツにはアクセスできません。つまり、SQL関数は、Genieがアクセスまたは編集できないはずの複雑な引数や計算を含む一般的な特定の質問に答えるのに理想的です。 Unity Catalog に関数を登録する方法については、「 SQL テーブル関数を作成する」および「Unity Catalog でのユーザー定義関数 (UDF)」を参照してください。

Genieスペースをテストする

ほとんどのユーザーインタラクションはチャットウィンドウで行われます。スペースが思い通りに機能しているかどうかを知る最善の方法は、ビジネスユーザーが尋ねると予想される現実的な質問でスペースをテストすることです。

設定に入力したサンプルの質問は、チャットウィンドウに表示されます。これらのサンプル質問は、ユーザーが Genieスペースにどのような質問をできるかを理解するのに役立ちます。ユーザーが質問を入力するテキストフィールドは、画面の下部近くにあります。

回答はテキストフィールドの上に表示されます。ユーザーが質問を入力すると、左ペインのチャット履歴スレッドに保存されます。

新しいチャットを開始するには:

チャットアイコンをクリックして、チャットウィンドウを開きます。
「質問する...」テキスト入力フィールドに質問を入力します。新しい会話スレッドを開始するには、[ 新しいチャット] をクリックします。

回答を確認する

通常、回答は、質問に対する自然言語の回答と、関連する結果セットを示す表として提供されます。正確な回答構造は、質問によって異なります。すべての応答には、質問に答えるために生成された SQL クエリが含まれます。 [ 生成されたコードを表示 ] をクリックして、生成されたクエリを表示します。

応答の右下には、オプションのアクションが含まれています。レスポンスCSVをクリップボードにコピーし、CSVファイルとしてダウンロードし、Genieスペースの指示として追加し、回答に賛成票を投じるか、反対票を投じることができます。

表形式のデータを含む回答の後に、クイックアクションタイルのセットが表示されます。これらを使用して、ビジュアライゼーションを生成できます。

クエリ結果を取得した後に、視覚化を単語で記述して視覚化を生成することもできます。「ビジュアライゼーションの生成」を参照してください。

結果の書式設定

レスポンス内のテーブルの列をフォーマットするには、列ヘッダーのケバブメニューをクリックし、「 フォーマット 」をクリックして使用可能なオプションを表示します。書式設定オプションは、列のデータ型によって異なります。

結果セットのダウンロード

スペース利用者は、最大約1GBの結果データをCSVでダウンロードできます。最終的なファイルのダウンロードサイズは、最終的なファイルダウンロードよりも前のステップに 1 GB の制限が適用されるため、1 GB よりわずかに大きい場合と小さい場合があります。結果をダウンロードするには、応答のダウンロードアイコンをクリックします。

ビジュアライゼーションの生成

ユーザーは、チャットウィンドウを使用するか、応答に続く クイックアクション セクションに示されている推奨される視覚化のいずれかを使用して、視覚化を明示的に要求できます。 Genie は、応答の一部として視覚化を提供する場合があります。チャットウィンドウでビジュアライゼーションを編集できます。

次のグラフタイプがサポートされています。

エリア
棒
折れ線
円グラフ
散布図

ビジュアライゼーションを編集するには:

ビジュアライゼーションの右上隅にある [ 編集] アイコンをクリックします。ページの右側に編集ウィンドウが開きます。
[ビジュアライゼーション] ドロップダウンメニューを使用して、別のグラフタイプを選択します。
ほとんどのグラフタイプでは、[ X 軸 ] と [Y 軸 ] のドロップダウンメニューを使用して、各軸に表示される値を選択します。円グラフの場合は、[角度] ドロップダウンメニューを使用して、表示する列を選択します。
(オプション)配色をカスタマイズするには、[色] カテゴリの [+] をクリックします。
(オプション)ビジュアライゼーションにカーソルを合わせたときにツールヒントに表示するデータを選択するには、ツールヒント セクションの [+] をクリックします。

回答に対するフィードバックの提供

各AI/BI genie応答には、親指を立てる、または下げるフィードバックボタンが含まれています。 Databricks では、このメカニズムを使用して、ユーザーにスペースに関するフィードバックを提供するよう促すことを推奨しています。

クエリ結果を含む応答の場合、ユーザーはをクリックして、Genie スペースエディターによるレビューを要求できます。生成された回答の品質や正確性について疑問がある場合は、レビュー用にマークし、必要に応じてコメントや質問を追加できます。

ビジネスユーザーは、レビュー用にマークした質問の更新を [履歴 ] ページで確認できます。 Genieスペースに対して少なくともCAN MANAGE権限を持つユーザーは、特定の交換を確認し、リクエストにコメントし、応答を確認または修正できます。モニタリングページでフィードバックにアクセスし、リクエストを確認できます。その後、そのフィードバックを使用して、応答を調整し、スペースでの試行錯誤を行うことができます。「レビュー履歴とフィードバック」を参照してください。

レビュー履歴とフィードバック

Genieスペースは、1回限りのデプロイメントではなく、データチームとビジネスユーザーが知識を蓄積するための継続的なコラボレーションツールとなることを目的としています。ビジネスユーザーが答えを必要としている新しい質問を理解することは、知識の構築に不可欠です。履歴ページでは、個々の質問と回答、ユーザーから提供された「サムズアップ」または「サムズダウン」のフィードバック、レビュー対象としてマークされた質問を表示できます。履歴ページを開くには、 Genieスペースのサイドバーで「履歴」をクリックします。

履歴ページには、スペースで尋ねられたすべての質問と回答が表示されます。時間、評価、ユーザー、またはステータスで質問をフィルタリングできます。スペースをモニタリングすることで、 Genieスペースの編集者は、ビジネスユーザーから寄せられた問い合わせや、 Genieスペースがどのように応答したかを積極的に理解することができます。

Genieが苦手とする質問を特定することで、Genieスペースに対して具体的な指示を出し、回答を改善することができます。質問をクリックすると、質問と回答のテキストが開きます。このビューからチャットスレッド全体にアクセスすることもできます。

生成されたSQLを編集する

任意の応答で生成された SQL を確認して編集できます。 Genieスペースの作成者は通常、 Genieが誤った回答を生成しているかどうかを認識できる領域とデータを知っています。多くの場合、生成された SQL クエリを少し手動で調整するだけでエラーを修正できます。応答に対して生成された SQL を表示するには、 「生成されたコードを表示」をクリックしてクエリを調べます。

Space で以上の権限を持っている場合は、生成された SQLステートメントを編集して修正できます。CAN EDITGenie修正が完了したら、クエリを実行します。その後、それを指示として保存し、将来的にgenieに答え方を教えることができます。編集したクエリを保存するには、指示として保存 をクリックします。

Genieスペースのクローン

Genieスペースをクローンすると、すべてのセットアップコンテキストと手順を含むコピーが作成されます。これは、十分に開発されたスペースがあり、追加のテストのために新しいスペースを作成したり、元のスペースのコンテキストを再利用したりする場合に便利です。スペースをクローンすると、新しいスペースは元のスペースから独立しているため、元のスペースに影響を与えずに編集や調整を行うことができます。

次のエレメントは、クローン作成された Genieスペースにコピーされます。

テーブルと設定
一般的な指示
SQL クエリの例
SQL 関数

既存のチャットスレッドと履歴データは、新しいスペースにコピーされません。

Genieスペースをクローンするには、次の手順を実行します。

クローンを作成するGenieスペースを開きます。
スペースの右上隅にあるケバブメニューをクリックします。
[クローンを作成] をクリックします。
(オプション) 「クローン」 ダイアログで、クローン作成されたGenieスペースの新しい名前とワークスペース・フォルダの場所を指定します。
[クローン] をクリックして、新しいスペースを作成します。

スペース準備のベストプラクティス

ベストプラクティスに関するガイダンスと問題のトラブルシューティングのヘルプについては、「効果的な Genieスペースのキュレーション」を参照してください。

使用状況の監視

監査ログを使用して、Genieスペースの使用状況を監視できます。 AI/BI Genie イベントを見る