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

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 [メニュー] > [削除] [ゴミ箱] を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

質問できる質問の種類については、質問の制限事項をご覧ください。

質問モードを選択する

質問するときに、次のオプションを含むプルダウン メニューから質問モードを選択できます。

  • 高速（デフォルト）: ほとんどの質問に最適です。
  • 思考: 詳細な推論。

会話分析のデフォルトの質問モードは [高速] です。会話分析では、手動で変更しない限り、複数ターンの会話全体で同じ質問モードが維持されます。

高速モード

高速モードはほとんどの質問におすすめで、デフォルトで選択されています。[高速] モードでは、会話型分析は、会話のダッシュボードまたは Explore の基盤となる LookML モデルで定義されている LookML パラメータに自然言語クエリを直接マッピングします。会話型分析は、思考やチャットでの思考の要約のストリーミングに余分なトークンを費やすことなく、迅速に応答します。

高速モードのクエリは、思考モードのクエリと同じレベルの精度を提供します。エージェントの推論プロセスを特に確認したい場合を除き、質問には [高速] モードを使用します。

思考モード

思考モードでは、エージェントはリクエストを検討するために追加のトークンを使用し、クエリの処理中に思考の要約をチャットに直接ストリーミングします。これにより、エージェントの詳細な推論の手順を確認できます。

思考モードでは、高速モードよりも正確な回答が生成されるわけではありませんが、エージェントの推論を表示することで、会話分析がクエリを解釈し、分析ステップを計画し、基盤となる LookML モデルを参照する方法を確認できます。

エージェントの詳細な推論ステップを検査する場合や、エージェントがデータソースとどのようにやり取りするかをテストする場合で、推論に必要な追加トークンを使用する場合は、[Thinking] モードを選択します。

マルチターンの会話

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

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

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

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

最新の質問を削除する

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

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

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

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

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

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

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

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

Conversational Analytics が回答を導き出した方法やビジュアリゼーションを作成した方法を確認するには、クエリ結果内の [算出方法] をクリックします。

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

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

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

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

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

会話を管理する

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

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

会話を削除する

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

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

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

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