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

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

LookML ダッシュボード用のデータ エージェントを使用すると、デベロッパーは、カスタマイズされたビジネス ロジック、カスタム指示、分析設定を LookML で管理されるダッシュボードに挿入できます。各ダッシュボードには、ダッシュボードとチャットする権限を持つすべてのユーザーが利用できる、単一の共有デフォルト エージェントが用意されています。LookML ダッシュボードは、組織全体で管理され、バージョン管理された信頼できる情報源を表すため、LookML ダッシュボード エージェントは、AI のインタラクションが環境間で一貫性を保ち、組織のデータ標準に準拠するようにします。

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

始める前に

会話分析を使用してダッシュボード データを操作する前に、Looker インスタンスの設定と要件が満たされていること、このページで説明するタスクを実行するための適切な権限が付与されていることを確認してください。

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

Development Mode がオンになっている場合、会話型分析は、開発ブランチのインメモリ エージェント定義、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 ダッシュボードの場合、[エージェントを管理] パネルには、エージェントの指示、Advanced Analytics のステータス、デバッグ オプションが読み取り専用モードで表示されます。設定は UI 内で直接編集できません。

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

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

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

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

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

会話を管理する

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

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 ダッシュボード エージェントの構成に加えられた変更のうち、まだ本番環境にデプロイされていないものを無視します。