AI/BI Genie 空間の設定と管理

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

技術的な要件と制限

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

• Unity カタログ: Genie 空間のデータは、Unity カタログに登録する必要があります。 Genie スペースには、最大 25 個のテーブルまたはビューを追加できます。
• 計算する： Genie スペースには、プロまたはサーバーレスの SQL ウェアハウスが必要です。 選択した倉庫に対する CAN USE 権限が少なくとも必要です。 このアクセス許可がない場合、領域の作成は失敗します。
• スループット： 各ワークスペースでは、Azure Databricks UI を使用してアクセスすると、すべての Genie スペースで 1 分あたり最大 20 個の質問を処理できます。
• 能力： Genie スペースごとに最大 10,000 個の会話をサポートでき、各会話には最大 10,000 件のメッセージを含めることができます。

必要なアクセス許可

Genie スペースを作成または編集するには、次のアクセス許可と権利が必要です。

• 権限: Databricks SQL ワークスペースの権限が必要です。 「エンタイトルメントを管理する」をご覧ください。
• コンピュート： 少なくとも 1 つのプロ版またはサーバーレス SQL ウェアハウスでアクセスを利用できる。
• データ アクセス:SELECT 領域で使用されるデータに対する特権。
• Genie スペース ACL: Genie 空間に対するアクセス許可を少なくとも CAN で編集できます。 Genie スペース作成者は、作成したスペースに対する CAN MANAGE アクセス許可を自動的に持ちます。 Genie スペースのACLを参照してください。

Genie アクセスの管理

Genie はパートナーを利用した AI 機能を使用します。この機能は、アカウントとワークスペースのレベルで有効にする必要があります。 アカウントのこれらの機能を管理する方法については、 パートナーを利用した AI 機能に関するページを参照してください。

Genie スペースを作成する

Genie スペースを作成するには:

1. サイドバーで Genie をクリックします。
2. 画面の右上隅にある [ 新規 ] をクリックします。
3. Genie 空間に含めるデータ ソースを選択します。 次に、[ 作成] をクリックします。

クエリ候補を確認する

空間のデータについて学習するために、Genie はワークスペース内の情報にアクセスして、テーブルとビジネス セマンティクス間のリレーションシップをより深く理解します。 空間にデータ資産を追加すると、Genie は、それらの資産に関連付けられている関連する一般的なワークスペース クエリを自動的に検索します。 ユーザー資格情報は、少なくとも CAN VIEW アクセス許可を持っている関連するクエリを検索するために使用されます。 検索でクエリが返された場合、[命令] パネルの [データ] タブに通知が表示されます。 [ 確認 ] をクリックして、提案されたクエリを表示します。

クエリ アクセス許可の詳細については、「 クエリ ACL」を参照してください。

[提案されたクエリの確認] ダイアログを使用して、提案されたクエリを確認、編集、受け入れる、または拒否します。 Genie 空間で少なくとも CAN EDIT アクセス権を持つ他のユーザーは、クエリ自体に対して少なくとも CAN VIEW アクセス権を持っている場合、クエリを確認できます。

1. Title テキストに質問が事前に入力されています。 [タイトル] フィールドに入力して、質問を修正または編集します。
2. [コード] フィールドには、推奨される SQL クエリの完全なテキストが含まれています。 このフィールドは編集できません。 クエリ全体を表示するには、...さらに多くの行 をクリックしてください。
3. クエリに対する十分なアクセス許可がある場合は、[ SQL クエリ ] をクリックしてクエリ 履歴 UI でクエリを開くことができます。 クエリ履歴を表示を参照してください。
4. クエリがスペースに関連しているかどうかを判断したら、[ 承諾 ] または [拒否 ] をクリックしてスペースに追加するか、それに応じて提案を無視します。
5. 他の候補をクリックして展開し、確認します。

受け入れられたクエリは、空間の SQL クエリ コンテキストに表示されます。 それらがスペースに追加されると、提案されたクエリと関連する質問が完全に編集可能になります。 SQL クエリと関数の例を追加するを参照してください。

推奨されるクエリが返されない場合:

• 関連するクエリに十分なアクセス権がない可能性があります。
• 関連するデータがない可能性があります。 含まれているテーブルに対してクエリが実行されていない場合、検索で結果が返されない可能性があります。
• Genie 空間とは無関係なクエリは考慮されません。 たとえば、含まれている資産に対して基本的な書き込み操作のみを実行するクエリは、Genie の関連する例とは見なされません。
• Genie では、スペースに追加されていないテーブルに対するクエリは推奨されません。 Genie 空間専用の結合テーブルまたはビューを作成したが、関連する Databricks SQL クエリは通常、別のソース テーブルに対して実行される場合、Genie はそれらのクエリを結果に返しません。

