ダッシュボードを使用した Genie エージェント

公開されたダッシュボードには、ビジネス ユーザーが自然言語を使用してデータを探索できるように、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 エージェントを有効または構成するには:

  1. ダッシュボードを開きます。
  2. 右側のパネルで、[ 設定] をクリックします。 または、[ Kebab] メニュー アイコン をクリックします。kebab メニュー >設定 を開きます。
  3. [ 全般] をクリックします。
  4. [ Genie を有効にする] トグルは既定でオンになっています。 ダッシュボード ビューアーの Genie エージェントを無効にする場合は、トグルをオフにします。
  5. (省略可能)既存の Genie エージェントをリンクするには、[ 既存の Genie Agent のリンク ] ラジオ ボタンを選択し、関連付けられている URL を貼り付けます。 このオプションを選択しない場合、Databricks は発行時にダッシュボードに基づいて新しい Genie エージェントを自動的に生成します。

公開されたダッシュボードで Genie チャット ウィンドウが開く GIF。ユーザーは質問をし、Genie は結果テーブルで応答します。

Important

閲覧者が Genie を使用すると、データセットのクエリ結果全体から質問に回答します。 データセット クエリに機密性の高い列または行が含まれている場合、そのデータは視覚化に表示されていなくても Genie で使用できるようになります。 ユーザーがアクセスするフィールドと行のみを含むようにデータセットを定義します。 Genie エージェントのアクセス許可を参照してください。

コンパニオン Genie エージェントは、ファイル ブラウザーまたは Genie 登録情報ページには表示されません。 ダッシュボードを変更して再発行すると、関連する Genie エージェントが自動的に更新され、新しいデータセットと視覚化が反映されます。

Genie エージェントを開く

発行された Genie エージェントを新しいウィンドウで開くには:

  1. [Kebab] メニュー アイコン をクリックします。チャット ウィンドウの右上隅にある kebab メニュー
  2. [ Genie エージェントを開く] をクリックします。

Genie エージェント UI から自動生成された Genie エージェントの手順を編集することはできません。 Genie エージェントは、ダッシュボードに変更を加えて再発行すると更新されます。

特定のグラフについて Genie に質問する

特定のダッシュボード グラフについて Genie に質問するには:

  1. Genie 対応の公開済みダッシュボードから、[Genie に質問する] をクリックします。
  2. ダッシュボード グラフをクリックして選択します。 Genie は、選択したグラフのタイトルをチャット ウィンドウに表示します。
  3. 選択したグラフで表されるデータについて質問します。

Genie にグラフの変更を説明するよう依頼する

Genie に、横棒グラフ、折れ線グラフ、および面時系列の視覚化 (複数系列グラフや積み上げグラフを含む)、ピボット テーブル セル、横棒グラフ、円グラフ、ヒートマップのグラフから直接変更を説明するように依頼できます。 Genie はエージェント モードに入り、変更を分析し、上位のドライバーを識別します。

グラフの変更を説明するには:

  1. Genie 対応の公開済みダッシュボードから、[Genie に質問する] をクリックします。
  2. サポートされている視覚エフェクトを右クリックします。
  3. Genie に変更の説明を求めるオプションを選択します。

Genie は、選択した変更を分析し、上位の要因を含む説明を返します。

Genie エージェントのアクセス許可

アクセス許可は、Genie エージェントが自動生成されたかリンクされたかによって異なります。

自動生成された Genie エージェント は、ダッシュボードの資格情報モデルに従います。

  • ダッシュボードで埋め込み資格情報 (共有データアクセス許可) が使用されている場合、Genie エージェントでは埋め込み資格情報も使用されます。 Genie は発行元の資格情報を使用してデータにアクセスするため、基になるデータに直接アクセスできなくても、閲覧者は Genie と対話できます。
  • ダッシュボードでビューアーの資格情報が使用されている場合、Genie エージェントはビューアーの資格情報も使用します。 各ビューアーの独自のデータ アクセス許可が適用されます。

リンクされた Genie エージェントは、Genie エージェント自体で構成された資格情報設定を常に使用します。 ダッシュボードの資格情報設定は、リンクされた Genie エージェントには影響しません。

いずれの場合も、Genie エージェントと対話するには、ビューアーがワークスペースのメンバーである必要があります。 アクセスの種類の詳細については、「 ダッシュボードと Genie アクセスの管理」を参照してください。

ダッシュボードの Genie エージェントの説明を編集する

Databricks では、ダッシュボードのコンテンツに基づいて説明が自動的に生成されます。 説明はいつでも編集できます。

説明を編集するには:

  1. Genie エージェントを開きます。
  2. [構成]をクリックします。
  3. [ 鉛筆] アイコン をクリックします。[説明] の横にある編集アイコンを クリックします
  4. 説明を入力または編集し、[ 保存] をクリックします。

互換性のない 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では、生成されたウィジェットのタイトルは、タイトルや説明を編集・保存した後にリッチテキストをサポートします。 「 書式が適用されていない場所」を参照してください。