Slack

Slack 是一款企业通信应用程序，允许用户通过各种公共和私人频道发送消息和附件。您可以使用 Amazon Kendra 索引您的 Slack 公共和私人频道、机器人和存档消息、文件和附件、直接消息和群组消息。还可以选择要筛选的特定内容。

注意

Amazon Kendra 现在支持升级后的 Slack 连接器。

控制台已自动为您升级。您在控制台中创建的任何新连接器都将使用升级后的架构。如果您使用 API，则现在必须使用TemplateConfiguration对象而不是SlackConfiguration对象来配置您的连接器。

使用较旧的控制台和 API 架构配置的连接器将继续按配置运行。但是，您将无法对其进行编辑或更新。如果要编辑或更新连接器配置，则必须创建新的连接器。

我们建议将您的连接器工作流程迁移到升级版本。对使用旧架构配置的连接器的支持计划于 2024 年 6 月结束。

您可以使用Amazon Kendra 控制台或 TemplateConfigurationAPI Amazon Kendra 连接到您的 Slack 数据源。

要对 Amazon Kendra Slack 数据源连接器进行故障排除，请参阅数据来源故障排除。

支持的特征

Amazon Kendra Slack 数据源连接器支持以下功能：

• 字段映射

• 用户访问控制

• 包含/排除筛选条件

• 完整内容和增量内容同步

• Virtual Private Cloud (VPC)

先决条件

在使用 Amazon Kendra 索引 Slack 数据源之前，请在您的 Slack 和 AWS 帐户中进行这些更改。

在 Slack 中，请确保：

• 已配置 Slack Bot 用户 OAuth 令牌或 Slack 用户 OAuth 令牌。您可以选择任一令牌 Amazon Kendra 来连接您的 Slack 数据源。需要使用令牌作为您的身份验证凭证。有关更多信息，请参阅有关访问令牌的 Slack 文档。

  注意

  如果您使用机器人令牌作为 Slack 凭证的一部分，则无法将私信和群组消息编入索引，必须将机器人令牌添加到要编制索引的频道中。

  注意

  我们建议您定期刷新或轮换您的凭证和密码。为了安全起见，请仅提供必要的访问权限级别。我们建议不要跨数据来源以及连接器版本 1.0 和 2.0（如果适用）重复使用凭证和密钥。

• 在 Slack 工作区主页 URL 中记下您的 Slack 工作区团队 ID。例如，https://app.slack.com/client/T0123456789/...，其中 T0123456789 是团队 ID。

• 添加了以下 Oauth 范围/权限：

  用户令牌范围	机器人令牌范围
  channels:history channels:read emoji:read files:read groups:history groups:read im:history im:read mpim:history mpim:read team:read users.profile:read users:read 用户:阅读.email	channels:history 频道:管理 channels:read 对话. 连接:管理 对话. connections: 阅读 files:read groups:history groups:read im:history im:read mpim:history mpim:read 反应:读取 team:read usergroups:read users.profile:read users:read 用户:阅读.email

• 在 Slack 以及计划用于编制同一索引的其他数据来源中，已检查每个文档都是唯一的。您要用于编制索引的每个数据来源在所有数据来源中都不能包含相同的文档。文档 ID 对索引来说是全局性的，并且每个索引都必须是唯一的。

在你的 AWS 账户，请确保你有：

• 已创建 Amazon Kendra 索引，如果使用 API，则记下索引 ID。

• 为您的数据源@@ 创建了一个 IAM 角色，如果使用 API，请记下该角色的 ARN。 IAM

  注意

  如果您更改了身份验证类型和证书，则必须更新您的 IAM 角色才能访问正确的 AWS Secrets Manager 密钥 ID。

• 将您的 Slack 身份验证凭证存储在 AWS Secrets Manager 密钥中，如果使用 API，请记下密钥的 ARN。

  注意

  我们建议您定期刷新或轮换您的凭证和密码。为了安全起见，请仅提供必要的访问权限级别。我们建议不要跨数据来源以及连接器版本 1.0 和 2.0（如果适用）重复使用凭证和密钥。

如果您没有现有的 IAM 角色或密钥，则可以在将 Slack 数据源连接至时使用控制台创建新的 IAM 角色和 Secrets Manager 密钥。 Amazon Kendra如果您使用的是 API，则必须提供现有 IAM 角色和 Secrets Manager 密钥的 ARN 以及索引 ID。

连接说明

要 Amazon Kendra 连接到您的 Slack 数据源，您必须提供 Slack 数据源的必要详细信息， Amazon Kendra 以便访问您的数据。如果您尚未为 Slack 配置 Amazon Kendra，请参阅先决条件。

Console

要连接 Amazon Kendra 到 Slack

1. 登录 AWS Management Console 并打开Amazon Kendra 控制台。

2. 在左侧导航窗格中，选择索引，然后从索引列表中选择要使用的索引。

   注意

   您可以选择在索引设置下配置或编辑您的用户访问控制设置。

3. 在入门页面上，选择添加数据来源。

