Genie Spaceの設定と管理

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

技術要件と制限

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

• Unity Catalog ： Genie SpaceのデータはUnity Catalogに登録する必要があります。 Genie Spaceには、最大30個のテーブルまたはビューを追加できます。
• コンピュート: Genie Spaces にはプロまたはサーバーレスSQLウェアハウスが必要です。 Genie Space を作成または構成するときは、選択したウェアハウスに対して少なくとも CAN USE 権限が必要です。 あなたのコンピュート認証情報はGenie Space に埋め込まれ、すべてのユーザーのすべてのクエリを処理するために使用されます。
• スループット： DatabricksのUI経由でアクセスした場合、各ワークスペースはすべてのGenie Spaces全体で1分あたり最大20件の質問を処理できます。Genie API無料枠 (パブリック プレビュー) を使用してGenie Spaces にアクセスする場合、スループットは、すべてのGenie Spaces にわたって、ワークスペースごとに 1 分あたり 5 つの質問がベストエフォートに制限されます。 これらの制限は悪用を防ぐために設けられています。 それ以上の規模でご利用になる場合は、Databricksのアカウントチームまでお問い合わせください。
• 容量： 各Genie Spaceは最大10,000件の会話をサポートでき、各会話には最大10,000件のメッセージを含めることができます。

必要な権限

Genie Spaceを作成または編集するには、以下の権限と権利が必要です。

• エンタイトルメント: Databricks SQL ワークスペースのエンタイトルメントが必要です。エンタイトルメントの管理を参照してください。
• コンピュート: 少なくとも 1 つの pro または サーバレス SQLウェアハウスへのアクセスを使用できます。
• データ アクセス: スペースで使用されるデータに対する SELECT 権限。
• Genieスペース ACL: Genieスペースに対する少なくとも のCAN EDITアクセス許可。Genieスペースの作成者は、作成したスペースに対するCAN MANAGE権限を自動的に付与します。Genieスペース ACL を参照してください。

注記

データとコンピュートのアクセスを設定するには、昇格された権限が必要であり、通常は管理者に限定されます。 SQLウェアハウスの作成およびUnity Catalogでの権限の管理を参照してください。

Genie アクセスの管理

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

注記

この機能へのアクセスを管理するには、アカウント管理者である必要があります。パートナーが提供するAI機能を無効にした場合でも、Databricks SQLのライセンスを持つユーザーはサイドバーの Genie Spaces アイコンをクリックすることはできますが、Genie Spacesにアクセスすることはできません。

Genieスペースを作成する

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

1. サイドバーの 「Genie Spaces」 をクリックしてください。
2. 画面の右上隅にある 新規 をクリックします。
3. Genie Spaceに含めたいデータソースを選択してください。次に、 「作成」 をクリックします。

Databricks では、スペースをユーザーと共有する前に、ナレッジ ストアを構築し、サンプル SQL クエリと指示を追加して応答の精度を向上させることを推奨しています。以下のセクションでは、各構成オプションについて説明します。

クエリの提案を確認する

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

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

推奨クエリの確認 ダイアログを使用して、推奨クエリを確認、編集、承認、または拒否します。Genieスペースに対するCAN EDITアクセス権が 以上ある他のユーザーは、クエリ自体に対するアクセス権がCAN VIEW 以上であれば、クエリをレビューできます。

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

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

推奨されるクエリが返されない場合は、次のようにします。

• 関連するクエリに対する十分なアクセス権がない可能性があります。
• 関連するデータがない可能性があります。含まれているテーブルでクエリが実行されていない場合、検索で結果が返されない可能性があります。
• Genieスペースに関係のないお問い合わせは受け付けておりません。 例えば、含まれるアセットに対して基本的な書き込み操作のみを実行するクエリは、Genieにとって適切な例とはみなされません。
• Genieは、スペースに追加されていないテーブルに対するクエリを提案しません。Genie Space専用に結合テーブルやビューを作成した場合でも、関連するDatabricks SQLクエリが通常別のソーステーブルに対して実行される場合、Genieはそれらのクエリを結果に返しません。

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

