跳到主要内容

管理 AI 来源文档（上传与文档库）

快速设置

上传 PDF 并管理文档库大约只需 5 分钟。请保持页面打开，直到上传完成。

本指南介绍如何上传 PDF、导入网站来源以及管理文档库。 AVA 会先检查文件，然后由你的浏览器将文件直接发送到 S3。 当答案引擎为 Agent (Pi) 时，本指南还帮助你查看 Agent Wiki 冲突并重试失败的更新。 当答案引擎为 Agent (Pi) 时，你还会看到 Agent Wiki 状态列和 Conflicts 标签页。 文档、导入任务或冲突更新处理期间，AVA 会自动刷新列表。 终止状态的更新完成后，AVA 会继续刷新文档行，直到显示最终状态。 如果 Streamliner 的本地轮询窗口先结束，文档会保持 Processing，直到 AVA 读取远程结果。

Agent (Pi) 属性即使在迁移完成前，也始终会打开 Knowledge Wiki 文档库。 空文档库可以接受第一个 PDF，并发布第一次 wiki 更新。 上传第一个 Wiki V2 文档时，原始 RAG 文档不会自动复制。

对于采用 Knowledge Wiki V2 的属性，AVA 会在采用成功前保持当前知识处于活跃状态。 激活后，已采用的聊天机器人请求会使用新的 wiki，同时保留你的机器人指令和流式回复。 相同的已批准来源访问权限还可以支持适用的电话、视频、员工协助和电子邮件功能。

RAG 会隐藏 Agent Wiki 控件

如果聊天机器人的答案引擎为 RAG，你只能看到文档库。 Agent Wiki 列、Conflicts 标签页、警告横幅和解决工作区都会保持隐藏。 切换到 Agent (Pi) 以查看知识库更新。

前往： Communication Hub → AI Sources → Documents

现有书签仍可使用

旧的 Chatbot → Documents 链接会重定向到此处，并保留 Missing information 筛选条件。

文档管理页面，显示带有搜索、筛选和操作按钮的文档库

快速参考​

任务点击位置结果
开始上传Upload Document打开上传流程
选择文件文件选择器Streamliner 会先检查 PDF
发送文件浏览器上传步骤PDF 会直接发送到 S3
添加用途（可选）Purpose 步骤工作人员可以看到文档存在的原因
完成上传Finish创建文档并将其加入队列
保持页面打开同一浏览器标签页上传和完成流程不会中断
等待处理列表自动刷新无需手动刷新即可更新状态
处理缓慢的 Agent Wiki 作业让文档保持 ProcessingAVA 稍后会协调原始作业
检查 Knowledge Wiki V2 采用情况等待激活完成成功前当前知识会保持活跃
开始使用空的 Agent Pi 文档库Upload documents迁移完成前即可使用
发布第一次 Wiki V2 更新Update wiki发布待处理文档
跟踪知识库更新顶部进度面板仅在 Agent (Pi) 模式下可见
查看 Agent Wiki 同步Agent Wiki 列仅在 Agent (Pi) 模式下可见
查看冲突Conflicts 标签页或警告横幅仅在 Agent (Pi) 模式下可见
应用冲突解决方案暂存的冲突操作仅在 Agent (Pi) 模式下可见
重试失败的更新Retry failed update 或 Retry wiki update仅在 Agent (Pi) 模式下可见
重启停滞的更新Restart update10 分钟没有进展后可用
查看导入错误状态徽标或行消息查看文档未完成的原因
搜索文档Search 栏并按 Enter列表按关键词筛选
按状态筛选Status 下拉框仅显示 Active 或 Inactive
启用或停用Enable / Disable 操作AVA 完成导入作业后更新状态
删除文档Delete 或 Delete (n)确认后移除文件

重新生成文档知识​

Agent Wiki 最初会为现有属性使用一个共享的知识布局。 重新生成会将活跃来源转换为独立的文档包。

重新生成前

在重新生成成功完成前，当前知识会保持活跃。 AVA 处理来源期间，请保持页面打开。

  1. 前往 Communication Hub → AI Sources → Documents

  2. 在 Sources 标签页中，点击 Regenerate knowledge。

    ✓ AVA 会显示 Agent Wiki 进度面板。

  3. 等待面板显示 Agent Wiki is up to date。

    ✓ 成功重新生成后会出现 AI Usage 标签页。

