Query Insights は、Looker の生成 AI 拡張機能です。Explore で作成したクエリ結果を自然言語で要約し、データの概要やインサイトを生成します。これにより、専門的な知識がなくてもデータの内容を容易に把握でき、複雑なクエリ結果も直感的に理解できるようになります。

[補足] Looker の 生成 AI 拡張機能

Looker では、Query Insights の他にも様々な生成 AI 拡張機能が提供されています。以下の記事もぜひご覧ください。

• 自然言語でデータを可視化できるLookerのExplore Assistantを試してみた
• Looker の生成 AI 拡張機能 Dashboard Summarization を試す

Query Insightsのソースコードは、GitHub で公開されています。本記事では、GitHub のLooker Query Insights Extension を参照しながら、以下の手順で Query Insights の構築と機能の確認を行います。

1. バックエンドの構築
2. フロントエンドの構築
3. 動作確認

 
さらに、日本語環境で Looker を利用するユーザーのために、Query Insights を日本語に対応させる方法もご紹介します。
 

構築前の準備

Query Insights を構築する前に、以下の環境が整っていることを確認してください。

• Google Cloud プロジェクト: バックエンドを構築するために使用します。
• サービスアカウント: Looker が Google Cloud に接続するために使用します。
• Looker 空のプロジェクト: Query Insights を設定するために使用します。

まず、バックエンドの構築から始めましょう。GitHub の Query Insights Backend の手順に従い、リポジトリからクローンしたソースコードを Terraform でデプロイします。
 

1. GitHub リポジトリからソースコードをクローンします。

git clone https://github.com/looker-open-source/looker-query-insights.git

2. terraform ディレクトリに移動します。

cd looker-query-insights/query-insights-backend/terraform

3. 環境変数を定義します。スクリプトのプレースホルダは実際の値に置き換えてください。今回は Windows を使用するため、set コマンドを用いて環境変数を定義します。

set TF_VAR_project_id=<PROJECT_ID>

set TF_VAR_service_account=<LOOKER BIGQUERY SA>

4. バックエンドをデプロイします。

terraform init

terraform plan

terraform apply

5. バックエンドが正常にデプロイされているかテストします。BigQuery のクエリエディタで次のクエリを実行します。

SELECT ml_generate_text_llm_result AS generated_content

FROM

ML.GENERATE_TEXT(

    MODEL `query_insights.query_insights_llm`,

    (

      SELECT "hi" as prompt

    ),

    STRUCT(

    0.05 AS temperature,

    1024 AS max_output_tokens,

    0.98 AS top_p,

    TRUE AS flatten_json_output,

    1 AS top_k)

  )

[補足] モデルが見つからないというエラーが発生した場合

クエリ実行時に Not found: Model project-id:query_insights.query_insights_llm というエラーメッセージが表示された場合は、以下の手順を試してみてください。

1. Google Cloud コンソールを開き、BigQuery に移動します。
2. 画面下部にある「ジョブ履歴」を開きます。
3. ジョブの一覧から「create_looker_llm_model-yyyymmddhhmmss」という ID のジョブを探して選択します。
4. 選択したジョブの詳細画面でクエリをコピーし、クエリエディタで実行します。
5. 再度テストクエリを実行し、正常に動作するか確認します。

続いて、Query Insights Extension Frontend Deployment の手順に従い、フロントエンドの構築を行います。リポジトリからクローンしたフロントエンドのソースコードをビルドし、生成されたファイルをLooker にアップロードします。その後、Looker Extension の設定を行い、Looker で使用できるようにします。
 

フロントエンドのソースコードをビルドする

1. query-insights-extension ディレクトリに移動します。

cd query-insights-extension

2. 依存関係をインストールします。

npm install

3. .env ファイルを作成します。.env_example ファイルをコピーして .env ファイルとして保存します。ファイルに実際の値を設定します。

[補足] モデル ID の確認

予測に使用するモデル ID は BigQuery から確認できます。

1. Google Cloud コンソールを開き、BigQuery に移動します。
2. 左側のナビゲーションメニューからデータセット「query_insights」を選択します。
3. データセット内にある「モデル」の一覧から、「query_insights_llm」を選択します。
4. モデルの詳細画面から「モデル ID」を確認します。

4. フロントエンドのソースコードをビルドします。今回は Windows を使用するため、package.json ファイルの build コマンドのスクリプトを次のように修正します。