データ オブジェクトの管理

Genie 空間に含めるデータ オブジェクトを管理するには、[構成]、[>] の順にクリックします。 [ 追加 ] ボタンをクリックして、さらにテーブルを追加します。 表名の右側にある をクリックして、スペースから表を削除します。

ナレッジ ストアを構築する

ナレッジ ストアは、Genie によるデータの理解を向上させ、応答の精度を向上させる、精選されたセマンティック定義のコレクションです。 ナレッジ ストアを構築すると、ローカル メタデータをカスタマイズし、簡潔で構造化された手順を定義することで、スペースをキュレーションできます。 これには、1 つの Genie 空間をスコープとする変更が含まれています。 スペース作成者は、定義、説明、またはテーブルリレーションシップを編集および反復処理するために、基になるテーブルに対する書き込み権限を必要としません。 これらの入力は、Genie がデータを解釈し、より正確で関連性の高い回答を返すのに役立ちます。 より信頼性の高い Genie スペースについては、ナレッジ ストアの構築に関する記事を参照してください。

SQL の例と手順を追加する

サンプル SQL クエリ、Unity カタログ関数、プレーンテキスト命令を追加して、正確な応答を生成できます。 「構成>指示」をクリックします。 [SQL クエリ] タブを使用して、クエリと Unity カタログ関数を管理します。 [ テキスト ] タブを使用して、プレーンテキスト命令を追加します。

Genie スペースには、合計で最大 100 個の命令を追加できます。 命令の種類は、次の方法でカウントに影響します。

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

Genie 空間は、明確で正確なガイダンスに基づいて、一貫した予測可能な応答を提供することを目的としています。 Genie は非決定的な方法で動作するため、望ましくない応答のリスクを最小限に抑えるために、ガイダンスを競合またはあいまいな情報から解放することが重要です。 スペースを設定する場合、重要なタスクは、不整合を確認して解決することです。 これにより、信頼性の高い結果が得られます。

SQL クエリと関数の例を追加する

[SQL クエリ] タブを使用して、次の内容を追加します。

• クエリの例 (推奨): SQL クエリの例は、Genie が一般的なユーザーの質問に答える正しい SQL を生成するのに役立ちます。 クエリは静的またはパラメーター化できます。 SQL クエリの例ごとに、SQL を指定し、ユーザーの質問の最も一般的な言い回しをタイトルとして使用します。 これにより、Genie のプロンプトを例に一致させる機能が向上します。 Genie は、サンプル クエリを直接使用することも、そこから学習して同様の質問を処理することもできます。 パラメーター化されたクエリを使用すると、応答は 信頼済みとしてマークされます。 空間で CAN EDIT 権限を持つユーザーは、応答の生成に使用されるクエリを表示でき、トラブルシューティングと絞り込みを行うのに役立ちます。

• SQL 関数: 静的またはパラメーター化された SQL クエリでは回答できない質問については、Unity カタログにカスタム関数を登録できます。 関数はチーム間で共有でき、Genie が特定の質問に回答するために使用できます。 SQL 関数を使用して応答した応答は、 信頼済みとしてマークされます。 Genie 空間で SQL 関数を使用する方法の詳細については、 AI/BI Genie スペースでの信頼された資産の使用に関するページを参照してください。

Genie でサンプル クエリを使用する方法

クエリの例では、Genie で使用可能なデータを使用して質問に回答する方法を示します。 テキスト フィールドにサンプルの質問を入力し、その質問に回答する SQL クエリを入力します。 ユーザーが自然に質問する方法でサンプルの質問を記述します。 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 に追加のコンテキストを提供して、クエリの例が特に関連するタイミングを説明できます。

使用ガイダンスを追加するには:

1. [ 構成>Instructions>SQL クエリ ] をクリックして、クエリの例の一覧にアクセスします。
2. クエリの例をクリックします。
3. 画面の下部付近にある [ 使用ガイダンス ] をクリックします。
4. このサンプル クエリを使用する方法とタイミングの詳細を入力します。

Genie は SQL 関数をどのように使用しますか?

SQL 関数は、静的クエリまたはパラメーター化クエリではキャプチャできない複雑なロジックが質問に含まれている場合に便利です。 これらは Unity カタログに格納され、Genie がユーザー指定のパラメーターを使用して呼び出すことができます。 Genie は関数で使用される SQL を表示または変更できないため、このアプローチは、表示または変更すべきではないロジックに適しています。 Unity カタログでの関数の登録に関するガイダンスについては、Unity カタログでの SQL テーブル関数 と ユーザー定義関数 (UDF) の作成に関するトピックを参照してください。

