ダッシュボード エージェントを使用してダッシュボードをクエリする

Gemini for Google Cloud を搭載した会話分析を使用すると、直感的なチャット インターフェースで会話形式の言語で質問することで、データを調査できます。ユーザー定義のダッシュボードまたはLookML ダッシュボードで会話分析を使用すると、会話分析によってダッシュボードに接続されたデータエージェントが作成されます。ダッシュボード エージェントと会話すると、エージェントはダッシュボードとそのクエリリンク タイルにクエリを実行します。ダッシュボード データに固有のコンテキストと手順を使用して、ユーザー定義のダッシュボード エージェントをカスタマイズできます。

このページでは、会話分析を使用してダッシュボード データを使用する方法について説明します。ここでは次のトピックを扱います。

始める前に

会話分析を使用してダッシュボード データを使用するには、Looker インスタンスの設定と要件が満たされていること、およびこのページで説明されているタスクを実行するための適切な権限が付与されていることを確認してください。

Looker ダッシュボード内から会話を開始する

ユーザー定義のダッシュボードまたは LookML ダッシュボードからダッシュボード エージェントとの会話を開始するには、spark [このダッシュボードとチャット] を選択します。

ダッシュボードとチャットする権限が不足している場合、Looker にエラーが表示されます。

会話を作成したら、会話内の [質問する] フィールドにデータの質問を入力できます。ダッシュボード エージェントとの最近の会話にアクセスするには、more_vert [メニュー] > [最近の会話] を選択します。

ダッシュボードまたはそのクエリリンク タイルのデータに関する質問をダッシュボード エージェントに送信するだけでなく、ユーザー定義のダッシュボード エージェントの場合は、追加のコンテキストと手順を使用してエージェントの構成をカスタマイズできます。

ダッシュボードのダッシュボード エージェントを有効または無効にする

インスタンスでダッシュボード エージェントが有効になっている場合、デフォルトではすべてのユーザー定義ダッシュボードで有効になります。ただし、ダッシュボード作成者は、個々のダッシュボード レベルでダッシュボード エージェントの設定を有効または無効にすることで、ユーザーが特定のユーザー定義のダッシュボードとチャットできるかどうかを制御できます。

ユーザー定義のダッシュボードでダッシュボード エージェントをオンまたはオフにする手順は次のとおりです。

  1. more_vert [**ダッシュボード アクション**] メニュー アイコンを選択し、 edit [**ダッシュボードを編集**] を選択します。
  2. ダッシュボード ツールバーで settings [**設定**] をクリックします。
  3. [設定] ダイアログで、[全般] タブを選択します。
  4. [ダッシュボードとのチャットを有効にする] コントロールをオンまたはオフにします。
  5. [保存] をクリックして、ダッシュボードへの変更を保存します。

会話のメタデータ

[このダッシュボードとチャット] ペインでは、ダッシュボードのタイプごとに次のタスクがサポートされています。

ユーザー定義のダッシュボード

LookML ダッシュボード

  • ダッシュボード データに関する質問をするには、[質問する] フィールドに質問を入力します。
  • ダッシュボード エージェントの会話ペインを開くには、open_in_full [**全画面表示**] を選択します。
  • ダッシュボード エージェントとの最近の会話にアクセスするには、more_vert [メニュー] > [最近の会話] を選択します。
  • デフォルトでは、会話には最初の質問に基づいて名前が付けられます。会話の名前を変更するには、[最近の会話] メニュー オプションから会話を選択し、more_vert を選択して、edit [名前を変更] を選択します。
  • データ エージェントとの会話を削除するには、more_vert [Menu] > delete [Trash] を選択します。

ダッシュボード エージェントを変更する

ダッシュボード エージェントに関する情報を編集するには、 tune [エージェントを管理] を選択します。

必要に応じて、[エディタ] タブで [詳細オプション] を展開して、次の設定を構成できます。

  • [**思考を表示**]: この切り替えをオンにすると、エージェントの 推論ステップ、生成された Looker クエリ、基になる データテーブルが回答に表示されます。
  • [**デバッグ情報を表示**]: この切り替えをオンにすると、トラブルシューティングに役立つよう、 回答ごとにエージェントが実行したステップが表示されます。

[更新] を選択して、ダッシュボード エージェントへの変更を保存します。[プレビュー] タブを使用して、ダッシュボード エージェントへの変更をプレビューします。

エージェントの手順を記述する

