ダッシュボード エージェントを使用してユーザー定義のダッシュボードにクエリを実行する

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

このページでは、Conversational Analytics を使用してユーザー定義のダッシュボードのデータを操作する方法について説明します。ここでは次のトピックを扱います。

始める前に

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

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

ユーザー定義のダッシュボード内からダッシュボード エージェントとの会話を開始するには、スパーク アイコン [このダッシュボードでチャットを開始] を選択します。

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

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

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

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

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

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

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

会話のメタデータ

[このダッシュボードとチャット] ペインでは、ユーザー定義ダッシュボードに対して次のタスクを実行できます。

  • ダッシュボードのデータについて質問するには、[質問する] フィールドに質問を入力します。
  • ダッシュボード エージェントの情報を編集するには、チューニング エージェントの管理を選択します。[エディタ] タブで、エージェントの手順を入力し、[詳細オプション] を開いて [思考を表示] や [デバッグ情報を表示] などの設定を構成できます。[更新] を選択して、ダッシュボード エージェントに対する変更を保存します。[プレビュー] タブを使用して、ダッシュボード エージェントに対する変更をプレビューします。
  • ダッシュボードのエージェントの会話ペインを拡大するには、open_in_full [全画面表示] を選択します。
  • ダッシュボード エージェントとの最近の会話にアクセスするには、more_vert [メニュー] > [最近の会話] を選択します。
  • デフォルトでは、会話には最初の質問に基づいて名前が付けられます。会話の名前を変更するには、[最近の会話] メニュー オプションから会話を選択し、more_vert を選択してから、[編集] [名前を変更] を選択します。
  • データ エージェントとの会話を削除するには、more_vert [メニュー] > [削除] ゴミ箱アイコンを選択します。

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

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

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

  • 高度な分析を有効にする: この設定をオンにすると、エージェントが高度な分析を使用できるようになります。高度な分析では、自然言語の質問が Python コードに変換され、そのコードが実行されて高度な分析と可視化が行われます。この設定は、インスタンスの [Gemini in Looker] 管理ページで [高度な分析] 管理設定が有効になっている場合にのみ表示されます。
  • 思考を表示: この切り替えをオンにすると、エージェントは各会話のすべての回答で、推論ステップ、生成された Looker クエリ、基になるデータテーブルを表示できます。
  • デバッグ情報を表示: この切り替えをオンにすると、エージェントは各会話のすべての回答について、実行したステップを表示できます。

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

エージェントへの指示を作成する

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

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

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

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

Looker データについて質問する

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

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

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

質問モードを選択する

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

高速モード

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

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

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

思考モード

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

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

マルチターンの会話

会話分析では、会話を続けるにつれて、以前の質問と回答が考慮されます。以前の回答を基に、結果を絞り込んだり、ビジュアライゼーションのタイプを変更したりして、回答をさらに調整できます。

質問の作成に関するその他のガイダンスについては、質問の制限事項をご覧ください。

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

データとの会話では、実行中のアクティブなクエリのレスポンスを停止したり、最新の質問とそのレスポンスを削除したりして、会話を管理できます。

最新の質問を削除する

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

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

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

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

クエリがどのように解釈されたかを確認する

思考モードを使用して質問すると、会話分析がクエリをどのように推論したかを確認できます。理由を確認するには、[思考を表示] オプションを開きます。理由を非表示にするには、[思考を非表示] をクリックします。

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

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

Conversational Analytics が回答を導き出した方法や、可視化を作成した方法を確認するには、クエリ結果内の [算出方法] をクリックします。

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

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

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

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

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

会話を管理する

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

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

会話を削除する

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

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

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

  1. more_vert [メニュー] > [削除] [ゴミ箱] を選択します。
  2. [ゴミ箱] ペインで、復元または完全に削除する会話を見つけます。会話の more_vert その他メニューを選択し、次のいずれかのオプションを選択します。
    • 復元: 会話を復元します。会話には、 [Recent conversations]（最近の会話）メニュー オプションからアクセスできます。
    • [完全に削除]: 会話を完全に削除します。