手順を指定する

[ テキスト ] タブをクリックして、Genie がビジネスに関する特定の質問に回答する方法を理解するのに役立つプレーンテキストの指示を記述します。 手順を 1 つの包括的なメモとして書式設定したり、トピックごとに分類して組織を改善したりできます。

命令は、特定のドメイン内の一意の専門用語、ロジック、概念を処理できるように Genie の応答をガイドするのに役立ちます。 一般的なテキスト命令は、すべてのプロンプトに適用されます。 命令がプロンプトのサブセットにのみ関連する場合は、クエリまたは関数の例として含めるか、関連するテーブルにコメントまたはメタデータとして文書化する必要があります。 テキスト命令は、グローバルに適用する必要があり、他の形式に収まらないコンテキスト のみを 対象としています。

次の例には、一般的な手順に含めることができる情報が含まれています。

- **Company-specific business information**:
  - Fiscal year starts in February, for example fiscal year 26 or FY26 is February 1, 2026 through January 31, 2027
- **Formatting**:
  - Always respond in Spanish
  - If no other specification exists, round all decimals to two places
  - Omit commas in results for any column including "Id" or "id" or "\_id"

設定を構成する

追加の設定を構成して、Genie スペースをカスタマイズします。 [ 構成>Settings ] をクリックして、次の設定にアクセスします。

• タイトル: タイトルは、他のワークスペース オブジェクトと共にワークスペース ブラウザーに表示されます。 エンド ユーザーが Genie スペースを見つけやすくするタイトルを選択します。
• 既定のウェアハウス: このコンピューティング リソースは、Genie スペースで生成された SQL ステートメントを利用します。 エンド ユーザーがスペースを操作するには、このウェアハウスにアクセスする必要があります。 Genie スペースでは、プロまたはサーバーレスの SQL ウェアハウスを使用できます。 最適なパフォーマンスを得るための Databricks では、サーバーレス SQL ウェアハウスを使用することをお勧めします。
• 説明: Genie スペースを開くと、ユーザーに説明が表示されます。 このテキスト領域を使用して、スペースの目的を説明します。 説明フィールドでは、テキストのスタイルを設定したり、便利なコンテキストや参照へのリンクを指定したりできるように、Markdown の書式設定がサポートされています。 マークダウン構文の詳細については、 マークダウン ガイドのチート シートを参照してください。
• Genie ファイルのアップロード: Genie 領域でファイルのアップロード (パブリック プレビュー) が有効になっている場合は、[ ユーザーが会話にファイルをアップロードできるようにする] を選択できます。 「 ファイルのアップロード」を参照してください。
• サンプルの質問: サンプルの質問は省略可能です。 ユーザーが質問できる質問の種類の例を提供するために、チャットに表示されます。 これらは、スペースの 設定から作成中または後で追加できます。
• タグ: 管理を容易にするために、タグを使用して Genie スペースを整理および分類します。 「タグの追加」を参照してください。

テストと使用状況に基づいて Genieスペースで繰り返し作業することを想定してください。 スペースの作成と反復処理に関するベスト プラクティスのガイダンスについては、「 効果的な Genie 空間をキュレーションする」を参照してください。

タグを追加する

タグを追加するには、Genie スペースに対して少なくとも CAN EDIT 権限が必要です。 管理タグを追加するには、管理タグに対する ASSIGN アクセス許可も必要です。 Genie スペース タグを使用した検索はサポートされていません。 タグの詳細については、「 Unity カタログのセキュリティ保護可能なオブジェクトにタグを適用する」を参照してください。

1. 構成>設定をクリックします。

2. [ 全般] をクリックします。

3. [ タグ] で、タグを追加または更新します。

   • タグがない場合は、[タグの追加] ボタンをクリックします。
   • タグがある場合は、[タグの追加/編集] アイコンをクリックします。

4. 既存のタグ キー と 値 を選択するか、新しいタグの名前を入力します。

   • 管理されるタグは、 Governed セクション ヘッダーにあり、ロック アイコン。
   • タグ キーが必要です。 タグ値が必要かどうかは、タグ キーによって異なります。

Genie 空間をテストする

ほとんどのユーザー操作は、チャット ウィンドウで行われます。 スペースが必要に合わせて動作しているかどうかを確認する最善の方法は、ビジネス ユーザーが尋ねる現実的な質問でテストすることです。

