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スペースを作成するには：
- サイドバーの 「Genie Spaces」 をクリックしてください。
- 画面の右上隅にある 新規 をクリックします。
- Genie Spaceに含めたいデータソースを選択してください。次に、 「作成」 をクリックします。
Databricksは、ユーザーとスペースを共有する前に、応答の精度を向上させるために、SQLクエリの例、手順、およびナレッジストアの設定を追加することを推奨しています。Tune Genie Spaceの品質をご覧ください。
クエリの提案を確認する
スペースのデータについて学習するために、Genie はワークスペース内の情報にアクセスし、テーブルとビジネス セマンティクス間の関係をより深く理解します。データ アセットをスペースに追加すると、Genie はそれらのアセットに関連付けられた関連する一般的なワークスペース クエリを自動的に検索します。ユーザー資格情報は、少なくとも CAN VIEW 権限を持つ関連クエリを検索するために使用されます。検索によってクエリが返された場合、 [指示] パネルの [データ] タブに通知が表示されます。提案されたクエリを表示するには、 [レビュー] をクリックします。
クエリのアクセス許可の詳細については、クエリ ACLを参照してください。
推奨クエリの確認 ダイアログを使用して、推奨クエリを確認、編集、承認、または拒否します。Genieスペースに対するCAN EDITアクセス権が 以上ある他のユーザーは、クエリ自体に対するアクセス権がCAN VIEW 以上であれば、クエリをレビューできます。
- タイトル テキストには、質問が事前に入力されています。質問を修正または編集するには、[ タイトル ] フィールドに入力します。
- コード フィールドには、提案された SQL クエリの完全なテキストが含まれています。このフィールドは編集できません。クエリ全体を表示するには、 ...より多くの行 をクリックします。
- クエリに対する十分なアクセス許可がある場合は、[ SQL クエリ ] をクリックして、 クエリ履歴 UI でクエリを開くことができます。クエリ履歴の表示を参照してください。
- クエリがスペースに関連しているかどうかを判断したら、 承認 または 拒否 をクリックしてスペースに追加するか、それに応じて提案を却下します。
- 他の提案をクリックして展開し、確認します。
受け入れられたクエリは、スペースの SQL クエリ コンテキストに表示されます。スペースに追加されると、提案されたクエリと関連する質問は完全に編集可能になります。SQL クエリと関数の例の追加を参照してください。
推奨されるクエリが返されない場合は、次のようにします。
- 関連するクエリに対する十分なアクセス権がない可能性があります。
- 関連するデータがない可能性があります。含まれているテーブルでクエリが実行されていない場合、検索で結果が返されない可能性があります。
- Genieスペースに関係のないお問い合わせは受け付けておりません。 例えば、含まれるアセットに対して基本的な書き込み操作のみを実行するクエリは、Genieにとって適切な例とはみなされません。
- Genieは、スペースに追加されていないテーブルに対するクエリを提案しません。Genie Space専用に結合テーブルやビューを作成した場合でも、関連するDatabricks SQLクエリが通常別のソーステーブルに対して実行される場合、Genieはそれらのクエリを結果に返しません。
データ オブジェクトの管理
Genie Space に含めるデータ オブジェクトを管理するには、 [設定] > [データ] をクリックします。テーブルを追加するには、「 追加」 ボタンをクリックしてください。クリック
テーブル名の右側にある矢印をクリックすると、そのスペースからテーブルが削除されます。
データ オブジェクトの詳細を表示するには、オブジェクト名をクリックします。データ オブジェクト ビューには 2 つのタブが表示されます。
- 概要 : 列名、データ型、説明など、データ オブジェクト内の列を表示します。
- サンプル データ : データのコンテキストと内容を理解するのに役立つ、テーブルからのサンプル データが表示されます。
Genieは、スペースに明示的に追加されたテーブル以外にも、さまざまなテーブルを照会できます。アクセスはGenie Space自体ではなく、 Unity Catalog権限によって制御されます。 Genieはデフォルトでは添付されているテーブルとビューを使用しますが、ユーザーは結合を促したり、SQLを直接編集したりすることで、他のテーブルに対してクエリを実行できます。同様に、命令やメタデータが対象領域外のテーブルを参照している場合、Genieはそれらを生成されたクエリに含めることができます。
設定を構成する
追加の設定を構成して、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セキュリティ保護可能なオブジェクトにタグを適用するを参照してください。
プレビュー
この機能は パブリック プレビュー段階です。
-
[構成] > [設定] をクリックします。
-
[全般] をクリックします。
-
タグ の下で、タグを追加または更新します。
- タグがない場合は、 「タグを追加」 ボタンをクリックします。
- タグがある場合は、
タグの追加/編集 アイコン。
-
既存のタグの キー と 値 を選択するか、新しいタグの名前を入力します。
- 管理されているタグは 管理 セクションのヘッダーに表示され、ロックアイコンが表示されます
。 - タグキーは必須です。タグ値が必要かどうかは、タグ キーによって異なります。
- 管理されているタグは 管理 セクションのヘッダーに表示され、ロックアイコンが表示されます
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 ) で共有することもできます。
特定のユーザーまたはグループと共有するには:
- [共有] をクリックします。
- スペースを共有するユーザーまたはグループを入力します。次に、[ 追加 ] をクリックして、適切なアクセス許可レベルを設定します。個々のユーザーと 小規模 グループのメンバーには、スペースが共有されたことを確認する Eメール 通知が届きます。
- [共有] ダイアログの下部にある リンクをコピー ボタンを使用して、 Genieスペースへの共有可能なリンクを取得します。 特権ユーザーは、リンクをクリックして新しいタブでGenieスペースを開き、質問することができます。
すべてのアカウントユーザーと共有するには：
- [共有] をクリックします。
- すべてのアカウントユーザー を選択してください。
- 適切な権限レベルを設定してください。
スペース利用者は、個別の会話を共有することもできます。「会話を共有する」をご覧ください。
Genieスペースをクローンする
Genie Spaceをクローンすると、すべてのセットアップコンテキストと手順を含むコピーが作成されます。クローン機能は、変更内容を別の環境でテストしたい場合や、元のコンテキストを新しい環境で再利用したい場合に便利です。スペースが複製された後、新しいスペースは元のスペースとは独立しています。元のデータに影響を与えることなく、編集や調整を行うことができます。
以下の要素がクローンされたGenie Spaceにコピーされます。
- テーブルと設定
- 一般的な指示
- SQL クエリの例
- SQL 関数
既存のチャットスレッドや 「モニター」 タブのデータは、新しいスペースにはコピーされません。
Genie Spaceをクローンするには、以下の手順を実行してください。
- クローンを作成したいGenieスペースを開きます。
- スペースの右上隅にある
ケバブメニューをクリックします。 - クローンを作成 をクリックします。
- (オプション) クローン ダイアログで、クローン作成されたGenieスペースの新しい名前とワークスペース・フォルダの場所を指定します。
- クローン をクリックして、新しいスペースを作成します。
Genie Space をメトリクス ビューとしてエクスポートする
Genie Space からコンテキストをメトリクス ビューとしてエクスポートできます。 これにより、スペース内に構成されたデータとセマンティック コンテキストに基づいてメトリクス ビューが作成されます。
Genie Space をメトリクス ビューとしてエクスポートするには、次の手順を実行します。
- エクスポートしたいGenie Spaceを開きます。
- スペースの右上隅にある ケバブメニューをクリックします。
- [メトリクス ビューにエクスポート] を選択します。
- 新しいメトリクス ビューのパスを選択します。
- 作成 をクリックします。
追加のリソース
- ベスト プラクティスに関するガイダンスと問題のトラブルシューティングのヘルプについては、 効果的な Genieスペースのキュレーションを参照してください。
- SQL の例、手順、および設定の構成方法の詳細については、 「Tune Genie スペース品質」を参照してください。
- スペースのテスト方法、応答の確認方法、および監視方法については、 「Genie Space のテストと監視」を参照してください。
- Genie Space でのアクティビティと使用状況を追跡するために監査ログを使用する方法については、 「Genie Space イベント」を参照してください。
- Genie Spaces API の使用方法については、「Genie Spaces API の使用」を参照してください。プログラムによる Genie Spaces のインポートとエクスポートの方法、および Genie 会話 API の使用方法について説明しています。Genie API リファレンスも参照してください。
- Agent Framework を使用してマルチエージェントシステムを作成する方法については、 「マルチエージェントシステムでの Genie の使用 (モデルサービング)」を参照してください。