尚未重新生成的属性会保留现有的共享来源行为。 迁移后，普通上传和来源更新会继续使用独立文档包布局。

了解 Knowledge Wiki V2 采用​

Knowledge Wiki V2 采用会在来源完成处理后，将属性迁移到较新的答案路径。 在采用成功前，AVA 不会切换活跃知识。 这样可以在迁移期间继续提供现有的聊天机器人答案。

激活后：

  • 已采用的聊天机器人请求会使用 Knowledge Wiki V2。
  • 已保存的 Bot Instruction 和备用行为会继续生效。
  • 流式回复会继续使用现有的访客聊天行为。
  • 启用后，来源访问权限可以包括 AI Phone、AI Video、Staff Assist 和 Email Autodraft。

开始使用空的 Agent Pi 文档库​

如果你的属性已经使用 Agent (Pi)，请立即打开 Knowledge Wiki。 即使迁移或发布准备工作仍在处理中，这一点也保持不变。

  1. 打开 Communication Hub → AI Sources → Documents。

  2. 打开 Knowledge Wiki，然后点击 Upload documents。

  3. 选择 Add as new document，然后选择 PDF。

  4. 查看待处理文档并点击 Update wiki。

    ✓ 处理完成后，AVA 会发布第一次 Wiki V2 更新。

现有的 RAG 文档仍然独立存在。 如果要将其内容加入 Wiki V2 文档库，请重新上传。

迁移保持独立

上传文档不会开始迁移，也不会将迁移标记为完成。 需要迁移现有 RAG 文档时，请使用 Advanced Settings → Answer Engine。

采用时间

在发布期间，符合条件的属性会启动 Knowledge Wiki V2 采用。 它不会自动为所有属性启动批量迁移。 在支持团队确认采用完成前，请保留当前文档可用。

开始或监控迁移​

迁移会将受支持的文档复制到 Wiki V2。 它不会删除原始 RAG 文档。 在迁移成功完成前，RAG 会保持活跃。

  1. 前往 Communication Hub → Chatbot → Setup。

  2. 打开 Advanced Settings → Answer Engine。

  3. 选择 Agent (Pi)。

  4. 确认迁移消息，然后点击 Sync documents and switch to Agent Pi。

    ✓ AVA 会显示迁移进度，同时当前答案引擎保持活跃。

  5. 同步运行期间保持页面打开。

成功后，打开 Communication Hub → AI Sources → Documents。 已迁移的属性会看到 Knowledge Wiki 工作区。

网站来源和仅限 GEP 的文档

网站来源和仅限 GEP 的文档不会复制到 Wiki V2。 迁移后，请将重要的网站内容作为 PDF 上传。 仅限 GEP 的来源会保留现有行为。

如果迁移失败但存在已保存的检查点，请点击迁移面板中的 Retry。 迁移重试同时需要文档写入权限和设置管理权限。 如果没有可用的检查点，请修复错误后开始新的迁移。 如果开始后不想切换，请点击 Cancel switch to Agent Pi。 取消不会删除已完成的 Wiki V2 迁移。

管理 Knowledge Wiki V2​

Wiki V2 会将上传的 PDF 转换为经过审核的主题。 在点击 Update wiki 前，更改会保持待处理状态。 导入期间，Agent Pi 会继续从已发布的 wiki 回答。

更新需要手动执行

上传、替换、移除或更改主题访问权限不会立即发布。 查看所有待处理更改，然后点击琥珀色栏中的 Update wiki (n)。

添加或替换 Wiki V2 文档​

  1. 打开 Communication Hub → AI Sources → Documents。

  2. 打开 Knowledge Wiki，然后点击 Upload documents。

  3. 在 What should this file do? 下，选择 Add as new document 或 Replace an existing document。

    ✓ 每个选项都会说明它将如何改变已发布的 wiki。

    Replace an existing document 在没有已发布文档时不可用。

  4. 选择 PDF，然后点击 Upload。

    ✓ 一次最多可以上传 20 个 PDF。

  5. 查看待处理的添加或替换内容。

  6. 文档准备好后，点击待处理更改栏中的 Update wiki (n)。

每个 PDF 必须介于 1 KB 和 6 MB 之间。 点击已发布的文件名即可打开或下载其 PDF。 使用 Remove upload 可在更新 wiki 前放弃待上传文件。 使用 Delete 可将已发布文档加入删除队列。 你可以在更新 wiki 前撤销待处理的删除。

