公開されたダッシュボードには、ビジネス ユーザーが自然言語を使用してデータを探索できるように、Genie エージェントが既定で含まれています。 Genie エージェントは、公開されたダッシュボードに [Genie に質問 する] ボタンを提供するコードなしのインターフェイスです。これにより、閲覧者は定義済みの視覚化のみに依存するのではなく、データとチャットできます。 [ Genie に質問 する] ボタンは、ワークスペース内と 基本的な埋め込みを使用してダッシュボードを埋め込むときに、閲覧者が使用できます。 Genie エージェントを参照してください。
ダッシュボードを発行すると、[ Genie を有効にする] トグルが既定でオンになり、Databricks によってダッシュボードのデータセットと視覚化に基づいて Genie エージェントが自動的に生成されます。 または、既存の Genie エージェントにリンクするか、切り替えをオフにして Genie を無効にすることができます。
コンパニオン Genie エージェントは Genie Agents の概念を使用します。これにより、Genie は複数のステップとデータ ソースで推論し、複雑な質問に回答できます。
Genie エージェントの詳細については、「 Genie エージェント」を参照してください。
注
Ask Genie は、基本的な埋め込みでのみ使用できます。 Ask Genie は外部埋め込みではサポートされていません。 外部埋め込みシナリオでは、 Genie Conversation API を使用して自然言語クエリ機能を統合します。
ダッシュボードの Genie エージェントへのアクセスを制御する
公開されたダッシュボードに対して Genie エージェントを有効または構成するには:
- ダッシュボードを開きます。
- 右側のパネルで、[ 設定] をクリックします。 または、[
をクリックします。kebab メニュー >設定 を開きます。
- [ 全般] をクリックします。
- [ Genie を有効にする] トグルは既定でオンになっています。 ダッシュボード ビューアーの Genie エージェントを無効にする場合は、トグルをオフにします。
- (省略可能)既存の Genie エージェントをリンクするには、[ 既存の Genie Agent のリンク ] ラジオ ボタンを選択し、関連付けられている URL を貼り付けます。 このオプションを選択しない場合、Databricks は発行時にダッシュボードに基づいて新しい Genie エージェントを自動的に生成します。
Important
閲覧者が Genie を使用すると、データセットのクエリ結果全体から質問に回答します。 データセット クエリに機密性の高い列または行が含まれている場合、そのデータは視覚化に表示されていなくても Genie で使用できるようになります。 ユーザーがアクセスするフィールドと行のみを含むようにデータセットを定義します。 Genie エージェントのアクセス許可を参照してください。
注
コンパニオン Genie エージェントは、ファイル ブラウザーまたは Genie 登録情報ページには表示されません。 ダッシュボードを変更して再発行すると、関連する Genie エージェントが自動的に更新され、新しいデータセットと視覚化が反映されます。
Genie エージェントを開く
発行された Genie エージェントを新しいウィンドウで開くには:
-
をクリックします。チャット ウィンドウの右上隅にある kebab メニュー
- [ Genie エージェントを開く] をクリックします。
注
Genie エージェント UI から自動生成された Genie エージェントの手順を編集することはできません。 Genie エージェントは、ダッシュボードに変更を加えて再発行すると更新されます。
特定のグラフについて Genie に質問する
特定のダッシュボード グラフについて Genie に質問するには:
- Genie 対応の公開済みダッシュボードから、[Genie に質問する] をクリックします。
- ダッシュボード グラフをクリックして選択します。 Genie は、選択したグラフのタイトルをチャット ウィンドウに表示します。
- 選択したグラフで表されるデータについて質問します。
Genie にグラフの変更を説明するよう依頼する
Genie に、横棒グラフ、折れ線グラフ、および面時系列の視覚化 (複数系列グラフや積み上げグラフを含む)、ピボット テーブル セル、横棒グラフ、円グラフ、ヒートマップのグラフから直接変更を説明するように依頼できます。 Genie はエージェント モードに入り、変更を分析し、上位のドライバーを識別します。
グラフの変更を説明するには:
- Genie 対応の公開済みダッシュボードから、[Genie に質問する] をクリックします。
- サポートされている視覚エフェクトを右クリックします。
- Genie に変更の説明を求めるオプションを選択します。
Genie は、選択した変更を分析し、上位の要因を含む説明を返します。
Genie エージェントのアクセス許可
アクセス許可は、Genie エージェントが自動生成されたかリンクされたかによって異なります。
自動生成された Genie エージェント は、ダッシュボードの資格情報モデルに従います。
- ダッシュボードで埋め込み資格情報 (共有データアクセス許可) が使用されている場合、Genie エージェントでは埋め込み資格情報も使用されます。 Genie は発行元の資格情報を使用してデータにアクセスするため、基になるデータに直接アクセスできなくても、閲覧者は Genie と対話できます。
- ダッシュボードでビューアーの資格情報が使用されている場合、Genie エージェントはビューアーの資格情報も使用します。 各ビューアーの独自のデータ アクセス許可が適用されます。
リンクされた Genie エージェントは、Genie エージェント自体で構成された資格情報設定を常に使用します。 ダッシュボードの資格情報設定は、リンクされた Genie エージェントには影響しません。
いずれの場合も、Genie エージェントと対話するには、ビューアーがワークスペースのメンバーである必要があります。 アクセスの種類の詳細については、「 ダッシュボードと Genie アクセスの管理」を参照してください。
ダッシュボードの Genie エージェントの説明を編集する
Databricks では、ダッシュボードのコンテンツに基づいて説明が自動的に生成されます。 説明はいつでも編集できます。
説明を編集するには:
- Genie エージェントを開きます。
- [構成]をクリックします。
- [
をクリックします。[説明] の横にある編集アイコンを クリックします。
- 説明を入力または編集し、[ 保存] をクリックします。
互換性のない SQL 式
リンクされた Genie エージェントは、次の SQL 式を含むデータセットを使用できません。
次の例に示すように、非定数文字列を含む識別子句。
SELECT * FROM identifier(:param)次の例に示すように、複数ステートメント データセットの一時ビューまたは関数。
CREATE OR REPLACE TEMPORARY VIEW taxis AS SELECT * FROM samples.nyctaxis.trips; SELECT * FROM taxis;次の例のように、データセットを定義する SQL 内のボリュームを参照します。
SELECT * FROM csv.`/Volumes/catalog/schema/volume/my-data.csv`
注
ダッシュボード内の一部のデータセットのみがサポートされていない式を使用する場合、Ask Genie はサポートされているデータセットを使用し、サポートされていないデータセットは失敗するのではなく無視します。 たとえば、1 つのデータセットで IDENTIFIER() または UDF が使用されている場合、Ask Genie はサポートされている残りのデータセットからの質問に引き続き回答します。
オープンシェアリング
OpenSharing を使用して共有されるデータセットは、埋め込み資格情報 (共有データアクセス許可) を使用する Genie エージェントではサポートされていません。 OpenSharing では、Genie の資格情報委任と互換性のない資格情報システムが使用されます。 Genie でこれらのデータセットを使用するには、埋め込み資格情報ではなくビューアーの資格情報を使用します。
制限事項
- 外部埋め込みでは、Genie に質問することはサポートされていません。 外部埋め込みシナリオでは、 Genie Conversation API を使用します。 「外部埋め込みでは Genie に質問できない」を参照してください。
- Genie エージェント UI から自動的に生成された Genie エージェントの手順を編集することはできません。
- コンパニオン Genie エージェントは、最大 30 個のダッシュボード データセットをサポートします。 ダッシュボードで 30 個を超えるデータセットが使用されている場合、Genie エージェントには 30 個のみが含まれます。
- リンクされた Genie エージェントを使用している場合、ダッシュボード フィルターはチャット コンテキストに引き継がされません。 ダッシュボード フィルターは、自動生成された Genie エージェントで期待どおりに機能します。
- Ask Genie は、非定数文字列、一時ビューまたは関数、またはボリューム参照を含む識別子句を含むデータセットと、サポートされている残りのデータセットからの回答を無視します。 互換性のない SQL 式を参照してください。
- 埋め込み資格情報を使用する Genie エージェントでは、OpenSharing を使用して共有されるデータセットはサポートされていません。 OpenSharing を参照してください。
- Genie Oneが生成するビジュアライゼーションは、生成されたビジュアライゼーションを編集できないため、プレーンテキストのタイトルを使用しています。 Genie Agentでは、生成されたウィジェットのタイトルは、タイトルや説明を編集・保存した後にリッチテキストをサポートします。 「 書式が適用されていない場所」を参照してください。