スペース設定で構成されたサンプルの質問がチャット ウィンドウに表示されます。 Genie は、空間のコンテキストに基づいてサンプルの質問を生成して、ユーザーがデータの探索を開始するのに役立つ場合もあります。 ユーザーは、サンプルの質問をクリックするか、画面の下部にあるテキスト フィールドに独自の質問を入力できます。

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

新しい会話を開始するには:

1. [ 新しいチャット ] をクリックして新しいチャットを開始します。 [ をクリックして、前の会話を開きます。
2. [質問する...] テキスト入力フィールドに質問を入力します。

回答を確認する

通常、回答は、質問に対する自然言語の回答と、関連する結果セットを示すテーブルとして配信されます。 Genie は、視覚エフェクトによって応答の明瞭度が向上する可能性があることを検出すると、視覚エフェクトも返します。 正確な応答構造は、質問によって異なります。 質問に回答するために SQL クエリが生成された場合、そのクエリは応答に含まれます。

応答フィードバック

各応答では、ユーザーに回答を求めるメッセージが表示されます。これは正しいですか? ユーザーは、次のいずれかの方法で応答できます。

• はい： 応答が正確に表示されていることを確認します。
• [修正]: 応答に正しくないというフラグを設定します。 ユーザーは、一般的な問題から選択するか、独自の説明を入力できます。 その後、次のことができます。
  • [ 送信] をクリックし、もう一度試して 、提供されたフィードバックを使用して応答を再生成します。
  • [ 送信] をクリックして、応答を再生成せずにフィードバックを送信します。
• レビューの要求: 手動レビューの応答にフラグを設定します。 ユーザーはオプションのコメントを追加して、追加のコンテキストを提供できます。

エディターとして、Genie インターフェイスでフィードバックとフラグ付き応答を表示できます。 Genie 空間の動作は、ユーザーのフィードバックだけに基づいて変わることはありません。 フィードバックを使用して改善の機会を特定するか、ユーザーの質問に直接回答する必要があります。 Databricks では、このメカニズムを使用して、空間に関するフィードバックを提供するようユーザーに勧めます。

ビジネス ユーザーは、[ 監視 ] ページでレビュー対象としてマークした質問の更新を表示できます。 Genie スペースに対する少なくとも CAN MANAGE アクセス許可を持つユーザーは、特定の交換を確認し、要求にコメントし、応答を確認または修正できます。 監視ページでフィードバックにアクセスし、要求を確認できます。 その後、そのフィードバックを使って応答を調整し、スペースで反復処理できます。 「 領域の監視」を参照してください。

その他の応答アクション

生成された SQL を含む応答の場合、追加のオプションを使用して、返されたデータを操作できます。

• CSV のコピー: スペース ユーザーは、最大約 1 GB の結果データを CSV としてダウンロードできます。 最終的なファイル ダウンロードよりも前の手順に 1 GB の制限が適用されるため、最終的なファイル ダウンロード サイズは 1 GB よりも多少増減する場合があります。 結果をダウンロードするには、応答のダウンロード アイコンをクリックします。

• コードの表示: [ コードの表示 ] をクリックして、生成されたクエリを表示します。 これは、信頼性の低い応答のトラブルシューティングに役立ちます。 「 クエリの編集と保存」を参照してください。

• kebab メニュー:次のアクションにアクセスします。

  • CSV のコピー: 応答 CSV をクリップボードにコピーします。
  • 命令として追加します。 同様の質問に答える方法を Genie に教えるのに役立つ可能性がある対話については、[ 命令として追加] をクリックします。 これにより、質問と生成された SQL が入力された SQL クエリの例を保存するための UI が開きます。 この例は、書き込まれたままにするか、編集して保存して変更を加えることができます。 SQL クエリと関数の例を追加するを参照してください。
  • ベンチマークとして追加: ベンチマークの質問として質問を追加します。 「Genie スペースでベンチマークを使用する」をご覧ください。
  • データの更新: 以前に生成されたクエリを実行してデータを更新します。
  • 回答を再生成する: 質問をもう一度送信し、Genie に応答を再生成させます。

クエリの編集と保存

Genie の SQL クエリは、精度を確認し、必要に応じて編集できます。 Genie の空間作成者は、通常、Genie が誤った回答を生成するときに認識できるドメインとデータを知っています。 多くの場合、生成された SQL クエリに対して少量の手動チューニングを行うと、エラーを修正できます。 [ 生成されたコードの表示 ] をクリックしてクエリを検査し、生成された SQL で応答を確認します。

Genie スペースに対して CAN EDIT 以上の特権がある場合は、生成された SQL ステートメントを編集して修正できます。 修正が完了したら、クエリを実行します。 その後、将来の答え方を Genie に教える指示として保存できます。 編集したクエリを保存するには、[ 命令として追加] をクリックします。

領域を監視する

Genie スペースは、データ チームとビジネス ユーザーの間の長期的なコラボレーション ツールと考えることができます。 これは、1 回限りのデプロイとして機能するのではなく、時間の経過と伴う知識を蓄積します。 ユーザーが新しい質問をするにつれて、スペースを調整し、カバレッジと精度を向上させることができます。

[ 監視 ] タブを使用して、個々の質問と回答を確認し、ユーザーのフィードバックを表示し、レビューのフラグが設定された回答を特定します。

[監視] タブには、空間で質問されたすべての質問と回答が表示されます。 質問は、時間、評価、ユーザー、または状態でフィルター処理できます。 この領域を監視することで、CAN MANAGE アクセス許可を持つユーザーは、ビジネス ユーザーによって発生したクエリと Genie 領域の応答を事前に理解できます。

Genie が苦労している質問を特定すると、Genie 空間を特定の指示に更新して応答を改善するのに役立ちます。 質問をクリックして質問と回答のテキストを開き、完全なチャット スレッドを表示します。

Genie スペースを共有する

Genie スペースを共有する場合、ユーザーは次のアクセス許可を持っている必要があります。

• 権限: 消費者アクセスまたは Databricks SQL ワークスペースの権限。 「エンタイトルメントを管理する」をご覧ください。
• コンピューティング: Genie スペース用に指定された既定のウェアハウスへの "CAN USE" 以上のアクセス許可。
• データ アクセス: 空間で使用されるすべての Unity カタログ データ オブジェクトに対する少なくとも SELECT 特権。
• Genie スペース ACL: Genie 空間に対するアクセス権として、少なくとも CAN VIEW/CAN RUN の権限が必要です。 Genie スペースのACLを参照してください。

新しい Genie スペースは、既定でユーザー フォルダーに保存されます。 他のワークスペース オブジェクトと同様に、外側のフォルダーからアクセス許可を継承します。 ワークスペース フォルダー構造を使用して、他のユーザーと共有できます。 「ワークスペース ブラウザー」をご覧ください。

また、特定のアクセス許可レベル (CAN MANAGE、CAN EDIT、CAN RUN、CAN VIEW) で、共有する特定のユーザーまたはグループを指定することもできます。

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

1. [共有] をクリックします。
2. スペースを共有するユーザーまたはグループを入力します。 次に、[ 追加 ] をクリックし、適切なアクセス許可レベルを設定します。 小さなグループの個々のユーザーとメンバーは、スペースが共有されたことを確認する電子メール通知を受け取ります。
3. [共有] ダイアログの下部にある [ リンクのコピー ] ボタンを使用して、Genie スペースへの共有可能なリンクを取得します。 特権ユーザーは、リンクをクリックして新しいタブで Genie スペースを開き、質問することができます。

Genie スペースを複製する

Genie スペースを複製すると、すべてのセットアップ コンテキストと手順を含むコピーが作成されます。 複製は、別のスペースで変更をテストしたり、新しいスペースで元のコンテキストを再利用したりする場合に便利です。 スペースが複製されると、新しいスペースは元のスペースとは無関係になります。 元の内容に影響を与えずに編集や調整を行うことができます。

次の要素は、複製された Genie 空間にコピーされます。

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

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

Genie スペースを複製するには、次の操作を行います。

1. 複製したいジェニースペースを開いてください。
2. をクリックします。スペースの右上隅にある kebab メニュー。
3. クローンをクリックします。
4. (省略可能)[ 複製 ] ダイアログで、複製した Genie 領域の新しい名前とワークスペース フォルダーの場所を指定します。
5. [複製] をクリックして新しいスペースを作成します。

その他のリソース

• ベスト プラクティスに関するガイダンスと問題のトラブルシューティングに関するヘルプについては、 効果的な Genie スペースのキュレーションを参照してください。
• 監査ログを使用して Genie 空間でのアクティビティと使用状況を追跡する方法については、 AI/BI Genie イベントを参照してください。
• Genie API を使用して Genie をアプリケーションに統合し、Genie スペースをプログラムで管理し、Genie 会話 API を使用する方法について説明します。 Genie API リファレンスも参照してください。
• Mosaic AI Agent Framework を使用してマルチエージェント システムを作成する方法については、「マルチエージェント システムで Genie を使用する」を参照してください。