待处理的添加或替换会在文档表格中显示琥珀色标记。 排队等待移除的文档名称会显示删除线。

查看待处理的 wiki 更改​

  1. 打开 Documents、Wiki Topics 或 Conflicts 标签页。

  2. 查看标签页下方的琥珀色待处理更改栏。

  3. 发布前检查待处理数量。

  4. 点击 Update wiki (n)。

    ✓ AVA 会为待处理更改启动一次手动 wiki 更新。

待处理数量增加时，按钮会闪烁三次。 启用减少动态效果或更新正在运行时，不会看到闪烁。 Missing information 页面不会显示待处理更改栏。

控制主题访问权限​

  1. 打开 Wiki Topics 标签页。

  2. 选择要配置的 AI 功能对应的渠道卡片。

    ✓ 每张卡片都会显示 X of Y topics 和进度条。

  3. 为该功能打开或关闭主题。

  4. 在适当情况下使用 Turn all on 或 Turn all off。

    ✓ AVA 会自动保存每个功能的主题访问权限。

更新 wiki 后，主题访问权限才会生效。 关闭所有主题后，该渠道无法从 wiki 回答。 如果某个渠道没有启用的主题，其计数会显示为红色。

重试失败的 wiki 更新​

你会看到： wiki 更新在部分主题完成后失败。

解决方法：

  1. 阅读进度面板中的失败步骤。

  2. 出现 Retry failed update 时点击它。

  3. 修复错误所描述的失败来源或页面。

  4. 等待验证和发布完成。

    ✓ AVA 会复用已验证的主题，并修复失败页面。

所有检查通过前不会发布任何内容。

失败运行具有持久且可恢复的导入检查点时，才会显示重试选项。 这包括可恢复的超时和阶段中断失败。 采用期间，迁移后的 Wiki 页面和旧版文档页面都提供此选项。 没有检查点的历史失败需要重新更新。 保存的恢复状态过期或不再匹配时，也需要重新更新。

重试权限

重试普通导入需要文档写入权限。 迁移重试还需要设置管理权限。

重新生成仍在运行​

你会看到： 进度面板显示某个阶段或百分比。

解决方法：

  1. 保持 Communication Hub → AI Sources → Documents 页面打开。
  2. 等待面板进入完成状态。
  3. 当前重新生成完成前，不要开始另一次重新生成。

重新生成需要恢复​

你会看到： 页面显示 Document knowledge needs recovery。

解决方法：

  1. 查看进度面板和任何来源错误。
  2. 点击 Retry knowledge generation。
  3. 等待面板完成。
  4. AI Usage 可用后打开它。

导入网站来源​

你可以将一个公开网站站点地图添加为 Agent Wiki 来源。 请使用以 .xml 结尾的 HTTPS 站点地图 URL，例如 https://example.com/sitemap_index.xml。

  1. 前往 Communication Hub → AI Sources → Documents

  2. 点击 Upload Document。

  3. 选择 Import website sitemap for Agent Wiki。

  4. 输入公开的站点地图 URL。

  5. 点击 Continue。

  6. 添加可选用途，然后点击 Continue。

  7. 查看站点地图并点击 Finish。

    ✓ 网站来源会出现在 Sources 中并进入处理流程。

AVA 会将网站条目标记为 Website sitemap source。 你可以在现有网站来源所在行点击 Refresh Website Content 来刷新它。

设置 AI 功能访问权限​

使用 AI Usage 选择哪些 AI 功能可以使用每个活跃来源。 每个来源都会保留自己的选择。

功能使用来源的用途
AI Chatbot回答访客聊天
AI Phone电话对话
GEP AI VoiceGEP 语音对话
AI Video视频通话辅助
Staff Assist团队支持
Email Autodraft起草回复

  1. 打开 AI Usage 标签页。

  2. 找到 PDF 或网站来源。

  3. 选择或清除允许使用的 AI 功能。

  4. 至少保留一个已选功能。

  5. 点击 Save changes。

    ✓ 该行会显示 All changes saved。

在 Sources 中停用来源会移除它对所有 AI 功能的访问权限。 再次分配功能访问权限前，请重新启用该来源。 保存更改后，等待知识处理完成，再测试回复。