4. 在添加数据源页面上，选择 Slack 连接器，然后选择添加连接器。如果使用版本 2（如果适用），请选择带有 “V2.0” 标签的 Slack 连接器。

5. 在指定数据来源详细信息页面上输入以下信息：

   1. 在名称和描述中，在数据来源名称中输入您的数据来源的名称。可以包含连字符，但不能包含空格。

   2. （可选）说明 - 为数据来源输入说明。

   3. 使用默认语言-选择一种语言来筛选文档中的索引。除非另行指定，否则语言默认为英语。在文档元数据中指定的语言会覆盖所选语言。

   4. 在标签中，用于添加新标签-包括可选标签以搜索和筛选您的资源或跟踪您的 AWS 成本。

   5. 选择下一步。

6. 在定义访问权限和安全性页面上，请输入以下信息：

   1. 对于 Slack 工作区团队 ID-您的 Slack 工作空间的团队 ID。你可以在你的 Slack 工作区主页网址中找到你的团队 ID。例如，https://app.slack.com/client/T0123456789/...，其中 T0123456789 是团队 ID。

   2. 授权-如果您有 ACL 并想将其用于访问控制，请打开或关闭文档的访问控制列表 (ACL) 信息。ACL 指定了用户和群组可以访问哪些文档。ACL 信息用于根据用户或用户组对文档的访问权限来筛选搜索结果。有关更多信息，请参阅用户上下文筛选。

   3. AWS Secrets Manager s@@ ecret —选择现有密钥或创建新 Secrets Manager 密钥来存储您的 Slack 身份验证凭据。如果您选择创建新密钥，则会打开 AWS Secrets Manager 密钥窗口。

      1. 在创建 AWS Secrets Manager 密钥窗口中输入以下信息：

         1. 密钥名称 - 密钥的名称。前缀 “AmazonKendra-Slack-” 会自动添加到您的密钥名称中。

         2. 对于 Slack 令牌-输入您配置的 Slack 的身份验证凭据值。

      2. 保存并添加您的密钥。

   4. 虚拟私有云（VPC）- 您可以选择使用 VPC。如果是这样，则必须添加子网和 VPC 安全组。

   5. I Amazon Kendra dent@@ ity Crawler-指定是否开启身份搜寻器。Identity Crawler 使用文档的访问控制列表 (ACL) 信息，根据用户或其群组对文档的访问权限筛选搜索结果。如果您的文档有 ACL 并选择使用您的 ACL，则也可以选择开启身份爬网程序来配置搜索结果 Amazon Kendra的用户上下文筛选。否则，如果身份搜寻器已关闭，则可以公开搜索所有文档。如果您想对文档使用访问控制并且身份搜寻器已关闭，则可以使用 PutPrincipalMappingAPI 上传用户和群组访问信息以进行用户上下文筛选。

   6. IAM ro le —选择现有 IAM 角色或创建新 IAM 角色来访问您的存储库凭据和索引内容。

      注意

      IAM 用于索引的角色不能用于数据源。如果您不确定是否将现有角色用于编制索引或常见问题解答，为了避免出错，请选择创建新角色。

   7. 选择下一步。

7. 在配置同步设置页面上，请输入以下信息：

   1. 选择内容类型-选择要抓取的 Slack 实体或内容类型。您可以从所有频道、公共频道、私人频道、群组消息和私人消息中进行选择。

   2. 选择抓取开始日期-输入您想要开始抓取内容的日期。

   3. 对于其他配置-选择包含机器人和存档消息，并使用正则表达式模式来包含或排除某些内容。

      注意

      如果您选择同时包含频道 ID 和频道名称，则 Amazon Kendra Slack 连接器将优先考虑频道 ID 而不是频道名称。

      如果您选择包含某些私人和群组消息， Amazon Kendra Slack 连接器将忽略所有私人和群组消息，只抓取您指定的私人和群组消息。

   4. 同步模式 - 选择在数据来源内容发生变化时更新索引的方式。首次与同步数据源时， Amazon Kendra 默认情况下会对所有内容进行抓取和索引。如果初始同步失败，即使您没有选择完全同步作为同步模式选项，也必须对数据进行完全同步。

      • 完全同步：对所有内容进行新索引，每次数据源与索引同步时都会替换现有内容。

      • 新增、已修改、已删除的同步：每次数据源与索引同步时，仅索引新内容、修改内容和已删除内容。 Amazon Kendra 可以使用数据源的机制来跟踪内容更改并索引自上次同步以来更改的内容。

   5. 在 “同步” 运行计划中，“频率”-选择同步数据源内容和更新索引的频率。

   6. 选择下一步。

8. 在设置字段映射页面上，请输入以下信息：

   1. 默认数据源字段-从 Amazon Kendra 生成的默认数据源字段中选择要映射到索引的字段。

   2. 添加字段 - 添加自定义数据来源字段以创建要映射到的索引字段名称和字段数据类型。

   3. 选择下一步。

