本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
疑难解答知识库
当您在 Quick 知识库中遇到问题时，可以使用此疑难解答指南来识别和解决常见问题。知识库问题通常涉及文档同步、刷新任务失败或访问权限。
文档未出现在您的知识库中
当您期望看到的文档未出现在您的知识库中时，可能会有几个因素导致此问题。
常见原因：
要排除故障：
-
查看刷新历史记录，查看与无法同步的特定文档相关的错误消息。
-
验证您的文档格式和文件大小是否符合要求。
-
检查您的访问权限和连接设置。
刷新任务失败
当知识库或数据源连接中出现配置错误时，刷新作业通常会失败。
常见原因：
-
权限问题-集成缺少访问数据源的足够权限。
-
配置错误-URL 或数据源连接设置不正确。
-
资源限制-源系统的速率限制。
要解决这个问题：
-
查看刷新历史记录详细信息以了解特定的错误消息。
-
验证所有连接设置和权限的配置是否正确。
-
根据错误消息采取建议的操作。
刷新作业已完成，但出现问题
当刷新作业完成但出现问题时，该作业已成功处理，但某些文档遇到了问题。
这是什么意思：
-
部分成功-有些文档已成功同步，而另一些则失败。
-
Document-level 错误-个别文件可能存在格式问题、损坏或访问问题。
-
元数据问题-文档元数据或相关信息存在问题。
-
大小或格式违规-某些文件可能超过大小限制或格式不受支持。
要解决这个问题：
-
查看详细的刷新报告以确定哪些文档遇到了问题。
-
解决个别文档问题。
-
解决问题后再次刷新。
刷新作业成功但未显示任何文档
如果刷新作业显示成功但您的知识库中未显示任何文档，请检查这些潜在原因。
常见原因：
-
空源-配置的数据源位置不包含任何文档。
-
路径配置不正确-源路径或连接设置未指向正确的位置。
-
文档筛选器-“包含” 或 “排除” 标准可能会过滤掉所有文档。
-
缺少读取权限-作业已成功连接，但缺少读取实际文档的权限。
要解决这个问题：
-
验证您的数据源配置指向正确的位置。
-
确认文件存在于指定位置。
-
检查是否配置了适当的访问权限。
-
查看任何可能排除内容的文档筛选器。
刷新期间出现文件格式问题
快速知识库支持特定的文件格式。文件必须符合格式、大小和字符限制要求。有关支持的格式和限制的完整列表，请参阅文件大小和内容限制。
要解决格式问题，请执行以下操作：
-
验证您的文件是否符合格式和大小要求。
-
将不支持的格式转换为支持的格式。
-
从文件中移除密码保护。
-
检查文件是否已损坏。
访问被拒绝错误
访问被拒绝错误通常是由于身份验证或授权问题造成的。
常见原因：
-
凭据无效-身份验证令牌或密码可能已过期。
-
权限不足-集成中使用的账户缺乏对数据源的读取权限。
-
网络限制-防火墙或安全策略阻止访问。
-
SSL/TLS 问题-安全连接存在证书问题。
要解决这个问题：
-
验证身份验证凭证-确认身份验证凭据是最新且有效的。编辑集成以重新进行身份验证并生成新令牌。
-
对于 Web Crawler 数据源 — 确认安全连接配置正确，SSL 证书配置正确且可信。
-
联系您的系统管理员-如果您仍然遇到访问问题，请联系您的系统管理员。他们可能需要调整权限或安全设置。
ACL 验证错误
如果您的同步报告显示状态为 S KIPPED 且错误类型为 VALIDATION_ERROR 的项目，并显示消息 “文件没有 ACL 而 CrawlaCL 为真，正在跳过摄取”，则您的知识库连接器使用的应用程序注册缺少所需的 ACL 权限。
要解决这个问题：
-
验证应用程序注册是否具有 ACL 爬网的正确 API 权限。所需的权限因连接器而异。请参阅连接器设置文档中的权限部分。
-
确认所有必需权限均已获得管理员同意。
-
Re-run 修复权限后进行完全同步。
同步运行超过最大运行时间
如果同步运行的时间超过 14 天，Amazon Quick 将以失败状态结束运行，并显示已超过最大同步时间消息。当知识库配置为抓取的内容超过单次运行所能处理的内容时，通常会发生这种情况。
要解决这个问题：
-
编辑您的知识库以减少每次同步的内容量。应用包含或排除过滤器，限制要抓取的文件类型或文件夹，或者将内容拆分到多个知识库中。
-
对于网络爬虫数据源，如果您的目标是与大型公共网站（例如）聊天，请考虑改用 Web 搜索功能。
wikipedia.org -
缩小范围后再次运行同步。
有关此限制的更多信息，请参阅最大同步时长。
