LookML ダッシュボードのデータ エージェントを作成して管理する

Gemini for Google Cloud を活用した会話分析を使用すると、直感的なチャット インターフェースで会話形式の言語で質問してデータを調査できます。 LookML ダッシュボードで会話分析を使用する場合は、バージョン管理された LookML コードでダッシュボード データ エージェントを直接定義してカスタマイズ できます。

LookML ダッシュボード エージェントを使用すると、デベロッパーは、LookML で管理されるダッシュボードに、カスタマイズされたビジネス ロジック、カスタム手順、分析設定を挿入できます。 LookML ダッシュボードは、組織全体で管理され、バージョン管理された信頼できる唯一の情報源を表すため、LookML ダッシュボード エージェントを使用すると、AI のインタラクションが環境間で一貫性を保ち、組織のデータ標準に準拠します。

このページでは、次のトピックについて説明します。

始める前に

LookML ダッシュボード エージェントを構成または使用する前に、次の要件を満たしていることを確認してください。

  • インスタンスの要件: Looker 管理者は、 [会話分析] を [Gemini in Looker] 管理ページで有効にする必要があります。管理者は、[Trusted Tester の機能を有効にする] 設定と [ダッシュボード エージェントを有効にする] 設定もオンにする必要があります。 [Advanced Analytics] ダッシュボード エージェントの高度な分析を使用するには、[Advanced Analytics] 管理設定も有効にする必要があります。この設定は、Looker 26.14 の LookML ダッシュボード エージェントには適用されません。
  • デベロッパーの権限: LookML ダッシュボード エージェントとダッシュボードを作成、編集、構成するには、develop 権限と see_lookml_dashboards 権限を持つ Looker ロールと、ダッシュボードの基盤となるLookML モデル へのアクセス権が必要です。
  • 閲覧者の権限: LookML ダッシュボード エージェントとチャットするには、ユーザー に see_lookml_dashboards 権限と、ダッシュボード タイルの基盤となる LookML モデルへのアクセス権が必要です。

LookML でダッシュボード エージェントを定義する

LookML でダッシュボード エージェントを定義するには、プロジェクト内の LookML モデルファイルまたは専用の LookML ファイルで agent パラメータを宣言します。

LookML ダッシュボード エージェントの定義では、次の構文を使用します。

agent: agent_name {
  advanced_analytics: yes | no
  description: "Description of the agent"
  instructions: "Custom agent prompt and instructions"
  is_dashboard_agent: yes
  show_debuginfo: yes | no
  show_thinking: yes | no
}

ダッシュボード エージェントは、次の LookML パラメータをサポートしています。

  • agent: 新しいエージェントを宣言し、その名前を定義します。
  • advanced_analytics:（省略可）yes または no を受け入れます（デフォルトは no）。 yes に設定すると、エージェントは 高度な分析 を使用して、自然言語の質問を Python コードに変換し、そのコードを実行して 高度な計算と可視化を行うことができます。このパラメータは LookML ダッシュボード エージェントで使用できますが、Looker 26.14 では機能しません。
  • description:（省略可）エージェントの簡単な説明。
  • instructions:（省略可）クエリに回答する際にエージェントをガイドする、自由形式の手順とビジネス コンテキストを提供する文字列。省略した場合、エージェントはカスタム プロンプト コンテキストなしでデフォルトの会話処理を使用します。
  • is_dashboard_agent:（ダッシュボード エージェントに必須）yes に設定すると、エージェントがダッシュボード エージェントとして明確に識別されます。
  • show_debuginfo:（省略可）yes または no を受け入れます（デフォルトは no）。 yes に設定すると、エージェントは会話のレスポンスに詳細な実行情報とトラブルシューティング 情報を表示します。
  • show_thinking:（省略可）yes または no を受け入れます（デフォルトは no）。 yes に設定すると、エージェントは 会話のレスポンスにステップごとの推論プロセスを表示します。

ダッシュボード エージェントの定義例

次の例では、特定のフィルタリング ルールとトーンを適用する LookML ダッシュボード エージェントを定義します。

agent: sales_dashboard_agent {
  instructions: "Focus on revenue metrics. Always filter by the current fiscal year unless the user specifies otherwise."
  description: "LookML Dashboard Agent for sales performance analytics."
  is_dashboard_agent: yes
  advanced_analytics: yes
  show_thinking: yes
  show_debuginfo: no
}

エージェントの手順で LookML 定数を使用する

組織全体で複数の LookML ダッシュボードを管理している場合は、 LookML 定数を使用して、 標準のビジネスルール、用語集、フィルタリング要件をエージェント 定義間でテキストを重複させることなく共有できます。

エージェントの手順で定数を使用する手順は次のとおりです。

  1. プロジェクトの manifest.lkml ファイルで定数を定義します。

    constant: FISCAL_YEAR_RULE {
  value: "Always filter all requests by the current fiscal year unless the user explicitly specifies a different timeframe."
}

  2. ダッシュボード エージェントの instructions パラメータで定数を参照します using @{<var>CONSTANT_NAME</var>} 構文:

    agent: finance_dashboard_agent {
  instructions: "Prioritize gross margin and operating expense metrics. @{FISCAL_YEAR_RULE}"
  is_dashboard_agent: yes
  advanced_analytics: yes
}

エージェントがクエリを処理すると、Looker は定数文字列をエージェントの手順に動的に置き換えます。