データ エージェントのコア動作を定義する自由形式の手順を追加して、ユーザーのプロンプトを処理する前に考慮すべき基本的なコンテキストを提供できます。

[手順] フィールドで指定できるコンテキストの例を次に示します。

  • キーフィールド: 分析に最も重要なフィールド
  • 除外済みフィールド: データ エージェントが回避するフィールド
  • フィルタリングとグループ化: エージェントがデータのフィルタリングとグループ化に使用するフィールド
  • ペルソナ: エージェントに割り当てるロール、専門知識、キャラクター、トーン

エージェントの手順の記述に関するヒントとベスト プラクティスについては、Looker で会話分析を構成するためのベスト プラクティスのドキュメント ページをご覧ください。

Looker データに関する質問をする

新しい会話を開始すると、会話分析によって開始する質問が提案されます。質問は特定の形式にする必要はなく、特定の構文を使用する必要もありません。ただし、選択した Explore に関連している必要があります。

[質問する] フィールドに自然言語で質問を入力します。質問モードを選択して、send をクリックします。 クエリを送信した後、 [**回答を停止**] をクリックして、会話分析の回答をキャンセルできます。会話分析はクエリの実行を停止し、The query was cancelled. というメッセージを表示します。

質問できるタイプの詳細については、質問の制限事項をご覧ください。

質問モードを選択する

質問を送信するときに、[**高速**] と [**思考**] のオプションを含むプルダウン メニューから質問モードを選択できます。UI では、[高速] は迅速な回答を目的とし、[思考] は複雑な問題を解決することを目的としています。会話分析のデフォルトの質問モードは [思考] です。手動で変更しない限り、会話分析ではマルチターンの会話全体で同じ質問モードが維持されます。

高速モード

[高速] モードで質問すると、会話分析は自然言語クエリを、会話のダッシュボードまたは Explore の基盤となる LookML モデルで定義されている LookML パラメータに直接マッピングしようとします。会話分析は LookML の管理された定義に依存しているため、迅速に応答できます。また、推論は使用または表示されません。

たとえば、「先月の総収益はいくらでしたか？」というクエリは、total_revenue メジャーを選択して前月でフィルタするクエリにすばやく変換できます。

クエリでデータの特定の事実または事前定義された指標を要求する場合は、[高速] モードを選択します。

思考モード

[思考] モードは、LookML の直接検索を超える分析を必要とする、より複雑な分析リクエストを対象としています。このモードでは、エージェントはアプローチを「計画」し、使用するツールと結果の組み合わせ方を決定します。このモードでは、単一の SQL ベースのクエリでは実現できない、複数ステップの問題の解決や高度なデータ サイエンス タスクの実行が可能です。

データの理由を尋ねる場合、傾向を比較する場合、または複数のステップが必要になる可能性があるより複雑な分析リクエストを行う場合は、[思考] モードを選択します。 このモードは、エージェントをテストして、データソースの基盤となる LookML をどのように使用しているかを把握する場合にも特に役立ちます。

マルチターンの会話

会話を続けると、会話分析では以前の質問と回答が考慮されます。以前の回答に基づいて、結果をさらに絞り込むか、可視化タイプを変更することで、回答を構築できます。

質問の作成に関する詳細については、質問の制限事項をご覧ください。

会話内のクエリを管理する

データと会話するときに、実行中のアクティブなクエリ応答を停止するか、最新の質問とその回答を削除することで、会話を管理できます。

最新の質問を削除する

最新の質問とその回答を削除する手順は次のとおりです。

  1. 最新の質問にカーソルを合わせ、 [**メッセージを削除**] をクリックします。
  2. [メッセージを完全に削除しますか？] ダイアログで、[削除] をクリックして、質問とその回答を完全に削除します。

クエリ結果と計算について

会話分析では、クエリ結果と計算を理解するための次のパラメータが用意されています。

クエリの解釈方法を確認する

If you use [Thinking] mode to ask your question, you can see how Conversational Analytics reasoned through your query. 推論を確認するには、[思考を表示] オプションを開きます。推論を非表示にするには、[思考を非表示] をクリックします。

会話分析では、各クエリが分析され、応答方法が検討されます。クエリのキーワードを使用して、会話に関連付けられたデータセットのセマンティック レイヤから関連するディメンション、メジャー、その他のパラメータが推測され、クエリから実行する必要がある集計が解釈されます。[推論を表示]を開くと、会話分析によってクエリの解釈に使用された手順が書式なしテキストで表示されます。この説明には、会話分析でクエリが検討された時間も含まれます。