Genie Space に含めるデータ オブジェクトを管理するには、 [設定] > [データ] をクリックします。テーブルを追加するには、「 追加」 ボタンをクリックしてください。クリックテーブル名の右側にある矢印をクリックすると、そのスペースからテーブルが削除されます。

データ オブジェクトの詳細を表示するには、オブジェクト名をクリックします。データ オブジェクト ビューには 2 つのタブが表示されます。

• 概要 : 列名、データ型、説明など、データ オブジェクト内の列を表示します。
• サンプル データ : データのコンテキストと内容を理解するのに役立つ、テーブルからのサンプル データが表示されます。

注記

Genieは、スペースに明示的に追加されたテーブル以外にも、さまざまなテーブルを照会できます。アクセスはGenie Space自体ではなく、 Unity Catalog権限によって制御されます。 Genieはデフォルトでは添付されているテーブルとビューを使用しますが、ユーザーは結合を促したり、SQLを直接編集したりすることで、他のテーブルに対してクエリを実行できます。同様に、命令やメタデータが対象領域外のテーブルを参照している場合、Genieはそれらを生成されたクエリに含めることができます。

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

ナレッジストアとは、厳選された意味定義の集合体であり、Genieがデータに対する理解を深め、応答の精度を高めるものです。ナレッジストアの設定はすべてGenie Spaceの範囲内で行われ、 Unity Catalogメタデータやその他のDatabricksアセットには影響しません。 詳細については、 「より信頼性の高いGenie Spacesのための知識ストアの構築」を参照してください。知識ストアには以下のものが含まれます。

• メタデータのカスタマイズ : スペース固有のテーブルと列の説明を追加し、ビジネス用語を列名にマッピングする同義語を定義します。「列の表示」を参照してください。
• プロンプト マッチング : フォーマット アシスタンスとエンティティ マッチングにより、Genie はユーザー言語を実際のデータ値と一致させ、スペルミスを修正し、より正確な SQL を生成できます。プロンプト一致の概要を参照してください。
• 結合リレーションシップ : Genie が正確なJOINステートメントを構築できるように、テーブル間のリレーションシップを定義します。単一の列で結合するには、列等価構文（例： accounts.id = opportunity.accountid ）を使用します。または、 [SQL 式を使用] をクリックして、複数列の結合や、単純な列等価ではなく SQL 式を使用した結合など、より複雑な結合条件を入力することもできます。結合関係の定義を参照してください。
• SQL 式 : KPI や一般的なフィルタリング条件などのビジネス ロジックをキャプチャする再利用可能なメジャー、フィルター、ディメンションを定義します。「SQL 式の定義」を参照してください。

SQL の例と手順を追加する

正確な応答を生成するために、サンプルSQLクエリ、 Unity Catalog関数、プレーンテキストの指示を追加できます。 [構成] > [手順] をクリックします。クエリとUnity Catalog関数を管理するには、 SQLクエリ タブを使用します。 プレーンテキストの指示を追加するには、 テキスト タブを使用します。

各Genieスペースには、2つの異なる制限があります。

• 指示（1スペースあたり100） ：各SQLクエリの例、各SQL関数、および 一般指示 テキストブロック全体は、それぞれ1つの指示としてカウントされます。
• ナレッジストアのスニペット（1スペースあたり200） ：テーブルの説明、結合関係、SQL式（メジャー、フィルター、ディメンション）はこの制限を共有します。「ビュー列」 、 「結合関係の定義」 、 「SQL式の定義」を参照してください。

Genie Spaceは、明確かつ的確なガイダンスに基づき、一貫性があり予測可能な対応を提供することを目指しています。Genieは非決定論的な方法で動作するため、望ましくない反応のリスクを最小限に抑えるために、ガイダンスに矛盾した情報や曖昧な情報を含めないことが重要です。スペースを設営する際、重要なタスクは、矛盾点を確認し、解決することです。 これは信頼性の高い結果を得るのに役立ちます。

