本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 疑难解答知识库
<a name="troubleshooting-knowledge-bases"></a>

当您在 Quick 知识库中遇到问题时，可以使用此疑难解答指南来识别和解决常见问题。知识库问题通常涉及文档同步、刷新任务失败或访问权限。

## 文档未出现在您的知识库中
<a name="documents-not-appearing"></a>

当您期望看到的文档未出现在您的知识库中时，可能会有几个因素导致此问题。

**常见原因：**
+ **同步正在进行中**-文档可能仍在处理中。检查刷新状态以确认刷新已完成。
+ **不支持的文件格式**-验证您的文档是否为支持的格式。有关支持的格式和大小限制，请参阅[文件大小和内容限制](knowledge-base-integrations.md#file-size-and-content-limits)。
+ **文件大小太大**-验证文件是否在大小限制范围内。有关更多信息，请参阅 [文件大小和内容限制](knowledge-base-integrations.md#file-size-and-content-limits)。
+ **访问权限不足**-确认知识库具有访问文档源的适当权限。
+ **文档筛选**-检查筛选器或排除规则是否阻止对某些文档编制索引。

**要排除故障：**

1. 查看刷新历史记录，查看与无法同步的特定文档相关的错误消息。

1. 验证您的文档格式和文件大小是否符合要求。

1. 检查您的访问权限和连接设置。

## 刷新任务失败
<a name="refresh-job-fails"></a>

当知识库或数据源连接中出现配置错误时，刷新作业通常会失败。

**常见原因：**
+ **权限问题**-集成缺少访问数据源的足够权限。
+ **配置错误**-URL 或数据源连接设置不正确。
+ **资源限制**-源系统的速率限制。

**要解决这个问题：**

1. 查看刷新历史记录详细信息以了解特定的错误消息。

1. 验证所有连接设置和权限的配置是否正确。

1. 根据错误消息采取建议的操作。

## 刷新作业已完成，但出现问题
<a name="refresh-job-completes-with-issues"></a>

当刷新作业完成但出现问题时，该作业已成功处理，但某些文档遇到了问题。

**这是什么意思：**
+ **部分成功**-有些文档已成功同步，而另一些则失败。
+ **Document-level 错误**-个别文件可能存在格式问题、损坏或访问问题。
+ **元数据问题**-文档元数据或相关信息存在问题。
+ **大小或格式违规**-某些文件可能超过大小限制或格式不受支持。

**要解决这个问题：**

1. 查看详细的刷新报告以确定哪些文档遇到了问题。

1. 解决个别文档问题。

1. 解决问题后再次刷新。

## 刷新作业成功但未显示任何文档
<a name="refresh-job-succeeds-no-documents"></a>

如果刷新作业显示成功但您的知识库中未显示任何文档，请检查这些潜在原因。

**常见原因：**
+ **空源**-配置的数据源位置不包含任何文档。
+ **路径配置不正确**-源路径或连接设置未指向正确的位置。
+ **文档筛选器**-“包含” 或 “排除” 标准可能会过滤掉所有文档。
+ **缺少读取权限**-作业已成功连接，但缺少读取实际文档的权限。

**要解决这个问题：**

1. 验证您的数据源配置指向正确的位置。

1. 确认文件存在于指定位置。

1. 检查是否配置了适当的访问权限。

1. 查看任何可能排除内容的文档筛选器。

## 刷新期间出现文件格式问题
<a name="file-format-issues"></a>

快速知识库支持特定的文件格式。文件必须符合格式、大小和字符限制要求。有关支持的格式和限制的完整列表，请参阅[文件大小和内容限制](knowledge-base-integrations.md#file-size-and-content-limits)。

**要解决格式问题，请执行以下操作：**

1. 验证您的文件是否符合格式和大小要求。

1. 将不支持的格式转换为支持的格式。

1. 从文件中移除密码保护。

1. 检查文件是否已损坏。

## 访问被拒绝错误
<a name="access-denied-errors"></a>

访问被拒绝错误通常是由于身份验证或授权问题造成的。

**常见原因：**
+ **凭据无效**-身份验证令牌或密码可能已过期。
+ **权限不足**-集成中使用的账户缺乏对数据源的读取权限。
+ **网络限制**-防火墙或安全策略阻止访问。
+ **SSL/TLS 问题**-安全连接存在证书问题。

**要解决这个问题：**

1. **验证身份验证凭证**-确认身份验证凭据是最新且有效的。编辑集成以重新进行身份验证并生成新令牌。

1. **对于 Web Crawler 数据源** — 确认安全连接配置正确，SSL 证书配置正确且可信。

1. **联系您的系统管理员**-如果您仍然遇到访问问题，请联系您的系统管理员。他们可能需要调整权限或安全设置。

## ACL 验证错误
<a name="acl-validation-errors"></a>

如果您的同步报告显示状态为 S **KIPPED** 且错误类型为 **VALIDATION\_ERROR** 的项目，并显示消息 “文件没有 ACL 而 CrawlaCL 为真，正在跳过摄取”，则您的知识库连接器使用的应用程序注册缺少所需的 ACL 权限。

**要解决这个问题：**

1. 验证应用程序注册是否具有 ACL 爬网的正确 API 权限。所需的权限因连接器而异。请参阅连接器设置文档中的权限部分。

1. 确认所有必需权限均已获得管理员同意。

1. Re-run 修复权限后进行完全同步。

## 同步运行超过最大运行时间
<a name="sync-exceeds-maximum-runtime"></a>

如果同步运行的时间超过 14 天，Amazon Quick 将以**失败**状态结束运行，并显示*已超过最大同步时间*消息。当知识库配置为抓取的内容超过单次运行所能处理的内容时，通常会发生这种情况。

**要解决这个问题：**

1. 编辑您的知识库以减少每次同步的内容量。应用包含或排除过滤器，限制要抓取的文件类型或文件夹，或者将内容拆分到多个知识库中。

1. 对于网络爬虫数据源，如果您的目标是与大型公共网站（例如）聊天，请考虑改用 Web 搜索功能。`wikipedia.org`

1. 缩小范围后再次运行同步。

有关此限制的更多信息，请参阅[最大同步时长](knowledge-base-integrations.md#maximum-sync-duration)。