使用适用于 Amazon Kendra 的 Quip 连接器通过智能搜索在 Quip 文档中搜索知识

组织使用 Salesforce 等协作文档创作解决方案 讽刺 在 Salesforce 记录中嵌入实时协作文档。 Quip 是 Salesforce 的生产力平台，它改变了企业协作的方式，在任何设备上安全、简单地提供现代协作。 Quip 存储库以协作文档和工作流的形式获取宝贵的组织知识。 但是，可以轻松安全地找到这种组织知识以及其他文档存储库，例如 Box 或 亚马逊简单存储服务 (Amazon S3)，可能具有挑战性。 此外，协作工作流的对话性质使得传统的基于关键字的搜索方法由于在多个地方具有碎片化、分散的信息而变得无效。

我们很高兴地宣布您现在可以使用 亚马逊肯德拉 Quip 连接器，用于在 Quip 存储库中搜索消息和文档。 在这篇文章中，我们将向您展示如何使用由机器学习提供支持的 Amazon Kendra 的智能搜索功能在 Quip 存储库中查找您需要的信息。

解决方案概述

使用 Amazon Kendra，您可以配置多个 数据源 提供一个在您的文档存储库中搜索的中心位置。 对于我们的解决方案，我们演示了如何使用适用于 Quip 的 Amazon Kendra 连接器将 Quip 存储库配置为搜索索引的数据源。

以下屏幕截图显示了一个示例 Quip 存储库。

此示例中的工作区有一个未共享的私有文件夹。 该文件夹有一个用于保存费用收据的子文件夹。 另一个名为 example.com 的文件夹与其他人共享，用于与团队协作。 此文件夹有五个子文件夹，其中包含用于开发的文档。

要配置 Quip 连接器，我们首先记下 Quip 存储库的域名、文件夹 ID 和访问令牌。 然后我们只需创建 Amazon Kendra 索引并将 Quip 添加为数据源。

先决条件

要开始使用适用于 Amazon Kendra 的 Quip 连接器，您必须拥有 Quip 存储库。

从 Quip 收集信息

在我们设置 Quip 数据源之前，我们需要一些关于您的存储库的详细信息。 让我们提前收集这些。

域名

找出域名。 例如，对于 Quip URL https://example-com.quip.com/browse, 域名为 quip. 根据您的组织中单点登录 (SSO) 的设置方式，域名可能会有所不同。 保存此域名以供以后使用。

文件夹 ID

Quip 中的文件夹具有与其关联的唯一 ID。 我们需要通过提供正确的文件夹 ID 来配置 Quip 连接器以访问正确的文件夹。 对于这篇文章，我们索引文件夹 example.com.

要查找文件夹的 ID，请选择文件夹。 URL 更改为显示文件夹 ID。

在这种情况下，文件夹 ID 是 xj1vOyaCGB3u. 列出要扫描的文件夹 ID； 我们在配置连接器时使用这些 ID。

访问令牌

登录 Quip 并打开 https://{subdomain.domain}/dev/token 在网络浏览器中。 在以下示例中，我们导航到 https://example-com.quip.com/dev/token。 然后选择 获取个人访问令牌.

复制令牌以在后续步骤中使用。

我们现在有了配置数据源所需的信息。

创建 Amazon Kendra 索引

要设置您的 Amazon Kendra 索引，请完成以下步骤：

1. 登录 AWS管理控制台 并打开 Amazon Kendra 控制台。

如果您是第一次使用 Amazon Kendra，您应该会看到以下屏幕截图。

2. 创建一个索引.
   
3. 针对 索引名称，输入 my-quip-example-index.
4. 针对 课程描述，输入可选说明。
5. 针对 IAM角色，使用现有角色或创建新角色。
6. 下一页.
   
7. 下 访问控制设置， 选择 没有 使所有用户都可以使用所有索引内容。
8. 针对 用户组扩展， 选择 不包含.
9. 下一页.
   

针对 预配版本，您可以根据内容的数量和访问频率从两个选项中进行选择。

10. 对于此帖子，请选择 开发者版.
11. 创建.
    

创建角色大约需要 30 秒； 创建索引最多可能需要 30 分钟。 完成后，您可以在 Amazon Kendra 控制台上查看您的索引。

添加 Quip 作为数据源