ダッシュボード エージェントと LookML ダッシュボードを関連付ける

ダッシュボード エージェントを LookML ダッシュボードにアタッチするには、.dashboard.lookml ファイルでダッシュボード レベルのパラメータを構成します。

次のダッシュボード パラメータは、LookML ダッシュボードでのエージェントの動作を制御します。

  • enable_dashboard_agent:（省略可）true または false を受け入れます。ユーザーが スパーク Chat with this dashboardアイコンを表示してダッシュボード エージェントとやり取りできるかどうかを決定します。 省略した場合、このパラメータは API レイヤでデフォルトで true になります。
  • default_dashboard_agent:（省略可）ダッシュボードのデフォルト エージェントとして機能する LookML エージェントの名前（agent パラメータで定義）を指定します。
  • dashboard_agents:（省略可）ダッシュボードで使用できるエージェント名のリスト。

LookML ダッシュボード構成の例

次のスニペットは、sales_dashboard_agent を LookML ダッシュボードにマッピングする方法を示しています。

- dashboard: executive_sales_overview
  title: "Executive Sales Overview"
  layout: newspaper
  enable_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent
  dashboard_agents: [sales_dashboard_agent, regional_sales_agent]

  elements:
  - name: total_revenue_by_quarter
    type: looker_column
    model: sales_ops
    explore: orders
    measures: [orders.total_revenue]
    dimensions: [orders.created_quarter]

enable_dashboard_agent が true に設定されていて、default_dashboard_agent が指定されていない場合でも、ユーザーはダッシュボードとチャットできます。エージェントはカスタム手順なしで実行されます。

Development Mode で LookML ダッシュボード エージェントをテストする

LookML デベロッパーは、変更を本番環境にデプロイする前に、エージェントの手順を繰り返し変更し、Looker UI でレスポンスを直接テストできます。

Development Mode で LookML ダッシュボード エージェントをテストするには:

  1. Development Mode をオンにします。
  2. LookML ファイルでエージェントの instructions または設定を編集し、変更を保存します。
  3. Looker UI で LookML ダッシュボードを開きます。
  4. spark Chat with this dashboard を選択して、チャットパネルを開きます。
  5. 質問して、エージェントがプロンプトをどのように解釈して応答するかをテストします。

Development Mode がオンの場合、会話分析は開発ブランチのインメモリ エージェント定義、LookML ダッシュボード定義、モデルファイルを参照します。Development Mode をオフにすると、会話分析はプロダクション ブランチからデプロイされた定義を参照するように戻ります。

Development Mode で作成された会話履歴は永続化され、セッション間で最近の会話リストに表示されます。

ユーザー定義ダッシュボードからダッシュボード エージェント LookML をコピーする

UI でダッシュボードをユーザー定義のダッシュボードとしてプロトタイプを作成する場合は、ダッシュボード エージェントの設定や手順など、完全な構成を LookML コードにエクスポートできます。

ユーザー定義のダッシュボードから LookML をコピーするには:

  1. ユーザー定義のダッシュボードを開きます。
  2. その他アイコン more_vert [ダッシュボード アクション] メニューを選択し、[Get LookML] を選択します。
  3. [Get LookML] ダイアログで、生成されたダッシュボード LookML とダッシュボード エージェント定義コードをコピーします。
  4. ダッシュボード LookML を .dashboard.lookml ファイルに貼り付け、agent ブロックをモデルまたはエージェントの LookML ファイルに貼り付けます。

エクスポートされた LookML は、enable_dashboard_agent パラメータを使用して [Enable chat with dashboard] 切り替えの状態を保持し、カスタム エージェントの手順をコピーします。

Looker UI でエージェントの詳細を表示する

アクティブなダッシュボード エージェントを使用して LookML ダッシュボードを表示する場合は、チャットパネルからエージェント構成を確認できます。

  1. スパーク Chat with this dashboard を選択します。
  2. [tune] [Manage agent] を選択します。

LookML ダッシュボードの場合、[Manage agent] パネルには、エージェントの手順、高度な分析のステータス、デバッグ オプションが読み取り専用 モードで表示されます。UI 内で設定を直接編集することはできません。

構成を編集するには、基盤となるモデルに対する develop 権限を持つデベロッパーが [Edit in LookML] をクリックして、IDE の関連する LookML ファイルに直接移動します。

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

LookML ダッシュボード エージェントとの会話を開始するには:

  1. LookML ダッシュボードを開きます。
  2. スパーク Chat with this dashboard を選択します。
  3. [Ask a question] フィールドに、自然言語でクエリを入力します。
  4. ダッシュボード エージェントで show_thinking が許可されている場合は、質問モードを選択できます。
    • 高速: クエリを直接 LookML 指標ルックアップにすばやく変換します。
    • 思考: 複雑な分析に関する質問を評価し、ステップごとの 推論を表示します。
  5. [send] [Send] をクリックします。

進行中のクエリをキャンセルするには、 [レスポンスを停止] をクリックします。

会話を管理する

  • 最近の会話: 以前の会話を開くには、 more_vert [メニュー] > [最近の会話] を選択します。
  • 会話の名前を変更する: 会話の横にあるmore_vert を選択し、edit [名前を変更]を選択します。
  • 会話を削除する: 会話の横にあるmore_vert を選択し、delete [削除]を選択します。