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 ダッシュボードのエージェントの動作を制御します。

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

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

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

- dashboard: executive_sales_overview
  title: "Executive Sales Overview"
  layout: newspaper
  enabled_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent

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

enabled_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. スパーク [**このダッシュボードとチャット**] アイコンを選択して、チャットパネルを開きます。
  5. 質問して、エージェントがプロンプトをどのように解釈して応答するかをテストします。

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

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

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

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

ユーザー定義ダッシュボードから LookML をコピーする手順は次のとおりです。

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

エクスポートされた LookML は、enabled_dashboard_agent パラメータ値とカスタム エージェントの手順を使用して、[ダッシュボードとのチャットを有効にする] 切り替えボタンの状態を保持します。

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

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

  1. スパーク アイコン [**このダッシュボードとチャット**] を選択します。
  2. チューニング アイコン [**エージェントを管理**] を選択します。

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

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

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

LookML ダッシュボード エージェントとの会話を開始する手順は次のとおりです。

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

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

会話を管理する

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

LookML ダッシュボード エージェントの制限事項

LookML ダッシュボード エージェントには次の制限があります。

  • LookML でのみ定義: LookML ダッシュボード エージェントは LookML で宣言する必要があります。Looker UI で作成、構成、編集することはできません。
  • 同じプロジェクトの要件: エージェントは、それを参照するダッシュボードと同じ LookML プロジェクトで定義する必要があります。
  • ダッシュボードごとに 1 つのエージェント: LookML ダッシュボードに関連付けることができるダッシュボード エージェントは 1 つだけです。
  • ダッシュボード エージェントのみ: LookML では、Explore データ エージェントの作成はサポートされていません。LookML のすべての agent 宣言には is_dashboard_agent: yes を含める必要があります。