AI/BI Genieスペースでの作業

プレビュー

この機能は パブリック プレビュー段階です。 「アカウントでGenie spacesを有効にする」を参照してください。

概要

データアナリストなどのドメイン専門家は、データセット、サンプル クエリ、テキスト ガイドラインを使用して Genieスペースを構成し、Genieがビジネス上の質問を分析クエリに変換する手助けをします。 セットアップ後、ビジネス ユーザーは質問をしたり、運用データを理解するための視覚化を生成したりできます。 genieのセマンティックナレッジは、データが変更されたり、ユーザーが新しい質問を投げかけたりしたときに、継続的に更新できます。DatabricksIQの詳細については、「DatabricksIQを活用した機能」を参照してください。

AI/BI genie 、注釈付きのテーブルと列から関連する名前と説明を選択して、自然言語の質問を同等の SQL クエリに変換します。 次に、生成されたクエリと結果テーブル (可能な場合) で応答します。 genie回答を生成できない場合は、回答を提供しようとするときに、フォローアップの質問を明確にすることができます。

使用例

さまざまな非技術者層に対応するために、さまざまなGenieスペースを作成できます。次のシナリオでは、考えられる 2 つのユース ケースについて説明します。

例 1: 営業案件の状態を視覚化する

営業マネージャーは、営業パイプラインのステージごとに、オープンおよびクローズ済みの商談の現在のステータスを取得したいと考えています。自然言語を使用してGenieスペースと対話し、視覚化を自動的に生成できます。

次のgifはこのインタラクションを示しています。

質問、回答、自動生成されたビジュアライゼーションを含むGif

例 2: 物流の追跡

物流会社は、さまざまな部門のビジネス ユーザーが業務および財務の詳細を追跡できるように、Genieスペースを使用したいと考えています。彼らは、出荷施設の管理者が出荷を追跡するためのGenieスペースと、財務担当役員が財務状況を把握するための Genieスペースを設置しました。

技術要件と制限

Genieスペースを使用する場合は、次の要件と制限が適用されます。

  • Unity Catalog:GenieスペースのデータをUnity Catalogに登録する必要があります

  • コンピュート: プロまたはサーバレス SQLウェアハウスを使用する必要があります。

  • ワークスペースの容量: 各ワークスペースには、最大 1,000 個の Genieスペースを含めることができます。

必要な権限

Genieスペースを作成、編集、使用するには、次の権限が必要です。

  • コンピュートの権限: Genieスペースの作成者、編集者、およびユーザーには、スペースに指定されたデフォルト SQLウェアハウスへの CAN USE アクセス権が必要です。 作成者は、スペースを作成するときに デフォルトの SQLウェアハウスを選択します。 CAN RUN権限を持つ任意のSQL ウェアハウスを選択できます。

  • データ アクセス権限：スペースを操作するすべてのユーザーは、スペースで使用されるデータに対して少なくともSELECT権限が必要です。

  • Genieスペースの権限：ユーザーがGenieやスペースで使用されるデータを操作するには、Genieスペースでの実行可能（CAN RUN）権限が必要です。Genieスペースの権限と能力の完全なマッピングについては、「 GenieスペースのACL」を参照してください。

注：

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

Genie spacesアカウントで を有効にする

注：

この機能を有効にするには、アカウント管理者である必要があります。

Genieは、アカウントレベルで有効にする必要があるパートナーを利用した機能を使用します。

  • アカウント管理者は、次の手順を完了することで、これらの機能を有効にできます。

    1. アカウントコンソールのサイドバーで、[設定]をクリックします。

    2. [機能有効化]タブをクリックします。

    3. [ パートナーが提供する AI 機能を有効にする ] オプションをオンにします。

    パートナーが提供する AI 機能は 、ワークスペースで Genie を有効にする前に、アカウント レベルで有効にする必要があります。

Genieを仕事のペースで有効に

Genieは、ワークスペースのプレビューページから管理され、デフォルトで オン に切り替えられています。 パートナーが提供する AI 機能がアカウントで有効になると、SQL エンタイトルメントを持つユーザーは Genie にアクセスできるようになります。

ワークスペース 管理者は、ワークスペース レベルで Genie アクセスを制御できます。 「Databricks プレビューの管理」を参照してください。

管理設定メニューの [プレビュー] メニュー項目を選択します。

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