サンプルの SQL クエリと関数を追加する

「SQL クエリ」 タブを使用して、以下を追加します。

• サンプル クエリ (推奨): サンプル SQL クエリは、Genie が一般的なユーザーの質問に答えるための正しい SQL を生成するのに役立ちます。クエリは静的またはパラメータ化できます。各サンプル SQL クエリに対して SQL を提供し、ユーザーの質問の最も一般的な言い回しをタイトルとして使用します。これにより、Genie がプロンプトを例に一致させる能力が向上します。Genie はサンプルクエリを直接使用することも、そこから学習して同様の質問を処理することもできます。パラメーター化されたクエリを使用すると、応答は Trusted としてマークされます。スペース内で CAN EDIT 権限を持つユーザーは、応答を生成するために使用されたクエリを表示できるため、トラブルシューティングや改善に役立ちます。

• SQL関数: 静的またはパラメータ化されたSQLクエリで回答できない質問については、 Unity Catalogにカスタム関数を登録できます。 機能はチーム間で共有でき、Genieが特定の質問に答えるために利用できます。SQL関数を使用して回答された応答は 「信頼できる」 とマークされます。Genie Space で SQL 関数を使用する方法の詳細については、 「信頼できるアセット」を参照してください。

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

サンプルクエリは、利用可能なデータを使用して質問に答える方法を Genie に示します。テキスト フィールドにサンプルの質問を入力し、その質問に答える SQL クエリを入力します。ユーザーが自然に尋ねるであろう方法でサンプルの質問を記述します。Genie は一致する質問を受け取ると、サンプルクエリを直接使用して回答を提供できます。Genie は同様の質問を受け取ると、サンプルクエリのヒントを使用して、応答で提供される SQL を学習し、構造化します。次の例のように、組織とデータに固有のロジックを強調するサンプルを提供することに重点を置きます。

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;

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

パラメータ化されたサンプルクエリを使用すると、スペースユーザーはクエリに挿入される値を指定できます。 。 を使用すると、 Genieユーザーの質問から特定の入力を受け取り、サンプルクエリの構造を再利用して、 信頼できる とラベル付けされた検証済みの回答を提供できます。

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

1. 論点を挿入したい場所にカーソルを置きます。

2. 「追加」 をクリックします。

   これにより、安全な名前parameterを持つ新しい問題が作成されます。 名前を変更するには、クエリ エディターで置き換えてください。エディターでコロンに続けて問題名 ( :parameter_name ) を直接入力して、問題を追加することもできます。

問題を編集するには、問題名の横にあります。 「問題の詳細」 ダイアログには次のオプションが含まれています。

• キーワード : クエリ内の課題を表すキーワード。 クエリテキストを直接編集することによってのみ変更できます。
• 表示名 ：Genieがチャット応答で使用する、人間が読みやすい名前。Genieがパラメータ付きクエリを使用してレスポンスを生成する場合、表示名と値が含まれます。
• 型 : サポートされている型には、 文字列 、 日付 、 日付と時刻 、 数値が 含まれます。デフォルトは 文字列 です。 数値 の場合、 小数 （デフォルト）または 整数を 指定できます。

注記

入力値が選択された型と一致しない場合、Genie はそれを不正な型として扱い、不正確な結果につながる可能性があります。

パラメータ化されたクエリの正確なテキストがレスポンスで使用される場合、レスポンスには 「信頼できる」 というラベルが付けられます。信頼できる資産を参照してください。

信頼できる資産

信頼できるアセットとは、ユーザーから寄せられると予想される質問に対して、検証済みの回答を提供するSQLクエリやSQL関数の例です。Genieが信頼できるアセットを使用して質問に答える場合、その回答には 「信頼できる」 というラベルが付けられ、Genieスペースの利用者は結果の正確性についてより一層の信頼感を得ることができます。

