知识库

知识库用于沉淀稳定、需要反复检索和共享的资料。完整链路是：创建知识库 → 添加资料 → 检查处理状态 → 编译知识卡 → 管理成员和 Waker → 新建对话验收。 一次性要求应放在当前任务，角色规则应放在 Waker 配置或记忆中；不要把所有信息都塞进知识库。

​

打开知识库

入口： 左侧导航 →「能力与资源」→「知识库」。 列表分为：

• 我创建的： 当前账号拥有，可以维护资料、成员和设置。
• 与我共享的： 由他人授权，实际可查看或编辑范围取决于成员权限。
• 精选： 产品提供的只读知识库。可以浏览并绑定给 Waker，但不能直接修改来源或卡片；是否显示取决于当前版本和区域。

每个知识库应只维护一个相对稳定的主题，例如“产品使用手册”或“客服标准口径”。不同主题拆开管理，便于授权、更新和测试。

​

创建知识库

1. 点击「新建知识库」。
2. 输入能够说明主题和范围的标题。
3. 确认后打开知识库，检查左侧资料区、资料/卡片视图、成员、定时和设置入口。

完成判断： 新知识库出现在“我创建的”列表中，可以正常打开，并且标题与预期主题一致。

​

使用精选知识库

「精选」适合直接复用已经整理好的公共或产品知识：

1. 打开「精选」，阅读知识库说明、适用范围和更新时间。
2. 在知识库或目标 Waker 的知识库设置中选择绑定。
3. 精选知识库会以只读方式提供给 Waker；无法在其中上传资料、修改卡片或管理成员。
4. 新建对话，用一个已有事实、一个边界问题和一个资料中不存在的问题完成验收。

需要补充或改写内容时，创建自己的知识库并导入有权限使用的资料，不要把“无法编辑精选知识库”当作权限故障。当前页面未显示精选入口时，以账号、区域和版本实际开放能力为准。

​

添加资料

在知识库中点击「添加资料」。页面会根据版本和区域提供本地文件、URL 或其他受支持的来源。

​

上传本地文件

1. 选择本地文件，确认格式和大小符合上传框提示。
2. 等待上传和解析完成。
3. 在资料列表中打开文件，检查标题、正文和页码等内容是否完整。

“文件已选择”或上传进度达到 100% 只表示传输完成，不代表已经可以检索。必须等待页面不再显示上传中、处理中或失败状态。

​

导入 URL

1. 输入包含 https:// 或 http:// 的完整地址。
2. 提交后等待系统读取和处理。
3. 打开资料，核对是否抓取了正文，而不是登录页、错误页或空内容。

需要登录、仅内网可访问、禁止抓取或依赖复杂脚本的网页可能无法导入。可以在有权限的前提下导出为支持的文件，再上传到知识库。

​

组织资料和文件夹

资料较多时使用文件夹按主题、版本或产品线组织，但不要让层级过深。标题中可以包含版本或生效日期，例如“退款规则-2026Q3”。 资料维护原则：

• 删除失效、重复和内容冲突的旧版本。
• 同一规则有多个来源时明确哪个是正式口径。
• 原资料更新后重新上传或使用页面提供的更新方式。
• 删除或替换资料后重新编译并执行测试问题。

​

理解资料与知识卡

「资料」是导入的原始内容；「卡片」是系统根据资料编译出的结构化知识。资料成功上传后，如果知识库尚未编译，Waker 可能还不能稳定使用新增内容。 不要只检查资料列表。还要确认知识卡已经生成、内容可读，并且没有把无关页眉、错误页或重复段落当成正式知识。

​

配置和执行编译

点击知识库侧栏中的「设置」。

​

选择编译模板

1. 打开「编译模版」。
2. 选择适合资料类型和使用场景的模板。
3. 按需填写追加提示词，只说明需要提取的知识类型和排除项，不要写入凭据或临时任务。

例如，代码规范知识库可以要求“只生成技术栈、代码规约和架构信息相关知识卡，忽略招聘和会议内容”。

​

手动编译

1. 打开「编译设置」。
2. 在资料确认完整后点击「开始编译」。
3. 等待编译完成，再切换到「卡片」检查结果。
4. 选取几条卡片与原资料核对。

​

自动或定时编译

资料经常更新时，可以开启自动编译，或从页面进入定时任务配置。启用前确认：

• 更新频率不会产生大量重复编译。
• 资料导入完成后再开始编译。
• 编译失败有明确的查看和重试方式。

自动编译只负责生成知识卡，不替代资料质量检查和业务验收。

​

管理协作者

点击成员入口可以查看所有者和协作者，并通过页面提供的账号标识添加成员。

1. 只邀请确实需要访问该主题的成员。
2. 按职责授予查看、编辑或管理权限。
3. 成员离开项目或职责变化时及时移除。
4. 上传敏感资料前重新检查成员范围。

只有所有者或具备管理权限的成员可以修改协作者。共享知识库不等于自动分配给所有 Waker。

​

绑定到 Waker

可以从知识库列表的 Waker 设置入口，或进入目标 Waker →「知识库」完成绑定。

1. 选择目标 Waker。
2. 只绑定与其职责相关的知识库。
3. 确认知识库已完成资料处理和编译。
4. 保存后新建对话验证。

知识库绑定关系应在资源中心和 Waker 详情两处保持一致。无关知识库过多会增加检索噪声，甚至让不同业务口径相互冲突。

​

测试知识库

至少准备三类问题：

1. 明确存在的事实： 预期回答准确，并能说明依据。
2. 边界或例外： 预期引用正确规则，不混用其他主题。
3. 资料中不存在的问题： 预期说明依据不足，而不是编造答案。

使用绑定后的 Waker 新建对话，不要继续旧聊天。将回答与原资料和知识卡同时核对。 完成判断： 已有事实回答正确、依据可核对；不存在的内容不会被编造；更新资料后重新编译和测试仍然通过。

​

更新或删除知识库

• 修改资料后重新编译，检查受影响的知识卡。
• 删除资料前确认没有唯一口径只存在于该资料中。
• 删除知识库前解除 Waker 绑定，并检查自主工作、Group 或 IM 场景是否依赖它。
• 删除知识库不会撤销已经发送过的回答，也不会自动清除包含相关信息的历史聊天。

​

常见问题