ワークスペースで Genieスペースが有効になっている場合、データアナリストは次の手順を実行して、ビジネスユーザー向けのドメイン固有の Genieスペースエクスペリエンスを作成できます。

  1. サイドバーの「genie」をクリックします。

  2. 画面の右上隅にある [新規 ] をクリックします。

    以下のリストで説明されている新しいスペースダイアログ。

  3. [新規] ダイアログで、初期設定を選択します。オプションについては、次のように説明します。

  • タイトル: タイトルは、他のワークスペース オブジェクトとともにワークスペース ブラウザーに表示されます。エンドユーザーがGenieスペースを見つけるのに役立つタイトルを選択します。

  • 説明: ユーザーが Genieスペースを開くと、説明が表示されます。 このテキスト領域を使用して、スペースの目的を説明します。 説明フィールドは Markdown の書式設定をサポートしているため、テキストのスタイルを設定し、役立つコンテキストや参照へのリンクを提供できます。 マークダウン構文の詳細については、 このガイドを参照してください。

  • デフォルト ウェアハウス : このコンピュート リソースは、SQL Genieスペースで生成される ステートメントを強化します。エンドユーザーは、スペースを操作するためにこのウェアハウスにアクセスする必要があります。 Genieスペースでは、プロまたはサーバレス ウェアハウスSQL使用できます。最適なパフォーマンスを得るために、 Databricks はサーバレス SQLウェアハウスを使用することをお勧めします。

  • テーブル: Genieスペースは 1 つ以上のテーブルに基づくことができます。[テーブルを追加] ボタンをクリックすると新しいダイアログが開き、追加するUnity Catalogテーブルを選択できます。

  • 質問サンプル：質問サンプルは任意です。チャットに表示され、ユーザーが質問できるタイプの例を提供します。作成中に追加することも、後でスペースの設定から追加することもできます。

どのデータを使うべきですか?

に登録された 1 つ以上のテーブル (マネージドテーブル、外部テーブル、フォーリンテーブル、マテリアライズドビューなど) に基づいて新しい を作成できます。Genie spacesUnity CatalogAI/BI Genie は、Unity Catalog オブジェクトにアタッチされたメタデータを使用して応答を生成します。 適切に注釈が付けられたデータセットと、提供する特定の指示を組み合わせることで、エンドユーザーにポジティブなエクスペリエンスを提供するための鍵となります。

Databricksでは、次のことを推奨しています。

  • 分析用にデータをキュレーションする：ビューをレイヤー化して列数を減らし、ユースケース固有の情報を追加して回答の質を高めます。

  • Genieスペース内のテーブルと列の数を最小限に抑える: 特定のドメインの質問に答えるために必要なテーブルと列のみを取り込む。不要なテーブルや列があると、 genie が混乱を招いたり、誤った回答を出したり、エラーメッセージが表示されたりする可能性があります。

指示を与える

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

指示パネル

一般的な指示

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

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

  • 会社固有のビジネス情報:

    • 「私たちの会計年度は2月に始まります」

  • 値、エイリアス、または共通フィルタ：

    • 「フィルターを適用するときは、常に小文字に変換し、like演算子を使用してください。」

    • 「フィルター値のステータスに略語を使用してください。」

  • 質問に答える関数を指定し、戻り値の指示を提供します。

    • 「四半期には adventureworks.oneb.get_quarter(date) UDFを使用してください。 get_quarter() の出力は四半期で、1、2、3、または 4 のいずれかです。これを使用して、必要に応じてデータをフィルタリングします。

SQL クエリの例

SQLSQLクエリの例は、トレーニングする を支援するために準備するgenie クエリです。質問に回答するとき、 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スペースで信頼できる資産を使用する」を参照してください。

次のコード スニペットは、 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;

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

  1. クエリ内のパラメーターを配置する場所にカーソルを置きます。

  2. [パラメーターを追加]をクリックし、新しいパラメーターを追加します。

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

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

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

  1. パラメーター名の横にある歯車アイコンをクリックします パラメーターの詳細ダイアログが表示され、次の構成オプションが含まれます。

    • キーワード: クエリ内のパラメーターを表すキーワード。 これは、クエリ内のテキストを直接更新することによってのみ変更できます。

    • 表示名: genie チャット エクスペリエンスで使用する人間が判読できる名前。 genie がパラメータ化されたクエリを使用して応答を生成する場合、応答には表示名と関連する値が含まれます。

    • 種類: サポートされている種類には、 文字列、 日付、 日付と時刻、 数値があります。

      • デフォルト型は 文字列です。

      • 数値データ型では、10 進数と整数のどちらかを指定できます。デフォルトの数値型は 10 進数です。

      注：

      実際の入力値が選択したパラメーターの種類と一致しない場合、 genie は入力値を誤った種類として扱い、結果が不正確になる可能性があります。

  2. UI の別の部分をクリックして、ダイアログを閉じます。

SQL 関数

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

信頼できる資産

パラメータ化されたサンプルクエリまたは SQL 関数の正確なテキストを使用して応答を生成すると、 genie は応答を 信頼できる資産としてマークします。 信頼できるアセットは、結果の精度に対する追加の保証層をスペースのユーザーに伝えることを目的としています。 「AI/BI Genieスペースで信頼できるアセットを使用する」を参照してください。

Genieスペースでチャットする

ほとんどのGenieスペースインタラクションはチャットウィンドウで行われます。

以下の文章で説明されている、新しいチャットウィンドウ。

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

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

チャット履歴

チャット履歴のスレッドはユーザーごとに保存され、過去の質問や回答を参照することができます。ユーザーは、チャットスレッドから質問を再送信または修正することもできます。左ペインの新規チャットボタンをクリックすると、新しいスレッドが開始されます。

