本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Quip **注意** 在 2026 年 5 月 31 日之前，仍可为现有客户提供对 Quip 连接器的完全支持。虽然此连接器不再可供新用户使用，但仍可供当前用户持续使用。我们正在持续优化我们的连接器产品组合，以提供更具可扩展性和可定制性的解决方案。对于未来集成，我们建议探索 Amazon Kendra 自定义连接器框架[1]，该框架旨在支持更广泛的企业使用案例，并且具备更大的灵活性。 Quip 是一款协作生产力软件，可提供实时文档创作功能。您可以使用Amazon Kendra索引 Quip 文件夹、文件、文件评论、聊天室和附件。 您可以使用[Amazon Kendra控制台](https://console.aws.amazon.com/kendra/)和 [QuipConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html)API 连接Amazon Kendra到 Quip 数据源。 要对 Amazon Kendra Quip 数据源连接器进行故障排除，请参阅[数据来源故障排除](troubleshooting-data-sources.md)。 **Topics** + [支持的功能](#supported-features-quip) + [先决条件](#prerequisites-quip) + [连接说明](#data-source-procedure-quip) + [了解详情](#quip-learn-more) ## 支持的功能 Amazon KendraQuip 数据源连接器支持以下功能： + 字段映射 + 用户访问控制 + 包含/排除筛选条件 + 虚拟私有云（VPC） ## 先决条件 在使用Amazon Kendra索引 Quip 数据源之前，请在您的 Quip 和AWS帐户中进行这些更改。 **在 Quip 中，请确保：** + 拥有一个具有管理权限的 Quip 账户 + 已创建包含个人访问令牌的 Quip 身份验证凭证。该令牌用作存储在AWS Secrets Manager密钥中的身份验证凭证。有关更多信息，请参阅[有关身份验证的 Quip 文档](https://quip.com/dev/admin/documentation/current#section/Authentication)。 **注意** 我们建议您定期刷新或轮换您的凭证和密码。为了安全起见，请仅提供必要的访问权限级别。我们建议**不要**跨数据来源以及连接器版本 1.0 和 2.0（如果适用）重复使用凭证和密钥。 + 已复制 Quip 站点域名。例如，域{{https://quip-company.quipdomain.com/browse}}在{{quipdomain}}哪里。 + 在 Quip 以及计划用于编制同一索引的其他数据来源中，已检查每个文档都是唯一的。您要用于编制索引的每个数据来源在所有数据来源中都不能包含相同的文档。文档对索引来说 IDs 是全局的，并且每个索引必须是唯一的。 **在你的AWS 账户，请确保你有：** + [已创建Amazon Kendra索引](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html)，如果使用 API，则记下索引 ID。 + 为您的数据源@@ [创建了一个IAM角色](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)，如果使用 API，请记下该角色的 ARN。IAM **注意** 如果您更改了身份验证类型和证书，则必须更新您的IAM角色才能访问正确的AWS Secrets Manager密钥 ID。 + 将您的 Quip 身份验证凭证存储在 AWS Secrets Manager 密钥中，如果使用 API，请记下密钥的 ARN。 **注意** 我们建议您定期刷新或轮换您的凭证和密码。为了安全起见，请仅提供必要的访问权限级别。我们建议**不要**跨数据来源以及连接器版本 1.0 和 2.0（如果适用）重复使用凭证和密钥。 如果您没有现有的IAM角色或密钥，则可以在将 Quip 数据源连接到Amazon Kendra时使用控制台创建新的IAM角色和Secrets Manager密钥。如果您使用的是 API，则必须提供现有IAM角色和Secrets Manager密钥的 ARN 以及索引 ID。 ## 连接说明 要连接Amazon Kendra到 Quip 数据源，您必须提供 Quip 数据源的必要详细信息，Amazon Kendra以便访问您的数据。如果您尚未为 Quip 配置Amazon Kendra，请参阅[先决条件](#prerequisites-quip)。 ------ #### [ Console ] **连接Amazon Kendra到 Quip** 1. 登录AWS 管理控制台并打开[Amazon Kendra控制台](https://console.aws.amazon.com/kendra/)。 1. 在左侧导航窗格中，选择**索引**，然后从索引列表中选择要使用的索引。 **注意** 您可以选择在**索引设置**下配置或编辑您的**用户访问控制**设置。 1. 在**开始使用**页面上，选择**添加数据来源**。 1. 在**添加数据来源**页面上，选择 **Quip 连接器**，然后选择**添加数据来源**。如果使用版本 2（如果适用），请选择带有“V2.0”标签的 ** 连接器**。 1. 在**指定数据来源详细信息**页面上，输入以下信息： 1. 在**名称和描述**中，在**数据来源名称**中输入您的数据来源的名称。可以包含连字符，但不能包含空格。 1. （可选）**描述**：输入数据来源的描述信息。 1. 在**默认语言**中，选择用于筛选文档以编制索引的语言。除非另行指定，否则语言默认为英语。在文档元数据中指定的语言会覆盖所选语言。 1. 在**标签**中，用于**添加新标签**-包括可选标签以搜索和筛选您的资源或跟踪您的AWS成本。 1. 选择**下一步**。 1. 在**定义访问权限和安全性**页面上，请输入以下信息： 1. **Quip 域名** - 输入您从 Quip 账户中复制的域名。 1. AWS Secrets Managers@@ **ecret** —选择现有密钥或创建新Secrets Manager密钥来存储您的 Quip 身份验证凭据。如果您选择创建新密钥，则会打开 AWS Secrets Manager 密钥窗口。 1. 在**创建 AWS Secrets Manager 密钥窗口**中输入以下信息： 1. **密钥名称** - 密钥的名称。前缀 “AmazonKendra-Quip-” 会自动添加到您的密钥名称中。 1. **Quip 令牌** - 输入在 Quip 中配置的个人访问令牌。 1. 添加并保存您的密钥。 1. **虚拟私有云（VPC）**- 您可以选择使用 VPC。如果是这样，则必须添加**子网**和 **VPC 安全组**。 1. **IAMro** le —选择现有IAM角色或创建新IAM角色来访问您的存储库凭据和索引内容。 **注意** IAM用于索引的角色不能用于数据源。如果您不确定是否将现有角色用于编制索引或常见问题解答，为了避免出错，请选择**创建新角色**。 1. 选择**下一步**。 1. 在**配置同步设置**页面上，请输入以下信息： 1. **添加要抓取的 Quip 文件夹- IDs IDs 要抓取**的 Quip 文件夹。 **注意** 要爬取根文件夹，包括其中的所有子文件夹和文档，请输入根文件夹 ID。要搜索特定的子文件夹，请添加特定的子文件夹。 IDs 1. **其他配置（内容类型）**- 输入要爬取的内容类型。 1. **正则表达式模式** - 包含或排除某些文件的正则表达式模式。最多可以添加 100 个模式。 1. 在**同步运行计划**的**频率**中 – 选择同步数据来源内容并更新索引的频率。 1. 选择**下一步**。 1. 在**设置字段映射**页面上，请输入以下信息： 1. 从生成的默认数据源字段中选择要映射到Amazon Kendra索引的字段。 1. **添加字段** - 添加自定义数据来源字段以创建要映射到的索引字段名称和字段数据类型。 1. 选择**下一步**。 1. 在**查看和创建**页面上，请检查输入的信息是否正确，然后选择**添加数据来源**。您也可以选择在此页面上编辑信息。成功添加数据来源后，您的数据来源将显示在**数据来源**页面上。 ------ #### [ API ] **连接Amazon Kendra到 Quip** 您必须使用 [QuipConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QuipConfiguration.html)API 指定以下内容： + **Quip 网站域**-例如，域名{{https://quip-company.quipdomain.com/browse}}在{{quipdomain}}哪里。 + **亚马逊秘密资源名称 (ARN)**-提供包含您的 Quip 账户身份验证凭证的Secrets Manager密钥的亚马逊资源名称 (ARN)。密钥必须使用具有以下键的 JSON 结构存储： ``` { "accessToken": "{{token}}" } ``` + **IAMro** le —指定`RoleArn`何时调用`CreateDataSource`以向IAM角色提供访问您的Secrets Manager密钥的权限以及呼叫 Quip 连接器 APIs 所需的公众的权限，以及。Amazon Kendra有关更多信息，请参阅 [Quip 数据来源的 IAM 角色](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)。 您还可以添加以下可选功能： + **虚拟私有云（VPC）**- 在数据来源配置中指定 `VpcConfiguration`。请参阅[配置 Amazon Kendra 以使用 VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html)。 + **包含和排除筛选条件** - 指定是包含还是排除文件。 **注意** 大多数数据来源使用正则表达式模式，即称为筛选条件的包含或排除模式。如果您指定包含筛选条件，则只会为与包含筛选条件匹配的内容编制索引。不会为任何与包含筛选条件不匹配的文档编制索引。如果您指定包含和排除筛选条件，则不会为与排除筛选条件匹配的文档编制索引，即使它们与包含筛选条件相匹配。 + **文件夹** - 指定要编制索引的 Quip 文件夹和子文件夹 **注意** 要爬取根文件夹，包括其中的所有子文件夹和文档，请输入根文件夹 ID。要搜索特定的子文件夹，请添加特定的子文件夹。 IDs + **附件、聊天室、文件评论** - 选择是否包含对附件、聊天室内容和文件评论的爬取。 + **用户上下文筛选和访问控制** – 如果文档有 ACL，则 Amazon Kendra 会爬取文档的访问控制列表（ACL）。ACL 信息用于根据用户或其所在组对文档的访问权限来筛选搜索结果。有关更多信息，请参阅[用户上下文筛选](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter)。 + **字段映射** - 选择将 Quip 数据来源字段映射到 Amazon Kendra 索引字段。有关更多信息，请参阅[映射数据来源字段](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)。 **注意** 要搜索您的文档，必须输入文档正文字段或文档正文等效字段。Amazon Kendra您必须将数据来源中的文档正文字段名映射到索引字段名称 `_document_body`。其他所有字段均为可选字段。 ------ ## 了解详情 要了解有关Amazon Kendra与 Quip 数据源集成的更多信息，请参阅： + [使用 Quip 连接器通过智能搜索在 Quip 文档中搜索知识 Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/)