信頼できる資産には以下が含まれます。

• パラメータ化された例の SQL クエリ : パラメータ化されたクエリの正確なテキストを使用して応答を生成すると、応答には Trusted という ラベルが付けられます。スペース ユーザーは、問題値を編集してクエリを再実行できます。 「クエリの追加」を参照してください。
• SQL関数 ： Unity Catalogに登録されているSQL関数は、 Genieスペースに追加できます。 SQL関数を使用して生成された応答には 「信頼できる」という ラベルが付けられます。GenieはSQL関数をどのように使用するのか？を参照してください。

Genie Space上で少なくともCAN EDIT権限を持つユーザーは、信頼できるアセットを追加または削除できます。 スペースユーザーは、信頼できる資産として使用されるすべてのSQL関数に対してEXECUTE権限を持っている必要があります。

使用指導を行う

Genieに追加のコンテキストを提供して、サンプルクエリが特に関連性がある場合を説明できます。

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

1. サンプルクエリのリストにアクセスするには、 [構成] > [手順] > [SQL クエリ] をクリックします。
2. クエリの例をクリックします。
3. 画面下部付近の[ 使用ガイダンス ]をクリックします。
4. この例のクエリをいつどのように使用するかについての詳細を入力します。

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

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

指示を提供する

「テキスト」 タブをクリックして、あなたのビジネスに関する特定の質問にどのように答えるかを Genie が理解できるように、プレーンテキストの指示を記入します。手順を 1 つの包括的なメモとしてフォーマットしたり、整理しやすいようにトピック別に分類したりすることができます。

指示は、Genieが特定のドメインで独自の専門用語、ロジック、および概念を処理できるように、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スペースをカスタマイズします。 設定 > 構成 をクリックして、次の設定にアクセスします。

• タイトル : タイトルは、他のワークスペース オブジェクトとともにワークスペース ブラウザーに表示されます。エンドユーザーがGenieスペースを見つけるのに役立つタイトルを選択します。
• いずれウェアハウス : このコンピュート リソースは、 Genie Space で生成されるSQLステートメントを強化します。 ウェアハウスの選択を保存すると、コンピュートの資格情報がGenieスペースに埋め込まれ、すべてのユーザーのすべてのGenieクエリを処理するために使用されます。 ウェアハウスを変更するには、スペースに対する少なくともCAN EDIT権限が必要です。 後で別の作成者がウェアハウスを変更した場合、代わりにその作成者のコンピュート資格情報が埋め込まれます。 Genie Space はプロまたはサーバーレスSQLウェアハウスを使用できます。 最適なパフォーマンスを得るために、 DatabricksサーバーレスSQLウェアハウスの使用をお勧めします。
• タグ : タグを使用してGenieスペースを整理および分類し、管理を容易にします。 タグの追加を参照してください。
• サムネイル ：Genie Spaceにサムネイル画像を追加します。サムネイルは、Genie Spaceの最初のチャットページとGenie内に表示されます。
• 説明 ：ユーザーはGenie Spaceeを開くと説明が表示されます。このテキストエリアを使って、このスペースの用途を説明してください。説明欄はMarkdown形式に対応しているため、テキストにスタイルを適用したり、役立つ情報や参考文献へのリンクを追加したりできます。Markdown構文に関する詳細については、 Markdownガイドのチートシートを参照してください。
• よくある質問 ：よくある質問は任意です。これらはチャット画面に表示され、ユーザーがどのような質問をできるかの例を示す役割を果たします。これらは作成時に追加することも、後からスペースの 設定 から追加することもできます。

テストと使用状況に基づいて、Genie Spaceを繰り返し改善していくことを想定してください。スペースの作成と改善におけるベストプラクティスについては、 「効果的なGenieスペースをキュレーションする」を参照してください。

タグを追加する