各チャットスレッドは、以前に尋ねられた質問に関するコンテキストを保持します。 これにより、ユーザーはフォローアップの質問をして、結果セットをさらに探索したり、焦点を合わせたりすることができます。

チャット履歴スレッドは無期限に保存され、スレッドまたはGenieスペースが削除されるまでアクセスできます。 CAN MANAGE以上の権限を持つユーザーは、スペース内のすべてのチャットを表示できます。

回答の構成

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

レスポンスの下にある一連のボタンを使用すると、さまざまなアクションを実行できます。 回答の品質を示すために賛成票または反対票を投じたり、GenieスペースでCAN EDIT権限以上のユーザーにレビューをリクエストしたりできます。 その他のオプションには、応答を命令として追加する、応答を再生成する、または回答の結果セットを生成するために使用された SQL コードを表示するなどがあります。

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

さまざまな視覚化オプションを提案するクイック アクション タイル。

クエリ結果を取得した後、言葉で説明することでビジュアライゼーション を生成することもできます。

結果の書式設定

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

通貨やパーセンテージなどの書式設定オプションを持つ数値列。

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

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

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

各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 genieを使用しません。

ベンチマークを使用すると、テスト問題のコレクションを実行し、その回答を使用して genieの精度を測定できます。 オプションで、予期される結果を返す SQL ステートメントを含めることができます。 ベンチマーク質問が実行されると、 genieの回答は SQL ステートメントによって提供される結果と比較され、正確性が採点されます。 SQLの回答が提供されていない場合、質問はレビュー対象としてマークされます。

「Genieスペースでのベンチマークの使用」を参照してください。

Genieスペースを共有する

重要

Genieスペースのユーザーは、データにアクセスするために自分の資格情報を使用する必要があります。 アクセスできないデータに関する質問は、空の回答を生成します。

Genieスペースのユーザーには、 Genieスペースにアタッチされたウェアハウスに対する使用可能（CAN USE）権限と、スペースに表示されるUnity Catalogオブジェクトに対するアクセス権限が必要です。「使用するデータ」を参照してください。

新しいGenieスペースは、デフォルトでユーザーフォルダに保存されます。他のワークスペース オブジェクトと同様に、それらは囲むフォルダーから権限を継承します。ワークスペース フォルダー構造を使用して、他のユーザーと共有できます。「ワークスペース オブジェクトをフォルダーに整理する」を参照してください。

特定の権限レベル（ CAN MANAGE 、 CAN EDIT 、 CAN RUN 、 CAN VIEWで共有する特定のユーザーまたはグループを指定することもできます。

特定のユーザーまたはグループと共有するには:

  1. [共有] をクリックします。

  2. スペースを共有するユーザーまたはグループを入力します。 次に、[ 追加 ] をクリックして、適切なアクセス許可レベルを設定します。

  3. SpaceGenie への共有可能なリンクを取得するには、[共有] ダイアログの下部にある [リンクをコピー] ボタンを使用します。特権ユーザーは、リンクをクリックして新しいタブでGenieを開き、質問することができます。

Genieスペースのクローン

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

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

  • テーブルと設定

  • 一般的な指示

  • SQL クエリの例

  • SQL 関数

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

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

  1. クローンを作成するGenieスペースを開きます。

  2. スペースの右上隅にある ケバブメニュー ケバブメニューをクリックします。

  3. [クローンを作成] をクリックします。

  4. (オプション) 「クローン」 ダイアログで、クローン作成されたGenieスペースの新しい名前とワークスペース・フォルダの場所を指定します。

  5. [クローン] をクリックして、新しいスペースを作成します。

プライバシーとセキュリティ

Q:Genieはどのモデルを使用していますか?

genie は Azure OpenAI モデルを使用します。

Q: モデルにはどのようなデータが送信されていますか?

Genieスペースは、メタデータと命令を使用して自然言語の質問に対する回答を生成します。 genie 行レベルのデータにはアクセスできません。

レスポンスを処理するために、 genie は以下を使用します。

  • ユーザーが送信した自然言語プロンプト

  • テーブルの名前と説明

  • 列のタイトルと説明

  • 一般的な指示

  • SQL クエリの例

  • SQL 関数

Q: Azure OpenAI はデータを収集しますか?

いいえ。Databricksは、MicrosoftがAzure OpenAIサービスに送信されたプロンプトやコンプリーションを保存しない、不正使用のモニタリングおよびヒューマンレビュープログラムの免除にオプトインしています。詳細については、 Microsoftのドキュメントを参照してください。

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

  • 構築する前に、スペースのユーザーが回答できるようにする明確に定義された一連の質問を設定します。

  • 回答の品質を確認するには、Genieスペースをテストします。モデルが期待どおりの回答を提供するかどうかを確認するには、次のことを試してください。

    • 提供した質問を言い換えてください。

    • データセットに関連するその他の質問をしてください。

  • 質問に対して期待通りの回答が得られるまで、 Genieスペースの指示を追加および調整します。

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