9. 在查看和创建页面上，请检查输入的信息是否正确，然后选择添加数据来源。您也可以选择在此页面上编辑信息。成功添加数据来源后，您的数据来源将显示在数据来源页面上。

API

要连接 Amazon Kendra 到 Slack

您必须使用 TemplateConfiguration API 指定数据来源架构的 JSON。您必须提供以下信息：

• 数据源-将数据源类型指定为使用 TemplateConfigurationJSON 架构SLACK时的类型。还要像调用 CreateDataSourceAPI TEMPLATE 时一样指定数据源。

• Slack 工作区团队 ID - 您从 Slack 主页 URL 中复制的 Slack 团队 ID。

• 起始日期-开始从 Slack 工作空间团队抓取数据的日期。日期必须遵循此格式: yyyy-mm-dd.

• 同步模式-指定数据源内容发生变化时 Amazon Kendra 应如何更新索引。首次与同步数据源时， Amazon Kendra 默认情况下会对所有内容进行抓取和索引。如果初始同步失败，即使您没有选择完全同步作为同步模式选项，也必须对数据进行完全同步。您可以选择：

  • FORCED_FULL_CRAWL对所有内容进行全新索引，每次数据源与索引同步时都要替换现有内容。

  • FULL_CRAWL每次数据源与索引同步时，仅对新的、修改过的和已删除的内容编制索引。 Amazon Kendra 可以使用数据源的机制来跟踪内容更改并索引自上次同步以来更改的内容。

  • CHANGE_LOG每次数据源与索引同步时，仅索引新的和修改过的内容。 Amazon Kendra 可以使用数据源的机制来跟踪内容更改并索引自上次同步以来更改的内容。

• I Amazon Kendra dent@@ ity Crawler-指定是否开启身份搜寻器。Identity Crawler 使用文档的访问控制列表 (ACL) 信息，根据用户或其群组对文档的访问权限筛选搜索结果。如果您的文档有 ACL 并选择使用您的 ACL，则也可以选择开启身份爬网程序来配置搜索结果 Amazon Kendra的用户上下文筛选。否则，如果身份搜寻器已关闭，则可以公开搜索所有文档。如果您想对文档使用访问控制并且身份搜寻器已关闭，则可以使用 PutPrincipalMappingAPI 上传用户和群组访问信息以进行用户上下文筛选。

• 亚马逊秘密资源名称 (ARN)-提供包含您的 Slack 账户身份验证凭证的 Secrets Manager 密钥的亚马逊资源名称 (ARN)。密钥必须使用具有以下键的 JSON 结构存储：

  {
      "slackToken": "token"
  }

• IAM ro le —指定RoleArn何时调用CreateDataSource以向 IAM 角色提供访问您的 Secrets Manager 密钥和调用 Slack 连接器所需的公共 API 的权限，以及。 Amazon Kendra有关更多信息，请参阅 Slack 数据来源的IAM 角色。

您还可以添加以下可选功能：

• 虚拟私有云（VPC）- 指定 VpcConfiguration，以便调用 CreateDataSource。有关更多信息，请参阅 配置 Amazon Kendra 使用 Amazon VPC。

• 特定频道-按公共或私人频道筛选，并按其 ID 指定某些频道。

• 频道和消息的类型-是否 Amazon Kendra 应将您的公共和私人频道、群组和私信以及机器人和存档消息编入索引。如果您使用机器人令牌作为 Slack 身份验证凭证的一部分，则必须将机器人令牌添加到要编制索引的频道。您无法使用机器人令牌将私信和群组消息编入索引。

• 回顾-您可以选择配置lookBack参数，以便 Slack 连接器在上次连接器同步之前的指定小时数内抓取已更新或已删除的内容。

• 包含和排除过滤器-指定是包含还是排除某些 Slack 内容。如果您使用机器人令牌作为 Slack 身份验证凭证的一部分，则必须将机器人令牌添加到要编制索引的频道。您无法使用机器人令牌将私信和群组消息编入索引。

  注意

  大多数数据来源使用正则表达式模式，即称为筛选条件的包含或排除模式。如果您指定包含筛选条件，则只会为与包含筛选条件匹配的内容编制索引。不会为任何与包含筛选条件不匹配的文档编制索引。如果您指定包含和排除筛选条件，则不会为与排除筛选条件匹配的文档编制索引，即使它们与包含筛选条件相匹配。

• 字段映射 - 选择将 Slack 数据来源字段映射到 Amazon Kendra 索引字段。有关更多信息，请参阅映射数据来源字段。

  注意

  要搜索您的文档，必须输入文档正文字段或文档正文等效字段。 Amazon Kendra 您必须将数据源中的文档正文字段名称映射到索引字段名称_document_body。其他所有字段均为可选字段。

有关要配置的其他重要 JSON 键的列表，请参阅 Slack 模板架构。

了解更多信息

要了解有关 Amazon Kendra 与 Slack 数据源集成的更多信息，请参阅：

• 使用 Amazon Kendra Slack 连接器进行智能搜索，揭开 Slack 工作区的面纱