ダッシュボードでの Genie エージェント
公開されたダッシュボードには、ビジネスユーザーが自然言語を使用してデータを探索できるように、Genieエージェントがデフォルトで含まれています。Genieエージェントは、公開されたダッシュボードに Ask Genie ボタンを提供するコード不要のインターフェースで、閲覧者は定義済みの視覚化だけに頼るのではなく、データとチャットすることができます。 Ask Genie ボタンは、ワークスペース内と、基本的な埋め込みを使用してダッシュボードが埋め込まれている場合の両方で閲覧者が利用できます。「Genieエージェント」を参照してください。
ダッシュボードを公開すると、 Genieを有効にする トグルはデフォルトでオンになり、Databricksはダッシュボードのデータセットとビジュアライゼーションに基づいてGenie Agentを自動的に生成します。あるいは、既存のGenie Agentにリンクするか、トグルをオフにしてGenieを無効にすることもできます。
コンパニオンGenie AgentはGenie Agentのエージェントモードを使用します。これにより、Genieは複数のステップとデータソース全体で推論し、複雑な質問に答えることができます。
Genieエージェントについて詳しくは、Genieエージェントを参照してください。
Ask Genie は基本的な埋め込みでのみ利用可能です。Ask Genieは、 Genie埋め込みではサポートされていません。 外部埋め込みシナリオの場合は、 Genie Conversation APIを使用して自然言語クエリ機能を統合します。
ダッシュボードのGenieエージェントへのアクセスを制御します。
公開されたダッシュボードのGenieエージェントを有効化または構成するには:
- ダッシュボードを開きます。
- 右側のパネルで、 [設定] をクリックします。または、クリック
ケバブメニュー > 設定 を選択して設定を開きます。
- [全般] をクリックします。
- Genie を有効にする トグルはデフォルトでオンになっています。ダッシュボードビューア向けにGenie エージェントを無効にする場合は、トグルをオフにしてください。
- (オプション)既存のGenieエージェントをリンクするには、 既存のGenieエージェントをリンク ラジオボタンを選択し、関連付けられたURLを貼り付けます。このオプションを選択しない場合、公開時にDatabricksはダッシュボードに基づいて新しいGenieエージェントを自動的に生成します。

