跳到主要内容

管理 Chatbot 文档（上传 + 文档库）

快速开始

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

本指南帮助你将 PDF 上传到聊天机器人知识库，并管理文档库。 AVA 会先检查文件，然后你的浏览器会直接将文件发送到 S3。 如果你的商户使用 Agent 模式，你还会看到一个 Agent Wiki 状态列。 AVA 会在新文档处理中自动刷新列表。 如果文档发生导入错误，刷新后该行仍会保留最新状态和错误信息。

前往： Chatbot → Documents

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

快速参考​

任务点击位置结果
开始上传Upload Document打开上传流程
选择文件文件选择器Streamliner 会先检查 PDF
发送文件浏览器上传步骤PDF 会直接上传到 S3
添加用途（可选）Purpose 步骤员工可看到文档存在的目的
完成上传Finish文档已创建并进入队列
保持页面打开同一浏览器标签页上传和完成不会被中断
等待处理列表自动刷新状态无需手动刷新即可更新
查看 Agent Wiki 同步Agent Wiki 列查看 queued、processing、deactivating、ready、failed、inactive 或 not synced
查看导入错误状态徽标或行消息查看文档未完成的原因
搜索文档Search 输入框 + 按 Enter列表按关键词筛选
按状态筛选Status 下拉框仅显示 Active 或 Inactive
启用或停用Enable / Disable 操作AVA 完成导入作业后更新状态
删除文档Delete 或 Delete (n)确认后移除文件

计划权限​

  • 聊天机器人文档工具需要付费计划。
  • 免费版账户会看到升级提示，而不是文档库。

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

开始前​

请确认以下条件：

  • 你有管理 Chatbot 文档的权限
  • 你的文件是 1 KB 到 6 MB 之间的 PDF
  • 你已登录 Streamliner
  • 你会保持标签页打开，直到上传和完成流程结束

上传文档​

  1. 前往 Chatbot → Documents

  2. 点击 Upload Document

    ✓ 上传流程会打开。

  3. 选择一个 PDF。

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

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

    ✓ PDF 会直接上传到 S3。

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

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

  6. 查看摘要并点击 Finish

    ✓ 你会返回文档库。

保持标签页打开

在上传或完成处理运行时，不要关闭、刷新或离开页面。 如果标签页关闭，请从 Chatbot → Documents 重新开始上传。

接下来会发生什么​

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

理解文档状态徽标​

状态含义
Processing文档正在建立索引，尚未可用
Deleting文档已进入移除队列
Active聊天机器人可以引用该文档
Inactive文档仍保留在库中，但不会被使用
关于状态更新

新上传的文档可能会在 Processing 中停留一小段时间。 页面会自动更新列表，直到状态发生变化。 如果处理失败，最新错误会一直保留显示，直到你替换文件。

理解 Agent Wiki 状态​

状态含义
QueuedAVA 已将文档发送到 Agent Wiki，正在等待开始
ProcessingAgent Wiki 正在为该文档建立索引
ReadyAgent Wiki 可以使用该文档
Failed导入未完成
DeactivatingAgent Wiki 正在停用该文档
InactiveAgent Wiki 未使用该文档
Not syncedAgent Wiki 导入尚未开始
关于 Agent Wiki 状态

只有商户使用 Agent 模式时才会看到这一列。 当你停用文档时，可能会先看到 Deactivating，随后才是 Inactive。 当状态为 Queued、Processing 或 Deactivating 时，页面会持续刷新。 只有在 AVA 完成 Agent Wiki 更新后，才会显示 Inactive。 如果重试次数耗尽，行内也可能显示 Failed。

搜索和筛选文档​

  1. 在 Search 输入框中输入关键词

  2. 按 Enter 应用搜索

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

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

    ✓ 将恢复完整列表。

启用或停用文档​

  1. 在列表中找到该文档

  2. 点击 Enable 或 Disable

  3. 确认操作

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

为什么这一行会一直忙碌

AVA 现在会等待最终导入结果，再更新文档状态。 如果异步路径不可用，AVA 会回退到旧的同步流程。

删除文档​

删除单个文档​

  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. 返回 Chatbot → Documents
  2. 重新开始上传
  3. 保持标签页打开，直到 Finish 完成

搜索没有结果​

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

解决方法：

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

某个文档一直处于 Processing​

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

解决方法：

  1. 等待几分钟，让自动刷新运行
  2. 手动刷新一次页面
  3. 如果 30 分钟后仍未变化，请联系支持

文档显示导入错误​

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

解决方法：

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

删除失败或没有反应​

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

解决方法：

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

仍然卡住？​

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

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

建议附上：

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