タグを追加するには、 Genieスペースに対して少なくともCAN EDIT権限が必要です。 管理タグを追加するには、管理タグに対する ASSIGN 権限も必要です。 タグの詳細については、 Unity Catalogセキュリティ保護可能なオブジェクトにタグを適用するを参照してください。

備考

プレビュー

この機能は パブリック プレビュー段階です。

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

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

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

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

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

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

Genie Spaceをテストする

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

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

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

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

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

回答を確認する

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

注記

他の大規模言語モデル (LLM) と同様に、Genie は非決定論的な動作を示すことがあります。つまり、同じプロンプトを複数回送信すると、異なる出力が表示される場合があります。Genie が学習できる SQL クエリの例を提供することで、Genie の一貫性を高めることができます。SQL クエリと関数の例の追加を参照してください。

レスポンスのフィードバック

各応答は、ユーザーに これは正しいですか? と回答するように求めます。ユーザーは、次のいずれかの方法で応答できます。

• はい： 応答が正確であることを確認します。

• 修正します: 応答に不正解のフラグを付けます。ユーザーは、一般的な問題から選択するか、独自の説明を入力できます。その後、次のことができます。

  • 送信および再試行 をクリックし、提供されたフィードバックを使用して応答を再生成してください。
  • 送信 をクリックして、応答を再生成せずにフィードバックを送信します。

• レビューをリクエストする: 手動レビューのために応答にフラグを設定します。ユーザーは、追加のコンテキストを提供するために、オプションのコメントを追加できます。

編集者は、Genieのインターフェースでフィードバックやフラグ付けされた回答を確認できます。Genie Spaceの動作は、ユーザーからのフィードバックのみに基づいて変更されるわけではありません。フィードバックは、改善の機会を特定したり、ユーザーからの質問に直接回答したりするために活用すべきです。Databricksは、この仕組みを利用してユーザーにスペースに関するフィードバックを提供するよう促すことを推奨しています。

ビジネスユーザーは、 モニタリング ページで、レビュー対象としてマークした質問の更新情報を確認できます。Genie Space上で少なくとも「CAN MANAGE」権限を持つユーザーは、特定のやり取りを確認したり、リクエストにコメントしたり、レスポンスを確認または修正したりすることができます。モニタリングページからフィードバックやレビュー依頼にアクセスできます。そうすることで、そのフィードバックを活用して反応を調整し、空間を改善していくことができます。スペースの監視を参照してください。

その他の対応措置

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

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

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

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

  • CSV をコピー : 応答 CSV をクリップボードにコピーします。
  • 指示として追加します。 類似の質問への回答方法をGenieに教えるのに役立つ可能性のあるインタラクションについては、 指示として追加 をクリックします。これにより、サンプルSQLクエリを保存するためのUIが開き、質問と生成されたSQLが入力されます。例をそのままにしておくことも、編集して保存して変更を加えることもできます。SQL クエリと関数の例の追加を参照してください。
  • ベンチマークとして追加 : 質問をベンチマーク質問として追加します。Genieスペースでベンチマークを使用するを参照してください。
  • データの更新 : 以前に生成されたクエリを実行してデータを更新します。
  • 回答の再生成 : 質問を再度送信すると、Genie によって回答が再生成されます。

クエリの編集と保存

GenieのSQLクエリは、正確性を確認し、必要に応じて編集することができます。Genie Spaceの開発者は通常、ドメインとデータに精通しているため、Genieが誤った回答を生成しているかどうかを認識できます。多くの場合、生成されたSQLクエリを少し手動で調整するだけで、エラーは修正できます。 「生成されたコードを表示」を クリックすると、クエリを検査し、応答に対して生成されたSQLを表示できます。

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

スペースを監視する

Genie Spaceは、データチームとビジネスユーザー間の長期的なコラボレーションツールと考えることができます。これは、一度限りの導入ではなく、時間をかけて知識を蓄積していくものです。ユーザーから新たな質問が寄せられるにつれて、その範囲を絞り込み、網羅性と精度を向上させることができます。