閲覧者がGenieを使用すると、質問は完全なデータセットのクエリ結果から回答されます。データセットクエリに機密性の高い列または行が含まれている場合、そのデータは視覚化に表示されていなくてもGenieで利用可能になります。ユーザーがアクセスできるようにするフィールドと行のみを含むようにデータセットを定義します。Genieエージェントのアクセス許可を参照してください。
コンパニオン Genie エージェントは、ファイルブラウザまたは Genie リストページには表示されません。変更を加えてダッシュボードを再公開すると、関連する Genie エージェントは新しいデータセットとビジュアライゼーションを反映するように自動的に更新されます。
Genie エージェントを開く
公開されたGenieエージェントを新しいウィンドウで開くには:
- チャットウィンドウの右上隅にある
ケバブメニューをクリックします
- Genieエージェントを開く をクリックします。
自動生成されたGenieエージェントの指示をGenie Agent UIから編集することはできません。変更を加えてダッシュボードを再公開すると、Genieエージェントが更新されます。
特定のチャートについてGenieに質問する
特定のダッシュボード チャートについて Genie に尋ねるには:
- Genie 対応の公開ダッシュボードから [Genie に質問] をクリックします。
- ダッシュボード チャートをクリックして選択します。Genie は、選択したチャート タイトルをチャット ウィンドウに表示します。
- 選択したグラフに表示されるデータについて質問します。
Genieにチャートの変化点について説明してもらう
Genie では、棒グラフ、折れ線グラフ、面グラフなどの時系列可視化(複数系列グラフや積み上げグラフを含む)、ピボットテーブルのセル、横棒グラフ、円グラフ、ヒートマップについて、グラフから直接変更点の説明を求めることができます。Genieはエージェントモードに入り、変化を分析して主要な要因を特定します。
グラフの変化点を説明するには:
- Genie 対応の公開ダッシュボードから [Genie に質問] をクリックします。
- サポートされているビジュアライゼーションを右クリックします。
- 変更内容をGenieに説明してもらうオプションを選択してください。
Genieは選択された変化点を分析し、主な要因をまとめた説明を返します。
Genieエージェントの権限
アクセス権限は、Genieエージェントが自動生成されたかリンクされたかによって異なります。
自動生成されたGenieエージェント は、ダッシュボードの資格情報モデルに従います:
- ダッシュボードが埋め込まれた資格情報(共有データ権限)を使用している場合、Genie Agentも埋め込まれた資格情報を使用します。Genieはパブリッシャーの資格情報を使用してデータにアクセスするため、閲覧者は基になるデータに直接アクセスできなくてもGenieと対話できます。
- ダッシュボードが閲覧者の資格情報を使用している場合、Genie Agentも閲覧者の資格情報を使用します。各閲覧者自身のデータアクセス権限が適用されます。
リンクされたGenieエージェント は、常にGenieエージェント自体で構成されている認証情報設定を使用します。ダッシュボードの認証情報設定は、リンクされたGenieエージェントには影響しません。
すべての場合において、閲覧者がGenie Agentsを操作するには、ワークスペースのメンバーである必要があります。アクセスタイプの詳細については、ダッシュボードとGenieアクセスの管理を参照してください。
ダッシュボードのGenie Agentの説明を編集します。
Databricksは、ダッシュボードの内容に基づいて説明文を自動的に生成します。説明文はいつでも編集できます。
説明を編集するには:
- Genieエージェントを開きます。
- 「設定」 をクリックします。
- クリック
説明 の横にある編集アイコン。
- 説明を入力または編集し、 「保存」 をクリックしてください。
互換性のない SQL 式
リンクされたGenieエージェントは、次のSQL式を含むデータセットを使用できません。
-
Identifier 句を定数以外の文字列に置き換えます。
SQLSELECT * FROM identifier(:param) -
次の例のように、複数ステートメントデータセットの一時的なビューまたは関数。
SQLCREATE OR REPLACE TEMPORARY VIEW taxis AS SELECT * FROM samples.nyctaxis.trips;
SELECT * FROM taxis; -
次の例のように、データセットを定義する SQL 内のボリュームを参照します。
SQLSELECT * FROM csv.`/Volumes/catalog/schema/volume/my-data.csv`
ダッシュボードの一部のデータセットのみがサポートされていない式を使用している場合、Ask Genie は失敗する代わりに、サポートされているデータセットを使用し、サポートされていないデータセットは無視します。たとえば、あるデータセットがIDENTIFIER()またはUDFを使用している場合、Ask Genieは引き続き残りのサポートされているデータセットから質問に回答します。
オープン共有
OpenSharingを使用して共有されるデータセットは、埋め込み資格情報(共有データ権限)を使用するGenieエージェントではサポートされていません。OpenSharingは、Genieの資格情報委任と互換性のない資格情報システムを使用しています。これらのデータセットをGenieで使用するには、埋め込み資格情報ではなく、閲覧者の資格情報を使用します。
制限事項
- Ask Genie は外部埋め込みではサポートされていません。外部埋め込みシナリオの場合は、 Genie Conversation APIを使用します。Ask Genie は外部埋め込みでは利用できません。
- Genie Agent UI から、自動生成された Genie エージェントの指示を編集することはできません。
- コンパニオン Genie エージェントは、最大 30 のダッシュボード データセットをサポートしています。ダッシュボードで 30 を超えるデータセットを使用している場合、Genie エージェントには 30 個のみが含まれます。
- ダッシュボードフィルターは、リンクされたGenieエージェントを使用している場合、チャットコンテキストに引き継がれません。ダッシュボードフィルターは、自動生成されたGenieエージェントで期待どおりに機能します。
- Genieは、非定数の文字列、一時ビューや関数、またはボリューム参照を含む識別子句を持つデータセットを無視し、残りのサポートされているデータセットから回答します。互換性のないSQL式を参照してください。
- OpenSharing を使用して共有されるデータセットは、埋め込み資格情報を使用する Genie エージェントではサポートされていません。OpenSharing を参照してください。