计划权限​

  • Chatbot 文档工具需要付费计划。
  • 打开 Documents 需要 chatbot_document:read。
  • 上传文档需要 chatbot_document:write。
  • 没有匹配的权限时，AVA 会隐藏链接并阻止直接访问。
  • 免费版账户会看到升级提示，而不是文档库。

如需升级，请前往 Settings → Billing & Subscription。

开始前​

请确认以下要求：

  • 你有 chatbot_document:read 权限，可以打开文档库
  • 如果需要上传文档，你有 chatbot_document:write 权限
  • 你的文件是 1 KB 到 6 MB 之间的 PDF
  • 你已登录 Streamliner
  • 你会保持标签页打开，直到上传和完成流程结束

上传文档​

  1. 前往 Communication Hub → AI Sources → Documents

  2. 点击 Upload Document

    ✓ 上传流程会打开。

  3. 选择一个 PDF。

    ✓ Streamliner 会检查文件并准备上传。

  4. 完成浏览器上传步骤。

    ✓ PDF 会直接上传到 S3。

  5. （可选）添加简短用途，然后点击 Continue

    ✓ 用途会与文档一起保存。

  6. 查看摘要并点击 Finish

    ✓ 你会返回文档库。

保持标签页打开

上传或完成流程运行期间，不要关闭、刷新或离开页面。 如果标签页关闭，请从 Communication Hub → AI Sources → Documents 重新开始上传。

接下来会发生什么​

文档会进入处理流程。 列表会持续检查更新，直到文件完成索引。

对于已迁移的属性，请改用 Wiki V2 的 Upload documents 流程。 该流程支持多个 PDF、替换、待处理更改和受控导入。

理解文档状态徽标​

状态含义
Processing文档正在建立索引，尚未准备就绪
Failed后台处理作业无法启动或完成
Deleting文档已排入移除队列
Active在其范围允许的情况下，聊天机器人可以引用该文档
Inactive文档仍保留在库中，但不会被使用
关于状态更新

新上传的文档可能会在 Processing 中停留一小段时间。 页面会自动更新列表，直到状态发生变化。 如果远程 Agent Wiki 作业运行时间超过本地轮询窗口，Processing 属于正常状态。 原始作业仍在运行时，请不要重新上传文档或启动其他作业。 如果处理失败，最新错误会一直显示，直到你使用新上传的文件重试。

理解 Agent Wiki 状态​

状态含义
QueuedAVA 已将文档发送到 Agent Wiki，正在等待开始
ProcessingAgent Wiki 正在为该文档建立索引
Ready在其使用者范围允许的情况下，Agent Wiki 可以使用该文档
Failed导入未完成
DeactivatingAgent Wiki 正在关闭该文档
InactiveAgent Wiki 未使用该文档
Not syncedAgent Wiki 导入尚未开始
关于 Agent Wiki 状态

只有答案引擎为 Agent (Pi) 时才会看到此列。 停用文档时，可能会先看到 Deactivating，随后才是 Inactive。 状态为 Queued、Processing 或 Deactivating 时，页面会持续刷新。 运行达到终止状态后，AVA 会继续刷新文档行，直到显示最终状态。 如果本地轮询在远程作业达到终止状态前结束，文档会保持 Processing。 AVA 稍后会读取原始作业并应用最终文档结果。 如果更新失败并出现 Retry failed update，请使用它重新启动作业。 如果活动更新连续 10 分钟没有进展，AVA 会显示停滞进度消息和 Restart update。 点击 Restart update 以继续同一更新。 只有 AVA 完成 Agent Wiki 更新后才会显示 Inactive。 如果重试次数耗尽，该行可能会改为显示 Failed。

重启停滞的更新​

你会看到： 进度面板显示已有 10 分钟没有报告进展。

解决方法：

  1. 打开 Communication Hub → AI Sources → Documents。

  2. 确认活动的 Agent Wiki 更新显示停滞进度说明。

  3. 点击 Restart update。

    ✓ AVA 会重启现有更新并恢复进度跟踪。

对于这种情况，不要使用 Regenerate document knowledge。 该操作用于恢复失败的文档知识生成。

理解 AI 文档范围​

某些属性使用 AI 文档范围来控制每个 AI 功能可以使用哪些文档。 范围可以限制 Chatbot Agent、Phone AI、GEP AI Voice、Video Call、Staff Assist 和 Email Autodraft 使用的文档。

