将 Lookerbot 用于 Slack

本页面简要介绍了如何使用 Lookerbot，这是 Looker 提供的用于在 Slack 中共享 Looker 数据的集成之一。

适用于 Slack 的 Lookerbot 与 Looker 集成，因此您可以直接从 Slack 查询数据，从而轻松共享数据并回答数据驱动的问题，而无需在组织的现有工作流之外工作。

本页面讨论了以下 Slack-Lookerbot 工作流：

Lookerbot 使用入门

您必须先按照 Looker 开源 GitHub 代码库中的技术设置说明配置 Lookerbot 应用，然后才能在 Slack 中使用 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. 选择 Integrations（集成）标签页。
  3. 在应用下，选择您的 Lookerbot 应用的名称。

当您将 Lookerbot 受邀添加到的 Slack 频道中的“探索”或“Look”粘贴网址时，Lookerbot 会自动展开该网址及其内容。如果 Looker 内容具有关联的可视化图表，Lookerbot 将显示该可视化图表的图片。如果 Looker 内容是数据表，则 Lookerbot 会以文本形式显示数据。

使用自定义斜杠命令运行和发布 Looker 查询

您还可以创建和使用自定义斜杠命令，这些命令在执行时会在 Looker 中运行已保存的数据查询，并将结果发布到 Slack。自定义斜杠命令是在 Lookerbot 设置期间创建的，但任何 Slack 用户都可以在 Slack 中执行。

无需使用斜杠命令即可与 Lookerbot 交互。如需使用 Lookerbot 的所有函数，您还可以直接向该聊天机器人发送消息，或在 Lookerbot 所在的 Slack 频道（@lookerbot help）中提及该聊天机器人。

如果您的 Slack 工作区启用了 Slack 集成，则不能将 /looker 斜杠命令与 Lookerbot 配合使用。请使用 @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 在本月对首要客户命令的响应会返回 Looker 查询的链接以及用户名称、用户年龄、用户状态和订单数的值。
  • 单值可视化：如果底层内容是单值可视化，则数据将以文本值的形式返回。例如，如果用户运行已配置的命令 orders last week，Slackbot 会返回上一周的总计数：

    Slackbot 对上周命令的响应，返回指向 Looker 查询的链接，订单总数为 228。
  • 可视化图表：如果底层内容是可视化图表，数据将以可视化图表的图片的形式返回。例如，如果用户运行已配置的命令 movie budgets（值为 Brad Pitt），Slackbot 会做出响应，其中包含指向 Looker 查询的链接，以及一个折线图可视化内容，其中显示了电影上映年份（1990 年至 2015 年期间）的平均布拉德·皮特电影预算从 0 到 1.6 亿的增减趋势：

其他资源

如需了解 Looker 的其他 Slack 集成，请参阅以下资源：