现在让我们将 Quip 作为数据源添加到索引中。

1. 在 Amazon Kendra 控制台上，在 数据管理 在导航窗格中，选择 资料来源.
2. 添加连接器 下 讽刺.
   
3. 针对 资料来源名称，输入 my-quip-data-source.
4. 针对 课程描述，输入可选说明。
5. 下一页.
   
6. 输入您之前保存的 Quip 域名。
7. 下 秘密，选择 创建并添加新的 Secrets Manager 密钥.
8. 针对 秘密名称，输入您的秘密名称。
9. 针对 Quip 令牌，输入您之前保存的访问令牌。
10. 保存并添加秘密.
    
11. 下 IAM角色，选择一个角色或创建一个新角色。
12. 下一页.
    
13. 下 同步范围，为 添加要抓取的文件夹 ID，输入您之前保存的文件夹 ID。
14. 下 同步运行计划¸为 频率， 选择 按需运行.
15. 下一页.
    

Quip 连接器允许您捕获其他字段，例如作者、类别和文件夹名称（甚至根据需要重命名）。

16. 对于这篇文章，我们不配置任何字段映射。
17. 下一页.
    
18. 确认所有选项并添加数据源。

您的数据源将在几分钟内准备就绪。

19. 当您的数据源准备就绪时，选择 立即同步.
    

根据 Quip 存储库中数据的大小，此过程可能需要几分钟到几小时。 同步是一个两步过程。 首先，对文档进行爬网以确定要索引的文档。 然后对选定的文档进行索引。 影响同步速度的一些因素包括存储库吞吐量和限制、网络带宽和文档大小。

同步完成后，同步状态显示为成功。 您的 Quip 存储库现已连接。

在 Amazon Kendra 中运行搜索

让我们通过运行一些搜索来测试连接器。

1. 在 Amazon Kendra 控制台上，在 数据管理 在导航窗格中，选择 搜索索引内容.
   
2. 在搜索字段中输入您的搜索。 对于这篇文章，我们搜索 EC2 on Linux.

以下屏幕截图显示了我们的结果。

限制

数据源摄取存在一些已知限制。 一些限制是由于需要管理员访问权限才能访问某些内容，其他限制是由于特定的实施细节。 它们如下：

• 仅支持完全爬网。 如果您希望连接器支持变更日志爬网，则需要管理员 API 访问权限，并且您必须在 Quip 网站上启用管理员 API。
• 仅爬网共享文件夹。 即使我们使用管理员用户的个人访问令牌，我们也无法抓取其他用户的私人文件夹中的数据。
• 该解决方案不支持指定包含和排除的文件类型，因为 Quip 不存储文件类型扩展名，只存储文件名。
• 实时事件需要订阅和管理 API 访问权限。

结论

适用于 Quip 的 Amazon Kendra 连接器使组织能够使用由 Amazon Kendra 提供支持的智能搜索安全地向用户提供存储在 Quip 文档中的宝贵信息。 该连接器还提供 Quip 存储库属性的方面，例如作者、文件类型、源 URI、创建日期、父文件和类别，以便用户可以根据他们正在查找的内容以交互方式优化搜索结果。

有关如何在从 Quip 存储库提取内容时使用自定义文档扩充来创建、修改和删除数据和元数据的更多信息，请参阅 在摄取过程中自定义文档元数据 和 通过 Amazon Kendra 中的自定义文档丰富功能丰富您的内容和元数据以增强您的搜索体验.

---

作者简介

阿什·拉格万卡 是 AWS 的高级企业解决方案架构师。 他的核心兴趣包括 AI/ML、无服务器和容器技术。 Ashish 居住在马萨诸塞州波士顿地区，喜欢阅读、户外活动以及与家人共度时光。

维卡斯·沙阿 是 Amazon Web Services 的企业解决方案架构师。 他是一位技术爱好者，喜欢帮助客户找到应对复杂业务挑战的创新解决方案。 他感兴趣的领域是机器学习、物联网、机器人和存储。 在业余时间，Vikas 喜欢制造机器人、远足和旅行。

• 硬币聪明。 欧洲最好的比特币和加密货币交易所。
• 柏拉图区块链。 Web3 元宇宙智能。 知识放大。 自由登入。
• 加密鹰。 山寨币雷达。 免费试用。
• 资料来源：https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/