GEP AI Voice 只使用明确指定给 GEP AI Voice 的文档。 没有 GEP 范围的旧文档仍可供原有使用者使用。

这些旧文档不符合 GEP AI Voice 检索条件。

Active 或 Ready 状态确认文档处理已完成。 但这不代表每个 AI 功能都能访问该文档。

未重新生成范围的属性会保留之前的无范围行为。 更改允许使用的文档后，请保存来源并等待处理完成，再测试回复。

查看缺失信息​

快速检查

工作人员收到新通知后，打开 Missing information。查看一个主题大约需要 2 分钟。

Missing information 标签页会汇总聊天机器人或语音代理无法从酒店文档中回答的访客问题。 你可以利用这些主题找出值得添加到文档库的信息。 出现新主题时，AVA 会发送通用的 New missing information 通知。 通知不包含访客原话或生成的主题文本。 使用 Settings → Customizations → Push Notifications 可关闭此类别。

打开 Missing information​

  1. 前往 Communication Hub → AI Sources → Documents。

  2. 打开 Missing information 标签页。

  3. 选择一个主题，查看近期的访客问题。

    ✓ 你可以看到该主题来自聊天还是语音。

如果打开通知中的 View 链接，AVA 会打开关联主题。 如有需要，它会切换到通知对应的属性。

使用状态和渠道筛选条件来集中查看。 列表包含许多项目时，可按主题搜索。

解决或忽略主题​

  1. 打开你已查看的主题。

  2. 如有需要，将缺失的酒店信息添加到适当的文档中。

  3. 主题得到处理后，选择 Resolve。

    ✓ 主题会记录解决者及解决时间。

如果主题不需要更新文档，请选择 Dismiss。 如果已忽略或解决的主题需要跟进，请选择 Reopen。

新问题可以重新打开已解决的主题

新的匹配问题会重新打开已解决的主题。 已忽略的主题会一直保持忽略状态，直到你重新打开它。

了解已记录的问题​

  • AVA 会记录有关缺失酒店信息的问题。
  • AVA 不会记录有关访客预订、房间、账单或请求状态的问题。
  • AVA 会跳过已由公开网页搜索回答的问题。
  • 如果分类无法识别安全的主题，主题可能显示为 Unclassified question。
  • 启用记录后，聊天机器人回复和访客问题可能会发送给 OpenAI 进行分类。

访客原话会在事件记录中保留最多 180 天。 主题不会存储访客姓名、房间号、电子邮件地址或其他身份识别文本。 相关原话过期后，列表中的问题可能显示为空。

缺失信息标签页为空​

你会看到： Missing information 中没有主题。

解决方法：

  1. 确认你选择了正确的酒店。

  2. 检查 Open、Resolved 和 Dismissed 状态筛选条件。

  3. 询问管理员是否已为你的酒店启用知识缺口记录。

  4. 刷新 Communication Hub → AI Sources → Documents。

    ✓ 没有记录匹配问题时，标签页可能保持为空。

记录不会改变聊天机器人或语音代理的回复。 它只会收集用于改进文档的问题。

查看 Agent Wiki 冲突​

当页面显示冲突数量或出现 Conflicts 标签页时，请使用此功能。 Agent Wiki 工作期间，队列会保持实时更新。

  1. 打开 Conflicts。

    ✓ 知识审核队列会打开。

    如果 Sources 上出现警告横幅，也可以点击横幅。

  2. 从列表中选择一个冲突。

  3. 查看来源上下文和受影响的 wiki 行。

  4. 选择应保留的声明，或选择更正后的指导内容。

  5. 如果选择更正后的指导内容，请输入准确的最终措辞。

  6. 应用更改前查看受影响的主题。

  7. 如有需要，暂存更多冲突。

  8. 点击 Apply resolution(s)。

    ✓ AVA 会在底部显示批次摘要。 ✓ 被忽略的冲突不会更改 wiki。

  9. 点击 Confirm and update wiki。

    ✓ AVA 会为整个批次启动一次 wiki 更新。 ✓ 标签页上方会出现进度面板。

  10. 等待进度面板完成。

✓ 已解决的冲突会移至 Resolved、Ignored 或 Superseded。

为什么批次很重要

一次提交可以包含多个冲突。 AVA 仍只会为该批次启动一次知识库更新。

