使用 Slack 的 Lookerbot

本頁概略說明如何使用 Lookerbot，這是 Looker 提供的多項整合功能之一，可在 Slack 中分享 Looker 資料。

Lookerbot for Slack 與 Looker 整合，可讓您直接在 Slack 中查詢資料，輕鬆分享資料並回答資料導向的問題，不必離開貴機構現有的工作流程。

本頁將說明下列 Slack Lookerbot 工作流程：

開始使用 Lookerbot

在 Slack 中使用 Lookerbot 前，您必須按照 Looker 開放原始碼 GitHub 存放區中的技術設定操作說明，設定 Lookerbot 應用程式。

在 2021 年 2 月，Slack 淘汰了部分 API 端點，這會影響 Lookerbot 與資料動作互動的情形。請從 Looker 的 Lookerbot GitHub 存放區下載最新更新。package.json 檔案應指出 Looker 版本為 0.0.16 以上。

自動展開 Looker 網址

Lookerbot 可自動展開你在 Slack 中分享的 Looker 內容網址。如要讓 Lookerbot 自動展開 Slack 頻道中的分享網址，請務必將 Lookerbot 新增至該 Slack 頻道。(機器人設定也必須將 LOOKER_SLACKBOT_EXPAND_URLS 環境變數設為 true。如要進一步瞭解環境變數，請參閱 Lookerbot 技術設定操作說明。

在 Slack 即時訊息中，無法展開 Looker 網址，因為 Lookerbot 使用的舊版展開 API 功能會區分私人/公開頻道和即時訊息。

如要邀請 Lookerbot 加入 Slack 的公開或私人頻道，請按照下列步驟操作：

  1. 按一下頻道名稱，開啟頻道設定。
  2. 選取「整合」分頁標籤。
  3. 在「應用程式」下方，選取 Lookerbot 應用程式名稱。

當你在 Lookerbot 已獲邀的 Slack 頻道中，貼上「探索」或「Look」的網址時，Lookerbot 會自動展開網址及其內容。如果 Looker 內容有相關的視覺化資料，Lookerbot 就會顯示該視覺化資料的圖片。如果 Looker 內容是資料表，Lookerbot 會以文字格式顯示資料。

使用自訂斜線指令執行及發布 Looker 查詢

您也可以建立及使用自訂斜線指令，執行時會在 Looker 中執行已儲存的資料查詢，並將結果發布至 Slack。自訂斜線指令會在Lookerbot 設定期間建立，但任何 Slack 使用者都可以在 Slack 中執行這些指令。

您不必使用斜線指令就能與 Lookerbot 互動。如要使用 Lookerbot 的所有功能，您也可以直接傳送訊息給機器人，或是在 Lookerbot 所在的 Slack 頻道中提及機器人：@lookerbot help。

如果您為 Slack 工作區啟用 Slack 整合，就無法在 Lookerbot 中使用 /looker 斜線指令。請改用 @lookerbot 或 /lookerbot 取代 @looker 或 /looker。

如要查看 Lookerbot 已建立的指令：

  • 將滑鼠游標懸停在任何提及 Lookerbot 的內容上。彈出式視窗會列出可用的指令。
  • 在 Slack 工作區的「應用程式」專區中選取 Lookerbot 應用程式。接著，選取應用程式頁面中的「簡介」分頁標籤。可用的指令會列在「指令」下方。

使用斜線指令的不同方式

指令有三種使用方式。舉例來說，假設您或貴機構的開發人員已設定指令，從 Looker 擷取資料，追蹤客戶對特定產品下單的次數。開發人員在設定斜線指令時，使用了「orders」來代表這項資料。如要叫用這項指令，您可以：

  1. @提及 Lookerbot，後面接著指令的文字元件。你可以在 Lookerbot 所在的任何管道中執行這項操作。例如：

    @lookerbot orders

  2. 使用斜線指令。您可以點選指令清單中的指令，或輸入指令名稱 (前面加上斜線) 來使用指令。如果您在 設定期間設定了斜線指令，即可執行這項操作。

    /lookerbot orders

  3. 傳送訊息給 Lookerbot。如果您直接傳送訊息給 Lookerbot，就不需要在指令前面加上 /lookerbot。在這種情況下，DM 會是 orders。

搭配篩選器使用斜線指令

如果您或貴機構的開發人員已建立可查詢含有單一元素和資訊主頁篩選器的資訊主頁的斜線指令，您可以執行該指令，擷取該 Looker 內容，並在 Slack 中新增篩選器值。篩選器為選用項目，如果未指定任何值，查詢就會在沒有該篩選器的情況下執行。

舉例來說，假設您有一個資訊主頁，其中包含以特定美國城市為篩選條件的客戶地圖示意圖，而且您已設定自訂斜線指令來叫用這個資訊主頁資料。您可以執行 customer map in 指令，並篩選紐約市，如下所示：

Slackbot 回應，其中包含紐約地圖的資料視覺化效果，不同大小的點代表特定地區的使用者人數。

資料格式

指令會根據基礎探索、Look 或資訊主頁元素的圖表類型，以不同方式傳回資料。回傳格式有三種：

  • 文字：如果基礎內容是資料表，資料會以文字格式傳回。舉例來說，如果使用者執行已設定的指令 top customer this month，Slackbot 會以文字格式傳回前幾筆記錄：

    當 Slackbot 回應「top customer this month」指令時，會傳回 Looker 查詢的連結，以及「Users Name」、「Users Age」、「Users State」和「Orders Count」的值。
  • 單一值示意圖：如果基礎內容是單一值示意圖，資料會以文字值傳回。舉例來說，如果使用者執行已設定的指令 orders last week，Slackbot 會傳回上週的總計數量：

    Slackbot 回覆「上週的訂單」指令，傳回 Looker 查詢的連結，以及訂單總數 228 筆。
  • 視覺化：如果基礎內容是視覺化資料，系統會以視覺化資料的圖片格式傳回資料。舉例來說，如果使用者執行已設定指令 movie budgets 並傳入值 Brad Pitt，Slackbot 會回覆 Looker 查詢的連結，以及一張線性圖表，用來呈現 Brad Pitt 電影的平均預算從 0 到 1,600 萬美元，以及電影首映年份 (1990 到 2015 年) 的增減趨勢：

其他資源

如要瞭解 Looker 的其他 Slack 整合功能，請參閱下列資源：