建立及管理 LookML 資訊主頁資料代理程式

預覽

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

注意：LookML 資訊主頁資料代理程式目前為預先發布版，僅提供部分支援。歡迎提供意見，協助我們改良。如要回報錯誤或問題，請傳送電子郵件至 [e-mail]，並附上以下詳細資料：

• 清楚說明問題和預期行為
• 重現問題的步驟
• 任何其他相關詳細資料

對話式數據分析功能由 Gemini for Google Cloud 支援，可透過直覺的對話介面，以對話語言提問來調查資料。搭配LookML 資訊主頁使用對話式數據分析時，您可以直接在受版本控管的 LookML 程式碼中，定義及自訂資訊主頁資料代理。

開發人員可透過 LookML 資訊主頁代理，將量身打造的商業邏輯、自訂指令和分析設定，注入 LookML 管理的資訊主頁。由於 LookML 資訊主頁代表組織中受控管且經過版本控制的真實來源，LookML 資訊主頁代理可確保 AI 互動在各環境中保持一致，並遵守組織資料標準。

注意： 本頁說明 LookML 資訊主頁的資料代理程式。如要瞭解使用者定義資訊主頁的資料代理程式，請參閱「使用資訊主頁代理程式查詢使用者定義的資訊主頁」說明文件頁面。如要瞭解探索資料代理程式，請參閱「建立及管理探索資料代理程式」說明文件頁面。

本頁面涵蓋下列主題：

• 事前準備
• 在 LookML 中定義資訊主頁代理
• 在代理程式指令中使用 LookML 常數
• 將資訊主頁代理與 LookML 資訊主頁建立關聯
• 在開發模式中測試 LookML 資訊主頁代理程式
• 從使用者定義的資訊主頁複製資訊主頁代理 LookML
• 在 Looker 使用者介面中查看代理程式詳細資料
• 使用資訊主頁代理程式查詢 LookML 資訊主頁

事前準備

設定或使用 LookML 資訊主頁代理程式前，請確認符合下列需求：

• 執行個體需求條件：Looker 管理員必須在 Gemini in Looker 管理頁面啟用對話式數據分析。管理員也必須開啟「啟用『信任的測試人員』功能」和「啟用資訊主頁代理程式」設定。進階數據分析 如要為資訊主頁代理程式啟用進階數據分析，也必須啟用進階數據分析管理員設定。這項設定不適用於 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. 使用 @{<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 資訊主頁的代理行為：

• enable_dashboard_agent：(選用) 接受 true 或 false。決定使用者是否能看到「與這個資訊主頁對話」圖示，以及與資訊主頁代理程式互動。如果省略此參數，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，使用者仍可與資訊主頁交談，但代理程式會執行，且沒有自訂指令。

在開發模式中測試 LookML 資訊主頁代理程式

LookML 開發人員可以直接在 Looker UI 中，反覆修改代理程式指令和測試回覆，然後再將變更部署到實際工作環境。

如要在開發模式中測試 LookML 資訊主頁代理，請按照下列步驟操作：

1. 開啟「開發模式」。
2. 在 LookML 檔案中編輯代理 instructions 或設定，然後儲存變更。
3. 在 Looker UI 中開啟 LookML 資訊主頁。
4. 選取「spark」>「透過對話探索這個資訊主頁」，開啟對話面板。
5. 提出問題，測試虛擬服務專員如何解讀及回應提示。

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

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

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

如果您在 UI 中將資訊主頁原型設為使用者定義資訊主頁，可以將完整設定 (包括資訊主頁代理設定和指令) 匯出為 LookML 程式碼。

如要從使用者定義資訊主頁複製 LookML：

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

匯出的 LookML 會使用 enable_dashboard_agent 參數保留「啟用與資訊主頁對話」切換鈕的狀態，並複製所有自訂代理程式指令。

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

查看含有有效資訊主頁代理的 LookML 資訊主頁時，您可以透過聊天面板檢查代理設定：

1. 選取「火花」圖示 「透過對話探索這個資訊主頁」。
2. 選取「調整」 「管理代理程式」。

如果是 LookML 資訊主頁，系統會以唯讀模式顯示「管理代理程式」面板，其中包含代理程式指令、進階 Analytics 狀態和偵錯選項。無法直接在 UI 中編輯設定。

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

注意：如果使用者沒有 LookML 資訊主頁所有基礎模型的 develop 權限，系統會隱藏「調整」「管理代理程式」圖示。

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

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

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

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

管理會話群組

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

相關資源

• Looker 對話式數據分析總覽： Looker 對話式數據分析的到達網頁。
• 使用資訊主頁代理查詢使用者定義的資訊主頁： 設定及查詢使用者定義資訊主頁的資訊主頁資料代理。
• 建構 LookML 資訊主頁： 使用 LookML 建立及管理受版本控管的資訊主頁。
• LookML 資訊主頁參數： 所有 LookML 資訊主頁參數的參考文件。
• agent 參數： LookML agent 參數的參考文件。
• 在 Looker 中設定對話式數據分析的最佳做法： 撰寫優質指令和最佳化資料代理程式的指南。