搜索和筛选文档​

  1. 在 Search 栏中输入关键词

  2. 按 Enter 应用搜索

  3. 使用 Status 下拉框筛选 Active 或 Inactive

  4. 点击搜索栏中的 X 清除搜索

    ✓ 完整列表会恢复。

启用或停用文档​

  1. 在列表中找到该文档

  2. 点击 Enable 或 Disable

  3. 确认操作

    ✓ 表格中的状态会更新。 AVA 会持续轮询导入作业，直到完成。 你可能会短暂看到 Deactivating，然后才出现 Inactive。

为什么该行可能一直处于忙碌状态

AVA 现在会等待最终导入结果，再更新文档状态。 如果后台作业无法启动，AVA 会将文档标记为 Failed。

删除文档​

删除单个文档​

  1. 点击文档行上的 Delete

  2. 确认操作

    ✓ 文档会从列表中移除。

删除多个文档​

  1. 使用左侧复选框选择文档

  2. 在摘要栏中点击 Delete (n)

  3. 确认操作

    ✓ 删除作业完成后列表会刷新。

故障排查​

仅允许 PDF 文件​

你会看到： 上传失败，并显示仅支持 PDF 的错误。

解决方法：

  1. 将文件转换为 PDF
  2. 重试上传

文件大小不得超过 6MB​

你会看到： 上传停止，并显示大小警告。

解决方法：

  1. 压缩 PDF 或将其拆分为更小的文件
  2. 一次上传一个文件

Finish 按钮一直不可用​

你会看到： 无法完成第 3 步。

解决方法：

  1. 等待浏览器上传步骤完成
  2. 如果文件链接缺失，请重新选择 PDF 并再次上传
  3. 再次尝试 Finish

上传期间标签页关闭​

你会看到： 关闭或刷新页面后，上传没有出现在文档库中。

解决方法：

  1. 返回 Communication Hub → AI Sources → Documents
  2. 开始新的上传
  3. 保持标签页打开，直到 Finish 完成

搜索没有结果​

你会看到： 搜索后表格为空。

解决方法：

  1. 点击 X 清除搜索
  2. 输入更短的关键词后按 Enter
  3. 移除 Status 筛选以显示所有文档

文档一直处于 Processing​

你会看到： 状态长时间保持为 Processing。

解决方法：

  1. 等待几分钟，让自动刷新运行
  2. 手动刷新一次页面
  3. 在文档仍处于 Processing 时，不要重新上传文档或启动其他导入
  4. 如果 30 分钟后仍未变化，请联系支持人员
为什么会发生这种情况

远程 Agent Wiki 作业可能在 Streamliner 的本地轮询窗口结束后才完成。 AVA 会继续以原始作业为准，并在之后应用其终止结果。

文档显示导入错误​

你会看到： 行内显示错误信息，或 Agent Wiki 显示 Failed。

解决方法：

  1. 阅读文档行上的错误信息
  2. 确认文件仍是有效的 PDF 且小于 6 MB
  3. 上传修正后的文档副本
  4. 如果同样的错误再次出现，请联系支持人员

Agent Wiki 更新停滞​

你会看到： 活动更新已有 10 分钟没有进展。

解决方法：

  1. 点击进度面板中的 Restart update。
  2. 更新运行期间保持 Communication Hub → AI Sources → Documents 页面打开。
  3. 等待进度恢复并显示最终状态。
  4. 如果更新再次停滞，请联系支持人员。

冲突更新失败​

你会看到： 所选冲突显示 Failed，或批次停止更新。

解决方法：

  1. 点击 Retry wiki update
  2. 等待进度面板重新启动
  3. 再次打开冲突并确认最终文本
  4. 如果同样的错误再次出现，请联系支持人员

冲突更新后文档行看起来没有更新​

你会看到： 冲突已解决，但来源行仍看起来处于待处理状态。

解决方法：

  1. 保持页面打开，直到进度面板达到终止状态
  2. 等待列表刷新
  3. 如果该行仍未更新，手动刷新一次页面
  4. 如果 30 分钟后仍未稳定，请联系支持人员

Agent Wiki 控件缺失​

你会看到： 看不到 Agent Wiki 列、Conflicts 标签页或审核横幅。