回答の計算方法を確認する

会話分析で回答がどのように生成されたか、または可視化がどのように作成されたかを確認するには、クエリ結果内の [どのように計算されましたか？] をクリックします。

[どのように計算されましたか？] をクリックすると、会話分析に [テキスト] セクションが表示されます。[テキスト] セクションには、会話分析で特定の回答にたどり着くまでに実行した手順が書式なしテキストで表示されます。この説明には、使用された未加工のフィールド名、実行された計算、適用されたフィルタ、並べ替え順序などの詳細が含まれます。

分析の詳細とデバッグ情報

会話に使用されるデータ エージェントで特定の詳細オプションが有効になっている場合、回答には次の詳細が含まれることがあります。

  • [思考を表示]: 有効にすると、エージェントの回答に 推論ステップ、生成された Looker クエリ、基になるデータ テーブルが表示されます。
  • [**デバッグ情報を表示**]: 有効にすると、エージェントの回答に、その回答に対してエージェントが実行したステップが表示されます。これは、トラブルシューティングに役立ちます。

これらの設定は、ダッシュボード エージェントを 変更するときに詳細オプションで構成します。

会話を管理する

各会話は、ダッシュボードの会話 [more_vert] [メニュー] の [最近の会話] セクションに残ります。会話の名前を変更したり、会話を削除したり、ゴミ箱フォルダから復元したりできます。

  • ダッシュボード エージェントとの最近の会話にアクセスするには、more_vert [メニュー] > [最近の会話] を選択します。
  • デフォルトでは、会話には最初の質問に基づいて名前が付けられます。会話の名前を変更するには、[最近の会話] メニュー オプションから会話を選択し、more_vert を選択して、edit [名前を変更] を選択します。
  • データ エージェントとの会話を削除するには、more_vert [Menu] > delete [Trash] を選択します。

会話を削除する

データ エージェントとの会話を削除するには、会話の more_vert その他メニューを選択し、delete [**削除**] を選択します。

会話を復元または完全に削除する

ゴミ箱から会話を復元または完全に削除する手順は次のとおりです。

  1. more_vert [**メニュー**] > delete [**ゴミ箱**] を選択します。

  2. [ゴミ箱] ペインで、復元または完全に削除する会話を見つけます。会話の more_vert その他メニューを選択し、次のいずれかのオプションを選択します。

    • [**復元**]: 会話を復元します。会話には、 [Recent conversations] メニュー オプションからアクセスできます。
    • [**完全に削除**]: 会話を完全に削除します。

既知の制限事項

会話分析ダッシュボード エージェントには、次の既知の制限事項があります。

  • ダッシュボード エージェントでは高度な分析 はサポートされていません。
  • ダッシュボード エージェントは、ダッシュボード データのプロダクション モードにクエリを実行します。
  • ダッシュボード エージェントはダッシュボードの共有モデルを継承します。エージェントへのアクセスは、基盤となるダッシュボードへのアクセスに則って管理されます。
  • LookML ダッシュボード エージェントのコンテキストまたは手順を変更することはできません。

可視化の制限事項

会話分析では、Vega-lite を使用して会話グラフを生成します。次の Vega グラフタイプが完全にサポートされています。

  • 折れ線グラフ（1 つ以上の系列）
  • 面グラフ
  • 棒グラフ（横、縦、積み上げ）
  • 散布図（1 つ以上のグループ）
  • 円グラフ

次の Vega グラフタイプはサポートされていますが、レンダリング時に予期しない動作が発生する可能性があります。

  • マップ
  • ヒートマップ
  • ツールチップ付きのグラフ

Vega カタログ外のグラフタイプは対象外です。このセクションで指定されていないグラフはサポート対象外とみなされます。

データソースの制限事項

会話分析には、次のデータソースの制限があります。

  • 会話分析では、クエリごとに最大 5,000 行を返すことができます。
  • 会話分析では、LookML の parameter パラメータまたは filter パラメータを使用して定義されたフィルタ限定のフィールドの値を設定できません。

質問の制限事項

会話分析では、1 つの可視化で回答できる質問をサポートしています。例:

  • 指標の推移
  • ディメンション別の指標の内訳または分布
  • 1 つ以上のディメンションの一意の値
  • 単一の指標値
  • 指標別の上位のディメンション値

会話分析では、次のタイプの複雑な可視化でのみ回答できる質問をまだサポートしていません。

  • 予測
  • 相関分析や異常検出などの高度な統計分析