為 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 使用者介面中，反覆修改代理指令並測試回覆，然後再將變更部署至正式環境。

如要從開發模式測試 LookML 資訊主頁代理的任何變更，請按照下列步驟操作：

  1. 確認代理至少已將基準定義部署至正式環境。
  2. 開啟「開發模式」。
  3. 在 LookML 檔案中編輯代理 instructions 或設定，然後儲存變更。
  4. 在 Looker UI 中開啟 LookML 資訊主頁。
  5. 選取「閃亮」「透過對話探索這個資訊主頁」，開啟對話面板。
  6. 提出問題，測試虛擬服務專員如何解讀及回應提示。

開啟開發模式後，對話式數據分析會參照開發分支中的記憶體內代理定義、LookML 資訊主頁定義和模型檔案。關閉開發模式後，對話式分析會還原為參考正式分支版本中已部署的定義。

在開發模式中建立的任何對話記錄都會保留，並顯示在各個工作階段的近期對話清單中。

從使用者定義資訊主頁複製資訊主頁代理 LookML

如果您在使用者介面中，將資訊主頁原型設計為使用者定義資訊主頁，可以將完整設定 (包括資訊主頁代理設定和操作說明) 匯出為 LookML 程式碼。

如要從使用者定義資訊主頁複製 LookML，請按照下列步驟操作：

  1. 開啟使用者定義資訊主頁。
  2. 選取三點圖示 more_vert「Dashboard actions」(資訊主頁動作) 選單，然後選取「Get LookML」(取得 LookML)。
  3. 在「Get LookML」(取得 LookML) 對話方塊中，複製產生的資訊主頁 LookML 和資訊主頁代理定義程式碼。
  4. 將資訊主頁 LookML 貼到 .dashboard.lookml 檔案，並將 agent 區塊貼到模型或代理 LookML 檔案。

匯出的 LookML 會保留「啟用與資訊主頁對話」切換按鈕的狀態，並使用 enabled_dashboard_agent 參數值和任何自訂代理程式指令。

在 Looker 使用者介面中查看代理程式詳細資料

查看 LookML 資訊主頁時，如果資訊主頁代理處於啟用狀態，您可以在對話面板中檢查代理設定：

  1. 選取「spark 透過對話探索這個資訊主頁」。
  2. 選取「tune」 「管理代理」

如果是 LookML 資訊主頁，「管理代理」面板會以「唯讀」模式顯示代理操作說明、Advanced Analytics 狀態和偵錯選項。您無法直接在使用者介面中編輯設定。

如要編輯設定，只要開發人員對基礎模型擁有 develop 權限，即可點選「在 LookML 中編輯」，直接前往 IDE 中的相關 LookML 檔案。

使用資訊主頁代理查詢 LookML 資訊主頁

如要與 LookML 資訊主頁代理展開對話，請按照下列步驟操作：

  1. 開啟 LookML 資訊主頁。
  2. 選取「spark」。
  3. 在「提出問題」欄位中，以自然語言輸入查詢。
  4. 如果資訊主頁代理允許使用 show_thinking，您可以選擇問題模式：
    • 快捷：快速將查詢內容轉換為直接的 LookML 指標查詢。
    • 思考型：評估複雜的分析問題，並逐步顯示推論過程。
  5. 按一下「傳送」。

如要取消進行中的查詢，請按一下「停止回覆」。

管理會話群組

  • 最近的對話：如要開啟先前的對話，請依序選取「更多」圖示 more_vert >「選單」>「最近的對話」。
  • 重新命名對話：選取對話旁的 more_vert，然後選取 edit「重新命名」。
  • 刪除對話：選取對話旁的 more_vert，然後選取「刪除」delete 「刪除」。

LookML 資訊主頁代理的限制

LookML 資訊主頁代理程式有下列限制：

  • 僅在 LookML 中定義：LookML 資訊主頁代理必須在 LookML 中宣告。您無法在 Looker 使用者介面中建立、設定或編輯這些項目。
  • 不支援已驗證的查詢：LookML 資訊主頁的資料代理不支援已驗證的查詢。
  • 同專案規定：代理程式必須定義在與參照該代理程式的資訊主頁相同的 LookML 專案中。
  • 每個資訊主頁只能有一個代理：一個 LookML 資訊主頁只能與一個資訊主頁代理建立關聯。
  • 僅限資訊主頁代理：LookML 不支援建立探索資料代理。LookML 中的所有 agent 宣告都必須包含 is_dashboard_agent: yes。
  • Looker 26.14 的進階數據分析：Looker 26.14 的 LookML 資訊主頁代理不支援 advanced_analytics 參數。
  • 開發模式和未部署的代理：在開發模式中，如果 LookML 資訊主頁代理尚未部署至正式環境，對話介面會忽略對其設定所做的任何變更。