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

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

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

始める前に

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

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

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

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

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

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

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

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

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

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

会話のメタデータ

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

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

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

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

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

  • 高度な分析を有効にする: この設定をオンにすると、エージェントは高度な分析を使用できます。これにより、自然言語の質問が Python コードに変換され、そのコードが実行されて高度な分析と可視化が提供されます。この設定は、インスタンスの [Gemini in Looker] 管理ページで [高度な分析] 管理設定が有効になっている場合にのみ表示されます。
  • 思考を表示: この切り替えをオンにすると、エージェントは各会話のすべての回答で、推論ステップ、生成された 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] メニュー オプションからアクセスできます。
    • 完全に削除: 会話を完全に削除します。