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

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

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

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

始める前に

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

  • インスタンスの要件: Looker 管理者は、[Gemini in Looker] 管理ページで会話型分析を有効にする必要があります。管理者は、[Trusted Tester の機能を有効にする] と [ダッシュボード エージェントを有効にする] の設定もオンにする必要があります。ダッシュボード エージェントの高度な分析: 高度な分析の管理者設定も有効にする必要があります。この設定は、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 ダッシュボードのエージェントは、検証済みクエリをサポートしていません。

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

次の例では、特定のフィルタリング ルールとトーンを適用する 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. @{<var>CONSTANT_NAME</var>} 構文を使用して、ダッシュボード エージェントの instructions パラメータで定数を参照します。

    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 が指定されていない場合でも、ユーザーはダッシュボードとチャットできます。エージェントはカスタム手順なしで実行されます。

開発モードで LookML ダッシュボード エージェントをテストする

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

開発モードで LookML ダッシュボード エージェントの変更をテストするには、次の操作を行います。

  1. エージェントに少なくとも 1 つのベースライン定義が本番環境にデプロイされていることを確認します。
  2. Development Mode をオンにします。
  3. LookML ファイルでエージェントの instructions または設定を編集し、変更を保存します。
  4. Looker UI で LookML ダッシュボードを開きます。
  5. スパークル アイコン [チャットでこのダッシュボードを確認] を選択して、チャット パネルを開きます。
  6. エージェントがプロンプトをどのように解釈して応答するかをテストするために質問します。

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

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

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

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

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

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

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

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

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

  1. spark アイコン [チャットでこのダッシュボードを確認] を選択します。
  2. [tune] エージェントを管理を選択します。

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

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

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

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

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

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

会話を管理する

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

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

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

  • LookML でのみ定義: LookML ダッシュボード エージェントは LookML で宣言する必要があります。Looker UI で作成、構成、編集することはできません。
  • 検証済みクエリはサポートされていません: LookML ダッシュボードのデータ エージェントは、検証済みクエリをサポートしていません。
  • 同じプロジェクトの要件: エージェントは、それを参照するダッシュボードと同じ LookML プロジェクトで定義する必要があります。
  • ダッシュボードごとに 1 つのエージェント: LookML ダッシュボードに関連付けることができるダッシュボード エージェントは 1 つだけです。
  • ダッシュボード エージェントのみ: LookML では、Explore データ エージェントの作成はサポートされていません。LookML のすべての agent 宣言に is_dashboard_agent: yes を含める必要があります。
  • Looker 26.14 の高度な分析: Looker 26.14 の LookML ダッシュボード エージェントは advanced_analytics パラメータをサポートしていません。
  • 開発モードと未デプロイのエージェント: 開発モードで LookML ダッシュボード エージェントの構成に加えた変更は、まだ本番環境にデプロイされていない場合、会話インターフェースで無視されます。