この記事では、ビジネス ユーザーがデータについて自然言語で質問するためのチャット インターフェイスである Genie スペースを設定および管理する方法について説明します。
技術的な要件と制限
Genie スペースを使用する場合は、次の要件と制限が適用されます。
- Unity カタログ: Genie 空間のデータは、Unity カタログに登録する必要があります。 Genie スペースには、最大 25 個のテーブルまたはビューを追加できます。
- 計算する: Genie スペースには、プロまたはサーバーレスの SQL ウェアハウスが必要です。 選択した倉庫に対する CAN USE 権限が少なくとも必要です。 このアクセス許可がない場合、領域の作成は失敗します。
- スループット: 各ワークスペースでは、すべての Genie スペースで 1 分あたり最大 20 個の質問を処理できます。
- 能力: Genie スペースごとに最大 10,000 個の会話をサポートでき、各会話には最大 10,000 件のメッセージを含めることができます。
必要なアクセス許可
Genie スペースを作成、編集、使用するには、次のアクセス許可が必要です。
- コンピューティングのアクセス許可: Genie のスペース作成者、エディター、およびユーザーには、少なくとも、スペースに指定された既定の SQL ウェアハウスへの CAN USE アクセスが必要です。
-
データ アクセス許可: Unity カタログで付与される権限は、特定のデータ オブジェクトにアクセスできるユーザーを制御します。 領域と対話するすべてのユーザーには、その領域で使用されるデータに対する少なくとも
SELECT
特権が必要です。 - Genie 領域のアクセス許可: Genie と対話するには、Genie 空間に対する CAN RUN アクセス許可が必要です。 Genie 空間の権限と能力の完全なマッピングについては、Genie スペース ACL を参照してください。
注
データとコンピューティング アクセスを構成するには、管理者特権が必要です。通常は管理者に制限されます。 Unity カタログ での SQL ウェアハウスの作成 と 特権の管理に関するページを参照してください。
Genie アクセスの管理
Genie は、アカウント レベルで有効にする必要がある Azure AI を利用した AI 支援機能を使用します。 アカウントのこれらの機能を管理する方法については、「 Databricks Assistant を有効にして試す」を参照してください。
注
この機能へのアクセスを管理するには、アカウント管理者である必要があります。 Azure AI を利用する支援 AI 機能を無効にした場合、Databricks SQL エンタイトルメントを持つユーザーは、サイドバーの Genie アイコンをクリックすることはできますが、Genie スペースにはアクセスできません。
Genie スペースを作成する
Genie スペースを作成するには:
- サイドバーで Genie をクリックします。
- 画面の右上隅にある [ 新規 ] をクリックします。
- Genie 空間に含めるデータ ソースを選択します。 次に、[ 作成] をクリックします。
注
- ワークスペースで Genie データ サンプリング が有効になっている場合は、[ データの接続 ] ダイアログのチェック ボックスをオンまたはオフにすることで、値ディクショナリを Genie 空間のコンテキストに追加するかどうかを管理できます。 詳細については、「 Genie の精度を向上させるために値サンプリングを使用する」を参照してください。
- Genie 空間には、複数のメトリック ビューを含めることができます。 ただし、メトリック ビューが含まれている場合、他の種類のテーブルまたはビューを同時に含めることはできません。 メトリック ビューの詳細については、 Unity カタログのメトリック ビューに関するページを参照してください。
クエリ候補を確認する
空間にデータ資産を追加すると、Genie は、それらの資産に関連付けられているワークスペース クエリを自動的に検索します。 ユーザー資格情報は、少なくとも CAN VIEW アクセス許可を持っている関連するクエリを検索するために使用されます。 「クエリ ACL」を参照してください。 検索でクエリが返された場合は、[コンテキスト] パネルの [データ] タブに通知が表示されます。 [ 確認 ] をクリックして、提案されたクエリを表示します。
[提案されたクエリの確認] ダイアログを使用して、提案されたクエリを確認、編集、受け入れる、または拒否します。 Genie 空間で少なくとも CAN EDIT アクセス権を持つ他のユーザーは、クエリ自体に対して少なくとも CAN VIEW アクセス権を持っている場合、クエリを確認できます。
- Title テキストに質問が事前に入力されています。 [タイトル] フィールドに入力して、質問を修正または編集します。
- [コード] フィールドには、推奨される SQL クエリの完全なテキストが含まれています。 このフィールドは編集できません。 クエリ全体を表示するには、...さらに多くの行 をクリックしてください。
- クエリに対する十分なアクセス許可がある場合は、[ SQL クエリ ] をクリックしてクエリ 履歴 UI でクエリを開くことができます。 クエリ履歴を表示を参照してください。
- クエリがスペースに関連しているかどうかを判断したら、[ 承諾 ] または [拒否 ] をクリックしてスペースに追加するか、それに応じて提案を無視します。
- 他の候補をクリックして展開し、確認します。
受け入れられたクエリは、空間の SQL クエリ コンテキストに表示されます。 それらがスペースに追加されると、提案されたクエリと関連する質問が完全に編集可能になります。 SQL クエリと関数の例を追加するを参照してください。
推奨されるクエリが返されない場合:
- 関連するクエリに十分なアクセス権がない可能性があります。
- 関連するデータがない可能性があります。 含まれているテーブルに対してクエリが実行されていない場合、検索で結果が返されない可能性があります。
- Genie 空間とは無関係なクエリは考慮されません。 たとえば、含まれている資産に対して基本的な書き込み操作のみを実行するクエリは、Genie の関連する例とは見なされません。
- Genie では、スペースに追加されていないテーブルに対するクエリは推奨されません。 Genie 空間専用の結合テーブルまたはビューを作成したが、関連する Databricks SQL クエリは通常、別のソース テーブルに対して実行される場合、Genie はそれらのクエリを結果に返しません。
データの管理
Genie 空間に含まれるデータを管理するには、[ 構成>Context>Data ] をクリックして Genie 空間のデータ資産を表示します。 [ 追加 ] ボタンをクリックして、さらにテーブルを追加します。 表名の右側にある をクリックして、スペースから表を削除します。
列の表示
詳細な列ビューの場合は、テーブル名をクリックします。 次の例は、 accounts という名前のテーブルのサンプルを示しています。
形容: Genie はメタデータを使用してデータを理解し、正確な応答を生成します。 このビューの既定のテーブルの説明には、データ資産に関連付けられている Unity カタログ メタデータが表示されます。 この説明を編集して、Genie 空間の特定のコンテキストを追加できます。 ここで行った変更は、この領域にスコープが設定され、Unity カタログに格納されているメタデータは上書きされません。 Unity カタログの説明を復元するには、[ リセット ] をクリックします。
列: 列名と説明は列リストに含まれます。 各列には、 Example 値 または 値ディクショナリ (パブリック プレビュー) が含まれているかどうかを示すタグでラベルが付けられます。 Genie の精度を向上させるための値サンプリングの使用と列メタデータの編集を参照してください。
値サンプリングを有効または無効にする
ワークスペースで Genie データ サンプリング (パブリック プレビュー) が有効になっている場合、Genie は、スペースの作成時に追加したテーブルの値を自動的にサンプリングします。 Genie の精度を向上させるために値サンプリングを使用するを参照してください。 スペースの作成時に値サンプリングが有効になっていない場合は、スペース内の各テーブルに対して有効にすることができます。
すべての列の値サンプリングを有効にするには:
-
をクリックします。[列] 見出しにあるケバブメニューをクリックします。
- [ すべての列の値サンプリングを有効にする] をクリックします。
すべての列の値サンプリングを無効にするには:
-
をクリックします。[列] 見出しにあるケバブメニューをクリックします。
- [ すべての列の値サンプリングを無効にする] をクリックします。
列の表示と非表示を切り替える
不要なデータは、Genie が解釈するのに混乱を招く可能性があります。 Genie のコンテキストからこれらを削除するには、列にカーソルを合わせ、列名の右側にある をクリックします。 これにより、Genie 空間コンテキストから列が除外されます。 アイコンをもう一度クリックして、列を再びスペースに追加します。
列のメタデータを編集する
列のメタデータを編集し、列のシノニムを定義し、詳細設定にアクセスするには、列の上にマウス ポインターを置き、[ の編集アイコンをクリックします。 列ダイアログで、次の内容を編集できます。
説明: Genie スペースの列に関する説明を入力してください。 説明の範囲は、この Genie 空間です。 Unity カタログに格納されているメタデータは上書きされません。 Unity カタログの説明を復元するには、[ リセット ] をクリックします。
類義 語: シノニムとキーワードを追加すると、Genie のユーザー プロンプトで使用される言語を適切な列に一致させることができます。 ビジネス ユーザーがこの列を参照する場合にプロンプトで使用できる単語のコンマ区切りの一覧を入力します。
アドバンスド: 詳細設定を使用して、例の値とビルド値ディクショナリへのアクセスを制御します。 Genie データ サンプリング (パブリック プレビュー) コントロールは、ワークスペース レベルでこれらの機能にアクセスします。 要件を参照してください。 すべての列で値のサンプリングが無効になっている場合、 詳細設定 を変更することはできません。
- 値の例: 既定で有効になっています。この設定により、Genie は列からいくつかの値をサンプリングして、その使用方法をより深く理解できます。 サンプル値のサンプリングをオフにするには、この設定を無効にします。
- 値ディクショナリの構築: 値ディクショナリにより、Genie によるデータの理解が向上します。 Genie の精度を向上させるために値サンプリングを使用するを参照してください。 この設定を使用して、値ディクショナリを持つ列を制御します。
例と手順を追加する
サンプル SQL クエリ、Unity カタログ関数、プレーンテキスト命令を追加して、正確な応答を生成できます。 構成>コンテキストをクリックします。 [SQL クエリ] タブを使用して、クエリと Unity カタログ関数を管理します。 [ 命令 ] タブを使用して、プレーンテキストの命令を追加します。
Genie スペースには、合計で最大 100 個の命令を追加できます。 命令の種類は、次の方法でカウントに影響します。
- 各例の SQL クエリは 1 つとしてカウントされます。
- 各 SQL 関数は 1 としてカウントされます。
- 全般命令テキスト ブロック全体が 1 としてカウントされます。
Genie 空間は、明確で正確なガイダンスに基づいて、一貫した予測可能な応答を提供することを目的としています。 Genie は非決定的な方法で動作するため、望ましくない応答のリスクを最小限に抑えるために、ガイダンスを競合またはあいまいな情報から解放することが重要です。 スペースを設定する場合、重要なタスクは、不整合を確認して解決することです。 これにより、信頼性の高い結果が得られます。
SQL クエリと関数の例を追加する
[SQL クエリ] タブを使用して、次の内容を追加します。
クエリの例 (推奨): SQL クエリの例は、Genie がユーザーの質問に答える正しい SQL を生成するのに役立ちます。 クエリは静的またはパラメーター化できます。 SQL クエリの例ごとに、サンプルの質問と、予想される結果を返す一致する SQL を指定します。 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 に追加のコンテキストを提供して、クエリの例が特に関連するタイミングを説明できます。
使用ガイダンスを追加するには:
- [ 構成>Context>SQL クエリ ] をクリックして、クエリの例の一覧にアクセスします。
- クエリの例をクリックします。
- 画面の下部付近にある [ 使用ガイダンス ] をクリックします。
- このサンプル クエリを使用する方法とタイミングの詳細を入力します。
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 は、空間のコンテキストに基づいてサンプルの質問を生成して、ユーザーがデータの探索を開始するのに役立つ場合もあります。 ユーザーは、サンプルの質問をクリックするか、画面の下部にあるテキスト フィールドに独自の質問を入力できます。
応答はテキスト フィールドの上に表示されます。 ユーザーが質問を入力すると、チャット履歴に保存されます。
新しい会話を開始するには:
- [ 新しいチャット ] をクリックして新しいチャットを開始します。 [
をクリックして、前の会話を開きます。
- [質問する...] テキスト入力フィールドに質問を入力します。
回答を確認する
通常、回答は、質問に対する自然言語の回答と、関連する結果セットを示すテーブルとして配信されます。 Genie は、視覚エフェクトによって応答の明瞭度が向上する可能性があることを検出すると、視覚エフェクトも返します。 正確な応答構造は、質問によって異なります。 質問に回答するために SQL クエリが生成された場合、そのクエリは応答に含まれます。
注
他の大きな言語モデル (LLM) と同様に、Genie は非決定論的な動作を示すことができます。 これは、同じプロンプトを複数回送信するときに、異なる出力を受け取る場合があることを意味します。 Genie が学習できる SQL クエリの例を提供すると、Genie の一貫性を高めるのに役立ちます。 SQL クエリと関数の例を追加するを参照してください。
応答フィードバック
各応答では、ユーザーに回答を求めるメッセージが表示されます。これは正しいですか? ユーザーは、次のいずれかの方法で応答できます。
- はい: 応答が正確に表示されていることを確認します。
-
[修正]: 応答に正しくないというフラグを設定します。 ユーザーは、一般的な問題から選択するか、独自の説明を入力できます。 その後、次のことができます。
- [ 送信] をクリックし、もう一度試して 、提供されたフィードバックを使用して応答を再生成します。
- [ 送信] をクリックして、応答を再生成せずにフィードバックを送信します。
- レビューの要求: 手動レビューの応答にフラグを設定します。 ユーザーはオプションのコメントを追加して、追加のコンテキストを提供できます。
エディターとして、Genie インターフェイスでフィードバックとフラグ付き応答を表示できます。 Genie 空間の動作は、ユーザーのフィードバックだけに基づいて変わることはありません。 フィードバックを使用して改善の機会を特定するか、ユーザーの質問に直接回答する必要があります。 Databricks では、このメカニズムを使用して、空間に関するフィードバックを提供するようユーザーに勧めます。
ビジネス ユーザーは、[ 監視 ] ページでレビュー対象としてマークした質問の更新を表示できます。 Genie スペースに対する少なくとも CAN MANAGE アクセス許可を持つユーザーは、特定の交換を確認し、要求にコメントし、応答を確認または修正できます。 監視ページでフィードバックにアクセスし、要求を確認できます。 その後、そのフィードバックを使って応答を調整し、スペースで反復処理できます。 「 領域の監視」を参照してください。
推奨されるフォローアップの質問
Genie は、スペース命令と会話コンテキストを使用して、フォローアップの質問を提案します。 これらの質問は、ユーザーがさまざまな角度からデータを探索したり、新しい分析情報を収集したりするのに役立ちます。
その他の応答アクション
生成された SQL を含む応答の場合、追加のオプションを使用して、返されたデータを操作できます。
- すべての行をダウンロードします。 スペース ユーザーは、最大約 1 GB の結果データを CSV としてダウンロードできます。 最終的なファイル ダウンロードよりも前の手順に 1 GB の制限が適用されるため、最終的なファイル ダウンロード サイズは 1 GB よりも多少増減する場合があります。 結果をダウンロードするには、応答のダウンロード アイコンをクリックします。
- 命令として追加します。 同様の質問に答える方法を Genie に教えるのに役立つ可能性がある対話については、[ 命令として追加] をクリックします。 これにより、質問と生成された SQL が入力された SQL クエリの例を保存するための UI が開きます。 この例は、書き込まれたままにするか、編集して保存して変更を加えることができます。 SQL クエリと関数の例を追加するを参照してください。
- コードの表示: [ コードの表示 ] をクリックして、生成されたクエリを表示します。 これは、信頼性の低い応答のトラブルシューティングに役立ちます。 「 クエリの編集と保存」を参照してください。
-
kebab メニュー:ユーザーは、以前に生成されたクエリを実行して、応答 CSV をクリップボードにコピーしたり、データを更新したりできます。
視覚エフェクトを編集するには、視覚化の右上隅にある編集アイコンをクリックします。 また、クエリ結果を取得した後に単語で説明することで、視覚エフェクトを生成することもできます。 「視覚化の生成」を参照してください。
結果をフォーマットする
応答のテーブル内の列を書式設定するには、 をクリックします。列ヘッダーの kebab メニューをクリックし、[ 書式 ] をクリックして使用可能なオプションを表示します。 書式設定オプションは、列のデータ型によって異なります。
クエリの編集と保存
Genie の SQL クエリは、精度を確認し、必要に応じて編集できます。 Genie の空間作成者は、通常、Genie が誤った回答を生成するときに認識できるドメインとデータを知っています。 多くの場合、生成された SQL クエリに対して少量の手動チューニングを行うと、エラーを修正できます。 [ 生成されたコードの表示 ] をクリックしてクエリを検査し、生成された SQL で応答を確認します。
Genie スペースに対して CAN EDIT 以上の特権がある場合は、生成された SQL ステートメントを編集して修正できます。 修正が完了したら、クエリを実行します。 その後、将来の答え方を Genie に教える指示として保存できます。 編集したクエリを保存するには、[ 命令として追加] をクリックします。
視覚化の生成
応答に含める特定の視覚化を要求できます。 多くの質問に対して、Genie は結果セットと共に視覚化を自動的に生成します。
自動的に生成された視覚エフェクトを非表示にするには、[ の折りたたみアイコンをクリックします。 もう一度表示するには、[ 視覚エフェクトの表示] をクリックします。
チャット ウィンドウで視覚化を編集できます。
次のグラフの種類がサポートされています。
- 面積
- 棒グラフ
- 折れ線グラフ
- パイ
- ポイント マップ
- 散布図
視覚エフェクトを編集するには:
- 視覚化の右上隅にある
の編集アイコンをクリックします。 ページの右側に編集ウィンドウが開きます。
- [視覚化] ドロップダウン メニューから別のグラフの種類を選択します。
- ほとんどのグラフの種類では、 X 軸 と Y 軸 のドロップダウン メニューを使用して、各軸で表される値を選択します。 円グラフの場合は、[角度] ドロップダウン メニューを使って、表す列を選びます。
- (省略可能)配色をカスタマイズするには、[+] カテゴリのをクリックします。
- (省略可能)視覚化の上にマウス ポインターを置いたときにヒントに表示するデータを選択するには、[+] セクションのをクリックします。
領域を監視する
Genie スペースは、データ チームとビジネス ユーザーの間の長期的なコラボレーション ツールと考えることができます。 これは、1 回限りのデプロイとして機能するのではなく、時間の経過と伴う知識を蓄積します。 ユーザーが新しい質問をするにつれて、スペースを調整し、カバレッジと精度を向上させることができます。
[ 監視 ] タブを使用して、個々の質問と回答を確認し、ユーザーのフィードバックを表示し、レビューのフラグが設定された回答を特定します。
[監視] タブには、空間で質問されたすべての質問と回答が表示されます。 質問は、時間、評価、ユーザー、または状態でフィルター処理できます。 空間を監視することで、Genie スペース エディターは、ビジネス ユーザーによって発生したクエリと、Genie 空間がどのように応答したかを事前に理解できます。
Genie が苦労している質問を特定すると、Genie 空間を特定の指示に更新して応答を改善するのに役立ちます。 質問をクリックして質問と回答のテキストを開き、完全なチャット スレッドを表示します。
Genie スペースを共有する
重要
Genie スペース ユーザーは、独自の資格情報を使用してデータにアクセスする必要があります。 アクセスできないデータに関する質問があると、空の応答が生成されます。
Genie スペースのユーザーは、Genie スペースに接続されているウェアハウスに対する CAN USE アクセス許可と、空間内に表示される Unity カタログ オブジェクトに対するアクセス許可を持っている必要があります。 「 使用する必要があるデータ」を参照してください。
新しい Genie スペースは、既定でユーザー フォルダーに保存されます。 他のワークスペース オブジェクトと同様に、外側のフォルダーからアクセス許可を継承します。 ワークスペース フォルダー構造を使用して、他のユーザーと共有できます。 「 ワークスペース オブジェクトをフォルダーに整理する」を参照してください。
また、特定のアクセス許可レベル (CAN MANAGE、CAN EDIT、CAN RUN、CAN VIEW) で、共有する特定のユーザーまたはグループを指定することもできます。
特定のユーザーまたはグループと共有するには:
- [共有] をクリックします。
- スペースを共有するユーザーまたはグループを入力します。 次に、[ 追加 ] をクリックし、適切なアクセス許可レベルを設定します。 小さなグループの個々のユーザーとメンバーは、スペースが共有されたことを確認する電子メール通知を受け取ります。
- [共有] ダイアログの下部にある [ リンクのコピー ] ボタンを使用して、Genie スペースへの共有可能なリンクを取得します。 特権ユーザーは、リンクをクリックして新しいタブで Genie スペースを開き、質問することができます。
Genie スペースを複製する
Genie スペースを複製すると、すべてのセットアップ コンテキストと手順を含むコピーが作成されます。 複製は、別のスペースで変更をテストしたり、新しいスペースで元のコンテキストを再利用したりする場合に便利です。 スペースが複製されると、新しいスペースは元のスペースとは無関係になります。 元の内容に影響を与えずに編集や調整を行うことができます。
次の要素は、複製された Genie 空間にコピーされます。
- テーブルと設定
- 一般的な指示
- SQL クエリの例
- SQL 関数
既存のチャット スレッドと 監視 データは、新しい領域にコピーされません。
Genie スペースを複製するには、次の操作を行います。
- 複製したいジェニースペースを開いてください。
-
をクリックします。スペースの右上隅にある kebab メニュー。
- クローンをクリックします。
- (省略可能)[ 複製 ] ダイアログで、複製した Genie 領域の新しい名前とワークスペース フォルダーの場所を指定します。
- [複製] をクリックして新しいスペースを作成します。
宇宙準備のベスト プラクティス
ベスト プラクティスに関するガイダンスと問題のトラブルシューティングに関するヘルプについては、 効果的な Genie スペースのキュレーションを参照してください。
使用状況の監視
監査ログを使用して、Genie 領域の使用状況を監視できます。 AI/BI Genie イベント を参照してください。
Genie Conversation API を使用する
重要
この機能はパブリック プレビュー段階にあります。
Genie Conversation API は、既存の Genie 空間のエンドポイントを公開します。ここで、質問したり、生成された SQL とクエリの結果を取得したり、Genie 空間に関連付けられている詳細を取得したりできます。 Conversations API のスループットレートはベスト エフォートであり、システム容量によって異なります。 通常またはトラフィックの少ない状況では、要求はワークスペースごとに 1 分あたり 5 つのクエリに制限されます。 ピーク使用期間中は、使用可能な容量に基づいて要求が処理されるため、実際のスループットが低くなる可能性があります。 Genie Conversation API の使用を開始するには、「 Genie Conversation API を使用して Genie をアプリケーションに統合する」を参照してください。
マルチエージェント システムを作成する
Mosaic AI Agent Framework を使用してマルチエージェント システムを作成する方法については、「マルチエージェント システムで Genie を使用する」を参照してください。