解决方法：

  1. 检查聊天机器人的 Answer Engine
  2. 如果是 RAG，Agent Wiki 界面按设计隐藏
  3. 切换到 Agent (Pi) 以管理知识库更新
  4. 如果已经选择 Agent (Pi)，请刷新页面后重试
  5. 请记住，在迁移准备状态变化期间，Agent (Pi) 会保持 Knowledge Wiki 可见

AI 功能找不到活跃文档​

你会看到： 某个 AI 功能不使用标记为 Active 或 Ready 的文档。

解决方法：

  1. 确认文档显示 Active 和 Ready。
  2. 检查该文档是否允许受影响的 AI 功能使用。
  3. 在 AI Usage 中保存来源更改。
  4. 等待处理完成后再次测试该 AI 功能。
  5. 如果文档仍不可用，请联系支持人员。

采用后聊天机器人答案仍使用之前的知识​

你会看到： 请求采用 Knowledge Wiki V2 后，聊天机器人回复仍使用之前的知识。

解决方法：

  1. 确认采用或 wiki 更新已达到成功的最终状态。
  2. 检查来源是否为 Active 和 Ready。
  3. 打开 AI Usage，确认已选择 AI Chatbot。
  4. 开始新的访客对话，再次测试答案。
  5. 如果激活后新对话仍使用之前的知识，请联系支持团队。

GEP AI Voice 找不到文档​

你会看到： GEP AI Voice 不会使用标记为 Active 或 Ready 的文档。

解决方法：

  1. 打开 Communication Hub → AI Sources → Documents → AI Usage。
  2. 为该文档选择 GEP AI Voice。
  3. 点击 Save changes。
  4. 等待文档处理完成，再测试 GEP 通话。
  5. 如果该来源早于 GEP 范围设置，请在选择 GEP AI Voice 后上传或更新来源。
GEP 文档范围

GEP AI Voice 不会搜索较早的无范围文档。 这样可以防止无关或过时的酒店信息传递到 GEP 通话中。

AI Usage 标签页缺失​

你会看到： 在 Sources 旁找不到 AI Usage。

解决方法：

  1. 检查聊天机器人是否使用 Agent (Pi)。
  2. 如果该属性尚未迁移，请点击 Regenerate knowledge。
  3. 等待 Agent Wiki is up to date。
  4. 如果重新生成失败，请点击 Retry knowledge generation。

无法清除所有 AI 功能​

你会看到： 无法清除最后一个已选功能。

解决方法：

  1. 为该来源至少保留一个已选功能。
  2. 点击 Save changes。
  3. 如需移除所有位置的访问权限，请打开 Sources。
  4. 对该来源点击 Disable。

网站来源不会刷新​

你会看到： 点击 Refresh Website Content 后，网站内容仍然较旧。

解决方法：

  1. 确认站点地图 URL 公开可访问且使用 HTTPS。
  2. 确认 URL 以 .xml 结尾并包含 sitemap。
  3. 再次启动 Refresh Website Content。
  4. 等待来源和 Agent Wiki 状态完成。
  5. 如果来源仍显示错误，请联系支持人员。

删除失败或没有反应​

你会看到： 确认删除后，文档仍然存在。

解决方法：

  1. 刷新页面并检查状态徽标
  2. 再次尝试删除
  3. 如果问题仍然存在，请联系支持人员

文档页面不可用​

你会看到： Documents 缺失，或其直接链接无法打开。

解决方法：

  1. 请管理员打开 Superadmin → Permissions → Roles。

  2. 确认你的角色包含 chatbot_document:read。

  3. 角色变更后退出登录，再重新登录。

  4. 打开 Communication Hub → AI Sources → Documents。

    ✓ 角色拥有访问权限后，Documents 页面和侧边栏链接会出现。

上传页面不可用​

你会看到： 可以打开 Documents，但上传页面无法打开。

解决方法：

  1. 请管理员打开 Superadmin → Permissions → Roles。

  2. 确认你的角色包含 chatbot_document:write。

  3. 角色变更后退出登录，再重新登录。

  4. 从 Communication Hub → AI Sources → Documents 打开 Upload Document。

    ✓ 角色拥有上传权限后，上传流程会打开。

仍然无法解决？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 多次尝试后上传仍然失败
  • ❌ 文档处于 Processing 超过 30 分钟
  • ❌ 重新上传后文档仍显示相同的导入错误
  • ❌ 刷新后删除仍未完成

建议包含以下信息：

  • 文件名和状态
  • 文档表格的屏幕截图
  • 问题开始的时间