モニタリング タブを使用して、個々の質問と回答を確認したり、ユーザー フィードバックを表示したり、レビューのフラグが付けられた回答を特定したりできます。

モニタリングタブには、そのスペースで投稿されたすべての質問と回答が表示されます。質問は、時間、評価、ユーザー、またはステータスで絞り込むことができます。スペースを囲むことで、 CAN MANAGE権限を持つユーザーは、ビジネスユーザーから提起されたクエリとGenie Space がどのように応答したかを事前に理解できます。

Genieが苦手とする質問を特定することで、Genie Spaceに具体的な指示を追加して、Genieの応答を改善することができます。質問をクリックすると、質問と回答のテキストが開き、チャットのスレッド全体が表示されます。

会話の質を確認する

会話が [スペース管理者によるレビュー可能] に設定されている場合、 CAN MANAGEタブから会話を開いて完全な交換をレビューできます。 これにより、Genieの応答品質を評価したり、ユーザーからのフィードバックに対応したり、追加の指示や例題によって精度が向上する領域を特定したりすることができます。 非公開 に設定された会話の場合、スペース管理者はユーザーのプロンプトは確認できますが、クエリ結果は確認できません。

Genieスペースを共有する

注記

Genie Spaces は、ウェアハウスを構成した作成者からの埋め込みコンピュート資格情報を使用します。 すべてのクエリは、これらの埋め込みコンピュート資格情報を使用して実行されます。 しかし、スペースのエンドユーザーはクエリに独自のデータ認証情報が適用されるため、自分が閲覧できるはずのデータのみを閲覧できます。アクセスできないデータに関する質問に対しては、空の応答が返されます。

同じ Genie Space 内で各ユーザーが閲覧できるデータを制限するには、Unity Catalog の基となるテーブルに行レベルのセキュリティを適用します。Unity Catalogで定義された行フィルターと列マスクは、Genie Spaceの共有方法に関係なく、ユーザーごとに自動的に適用されます。行フィルターと列マスクを参照してください。

Genie Spaceを共有する場合、ユーザーはスペースを操作するために以下の権限を持っている必要があります。

• エンタイトルメント: コンシューマー アクセスまたは Databricks SQL ワークスペースの権利。エンタイトルメントの管理を参照してください。
• コンピュート: ウェアハウスを構成した作成者によって埋め込まれたコンピュート資格情報を使用してクエリを実行します。 エンドユーザーは直接ウェアハウス権限を必要としません。
• データ アクセス: スペースで使用されるすべてのUnity Catalogデータ オブジェクトに対する少なくともSELECT権限。 ユーザーには、アクセス権限のあるデータのみが表示されます。
• Genieスペース ACL: Genieスペースに対する少なくともCAN VIEW/CAN RUNの権限。Genieスペース ACL を参照してください。

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

また、特定のユーザーまたはグループ (すべてのアカウント ユーザーを含む) を指定して、特定のアクセス許可レベル ( CAN MANAGE 、 CAN EDIT 、 CAN RUN 、およびCAN VIEW ) で共有することもできます。

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

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

すべてのアカウントユーザーと共有するには：

1. [共有] をクリックします。
2. すべてのアカウントユーザー を選択してください。
3. 適切な権限レベルを設定してください。

スペース利用者は、個別の会話を共有することもできます。「会話を共有する」をご覧ください。

Genieスペースをクローンする

Genie Spaceをクローンすると、すべてのセットアップコンテキストと手順を含むコピーが作成されます。クローン機能は、変更内容を別の環境でテストしたい場合や、元のコンテキストを新しい環境で再利用したい場合に便利です。スペースが複製された後、新しいスペースは元のスペースとは独立しています。元のデータに影響を与えることなく、編集や調整を行うことができます。

以下の要素がクローンされたGenie Spaceにコピーされます。

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

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

Genie Spaceをクローンするには、以下の手順を実行してください。

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

追加のリソース

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