"scripts": {

  // その他処理

 "build": "set BABEL_ENV=build && webpack --config webpack.prod.js",

  // その他処理

ソースコードをビルドします。ビルドが完了すると、dist フォルダの中に bundle.js という名前のビルド済みファイルが生成されます。

npm run build

Looker で接続を作成する

BigQuery サービス アカウントによる認証 および Looker の BigQuery への接続 の手順に従い、Looker の接続を作成します。サービスアカウントは準備済みのサービスアカウントを使用します。また、接続名は「フロントエンドのソースコードをビルドする」で指定した接続名を使用してください。
 

Looker Extension を設定する

1. Looker にログインし、左側のナビゲーションメニューにある「開発」を選択します。準備済みの Looker の空プロジェクトを選択します。

2.「フロントエンドのソースコードをビルドする」で生成した bundle.js ファイルを、Looker プロジェクトのファイルブラウザにドラッグ＆ドロップしてアップロードします。

3. query-insights-extension フォルダにある manifest.lkml ファイルを Looker プロジェクトのファイルブラウザにドラッグ＆ドロップしてアップロードします。

4. モデルを作成し、何らかの接続にアクセスできるよう接続を追加します。モデルは使用されないため、任意の接続を追加していただいて構いません。また、警告が表示される include 行はコメントアウトしておきましょう。

connection: "connection_name"



# include: "/views/*.view.lkml"                # include all views in the views/ folder in this project

# include: "/**/*.view.lkml"                 # include all views in this project

# include: "my_dashboard.dashboard.lookml"   # include a LookML dashboard called my_dashboard



# # Select the views that should be a part of this model,

# # and define the joins that connect them together.

#

# explore: order_items {

#   join: orders {

#     relationship: many_to_one

#     sql_on: ${orders.id} = ${order_items.order_id} ;;

#   }

#

#   join: users {

#     relationship: many_to_one

#     sql_on: ${users.id} = ${orders.user_id} ;;

#   }

# }

5. Git を構成します。今回は Bare リポジトリを使用します。

6. 変更をコミットし、本番環境にデプロイします。
 

最後に、GitHub の Usage を参照に Query Insights の動作確認を行います。
 

1. Looker の Explore でデータ分析用のクエリを作成します。今回は BigQuery の公開データセットである theLook eCommerce を使用し、国・年齢層ごとのユーザー数を集計するクエリを実行します。

2. ビジュアリゼーションタイプとして「Query Insights」を選択します。

3. クエリ結果が自然言語で要約され、データの概要が生成されます。

“このデータは、年齢層と国別に分類されたユーザーの分布を示しています。すべての年齢層において、中国が最も多くのユーザー数を誇り、次いでアメリカとブラジルが続きます。どの国においても、ユーザーの大半は20歳から59歳の年齢層に集中しており、70歳以上の層では大きく減少しています。”

LLM をカスタマイズする

Query Insights は LLM の振る舞いをカスタマイズできます。LLM タブでは、以下の 3 つのパラメータを使用して生成される出力を調整できます。

1. モデルの Temperature: 生成される出力の変動性を調整します。
2. プロンプトタイプ:「要約」または「感情分析」が選択でき、出力の目的を設定します。
3. クエリの説明 / コンテキスト: 特定の指示や情報を追加します。LLM に送信されるプロンプトに追加されます。

 
例えば、LLM タブの「3. Set Query Description / Context」のフィールドに、次のように入力して Query Insights を再度動作させてみましょう。

絵文字を交えてカジュアルなトーンで回答してください。

絵文字を交えたカジュアルなトーンで回答が出力されました。このように Query Insights は出力スタイルを柔軟に制御できるので、ニーズに合わせてカスタマイズしてみてください。
 

Query Insights は、デフォルトでは英語でのインタフェース表示および回答が出力されます。そのため、日本語環境で Looker を利用するユーザーにとっては、そのままでは活用しにくい場合があります。そこで、Query Insights を日本語に対応させる方法をご紹介します。
 

回答の日本語化

Query Insights が出力する回答を日本語に対応させる方法はいくつかあります。1 つは、LLM タブの「3. Set Query Description / Context」のフィールドに日本語で回答するよう指示を追加する方法です。この方法はお手軽ですが、クエリを実行するたびに入力する必要があります。

そこで、恒常的に回答を日本語化するために、LLM に送信されるデフォルトのプロンプト自体に日本語で回答するよう指示を追加する方法をご紹介します。プロンプトは、looker-query-insights/query-insights-extension/src/composables/useLookerVertexMessage.js ファイル内に記述されています。

const sendMessage = async (fields, data, type, temperature, additionalContext) => {

  loading.value = true;

  const truncatedData = truncateDataForLLM(data, maxRows, tokenLimit, estimateTokens)

  const contents = `

    Context

    ----------



    You are a developer who will either provide a rich summary or analyze the sentiment of given a query's result set and some metadata in a paragraph and under 50 words. 

    You must answer in Japanese. // この行を追加します。

      

    Instructions:

      - use the Type to inform what action to perform

     // その他処理

インタフェースの日本語対応

Query Insights のインタフェースを日本語に対応させるには、looker-query-insights/query-insights-extension/src/constants.js ファイルを次のように置き換えます。

export const vizConfigSettings = {

    temperature: {

        type: "number",

        label: "1. モデルの Temperature",

        display: "number",

        default: 0.2,

        required: true,

        section: 'LLM'

    },

    prompt: {

        type: "string",

        label: "2. プロンプトタイプ",

        values: [{ 要約: "summarize" }, { 感情分析: "sentiment" }],

        display: "radio",

        default: "summarize",

        required: true,

        section: 'LLM'

    },

    query: {

        type: "string",

        label: "3. クエリの説明 / コンテキスト",

        display: "text",

        required: false,

        section: 'LLM'

    },

    title: {

      order: 1,

      type: "string",

      label: "タイトル",

      display: "text",

      required: false,

      section: "表示"

    },

    themeColor: {

      order: 2,

      type: "array",

      label: "テーマカラー",

      display: "colors",

      section: "表示"

    },

    backgroundColor: {

        type: "array",

        label: "背景色",

        display: "color",

        section: "表示"

    },

    cardColor: {

      type: "array",

      label: "カードの色",

      display: "color",

      section: "表示"

    },

    headerColor: {

        type: "array",

        label: "ヘッダーの色",

        display: "color",

        section: "表示"

    },

    textColor: {

      type: "array",

      label: "テキストの色",

      display: "color",

      section: "表示"

    },

    shadowColor: {

      type: "array",

      label: "影の色",

      display: "color",

      section: "表示"

    },

    insightImage: {

      type: "string",

      label: "画像 URL",

      default: "https://img.icons8.com/ios/50/light-on--v1.png",

      section: "表示"

    }

  }

本記事では、Google Cloud の Looker の生成 AI 拡張機能 Query Insights を構築し、機能を試してみました。この拡張機能を使用することで、専門的な知識がなくてもデータの内容を容易に把握でき、複雑なクエリ結果も直感的に理解できるようになります。データ分析の効率を上げたい方は、ぜひ Query Insights を活用してみてください。