知识文档目录：把制度交给助手，回答要有出处

表述：给要让助手按团队材料答疑的人。制度、流程、项目说明写成说明文档；历史 Word / PDF 作为原文档案留下。问的时候助手抽出相关段落，回答下方列出依据，可点开原文。人们常说的「知识库」，在产品里称 知识文档目录。

用户视角说明见 help/knowledge-layers/three-layers.md；机制真值见 docs/core-mechanisms/智能体调用知识文档的方式.md。

日期：2026-08-30

结论（先读这段）

Cadau 不会把整本制度一次性塞进助手。你维护一份 知识文档目录，助手按你这一句问话取出 相关段落，再据此回答。普通问答默认只用 现行 材料；你明确问「以前 / 旧通知 / 归档」时，才看归档件。

同一入口里有两块：

• 说明文档：继续写 Markdown——现行口径、FAQ、流程。
• 原文档案：上传历史 Word / Excel / PPT / PDF / 图片；可预览原件；标成 现行 或 归档。助手检索的是抽出来的文字，原文不改写成 Wiki，也不放进资料库。

一句话：说明写现行口径；原件留真源；对话只带相关段落，并且能看到出处。

flowchart TD
  Q["你对助手说一句话"] --> L{"这句话属于哪一层材料"}
  L -->|"产品怎么用"| G["系统知识文档\n帮助智能体"]
  L -->|"团队制度 / 项目 Wiki"| W["工作区知识文档\n本区所有助手共用"]
  L -->|"这只助手的专属口径"| U["智能体知识文档\n仅这一只"]
  G --> R["抽出相关段落"]
  W --> R
  U --> R
  R --> A["回答"]
  A --> C["下方列出依据\n点开可预览原文"]

谁会用、解决什么

适合已经有制度、通知、项目说明，希望助手按你们自己的材料说话、而不是凭空编的团队。

典型情况：

• 新同事问「年假怎么请」「报销走哪条」，希望答案跟现行制度一致，并能点开原文核对；
• 人事、法务、项目组各自有一只助手，但 同一工作区的制度只维护一份，不必每只助手拷一遍；
• 手里还有历年 Word / PDF 通知，不想先改写成 Wiki，又希望助手能按抽出来的文字答；
• 担心助手把整篇制度灌进上下文，闲聊时占满窗口；只希望问到哪、取哪几段。

对办事的人：选对助手直接问；回答下方有依据就可点开看。 对维护材料的人：团队共用写工作区一层；某只助手的话术写它自己那一层；改完生成索引，下一轮就能问到。

三层：写在哪、谁看得到

同一工作区里，不同成员各自的助手都会读到 工作区那一层。个人材料、某只助手的对外称呼，不要写进工作区层。

入口：

1. 系统层：管理端 → 系统知识文档。
2. 工作区层：先选工作区 → 工作区协作 → 管理工作区知识文档。也可对帮助智能体说「打开工作区知识文档」。
3. 智能体层：智能体 → 我的智能体 → 选中实例 → 知识文档。

未选工作区时，只能用系统层帮助说明（创建或改名工作区仍可代做）。进了某工作区，才能维护本区知识。

说明文档和原文档案

工作区与智能体知识页是 同一入口、两块内容，不是单独插件。

说明文档

写给助手读的现行口径。适合 FAQ、流程摘要、项目 Wiki。可粘贴图片和几秒到十几秒的说明短片。改正文后，下一轮即可问到新内容；请再 用 AI 生成索引，以免目录摘要过旧。

批量搬家：当前浏览位置可 上传文件夹 / 压缩包 或 下载压缩包（Markdown 与索引）。

原文档案

适合历史制度、旧通知、扫描件。上传后可预览原件；每件标 现行 或 归档。助手检索抽出来的文字，不把原件改写成知识树里的一篇 Markdown，也 不进资料库（资料库放可套用的表格和模板）。

解析失败时，向量测试会明确提示还没有段落，不会假装已经读懂。

对话时实际发生什么

你发一句，助手取出 相关段落（不是整本目录）。回答下方列出 依据：说明文档用篇名，原文档案用文件名；点开可预览。

工作区口径和某只助手的专属说明冲突时：这只助手写明要覆盖的，以它为准；否则以工作区为准；都没写到，应说明不知道，而不是编。

改完说明或入库原件后， 下一轮 就能问到。不必重启，也不必把全文再贴进对话。

先试检索：向量测试

知识文档目录提供 向量测试：输入一句助手会听到的话，立刻看到抽出的段落，以及实际用的方式——向量相近、关键词，或索引文件。

用来核对：

• 这句话会不会命中你刚上传的制度；
• 命中的是说明文档还是某份原件；
• 部署还没开向量时，会老实走关键词，不会假装已经向量化。

维护完先在这里试一句，再回到消息里问真人会问的那句，比凭感觉改标题更省事。

和旁边几样东西怎么分工

知识文档目录服务 对话答疑与团队 Wiki。旁边还有几样，入口不同，不要混放。

• 带版本、要人审的法规真源 → 规范库，不要只丢进知识文档冒充已审条文。
• 给同事下载去填的模板 → 资料库。
• 「以后都用条目回答」→ 说 记住，走记忆。
• 「张三电话、八月请假」→ 备忘，不要写进团队 Wiki。

帮助智能体主要读系统层，解答产品怎么用；团队制度请选中工作区里的助手再问。

你可以对助手说什么

说要做什么就代做；问「如何 / 怎么维护知识」才说明步骤。

未选工作区时：问产品怎么用，帮助智能体按系统知识答；团队制度请先选工作区，再对工作助手说一遍。

改完以后要做什么

1. 改正文或入库原件 → 下一轮对话即可用到新段落。
2. 用 AI 生成索引（内容没变也可强制重生成）→ 目录摘要、主题关键词跟上正文，检索更稳。
3. 可选：向量测试 里贴一句真人会问的话，看抽出的段落对不对。

系统层在管理端点「用 AI 重新生成索引」。工作区层、智能体层在各自知识页生成。

索引条目可以带「仅当问题或附件路径相关才用这篇」。通用导读、账号说明不要填这种限制，以免日常问答反而取不到。

什么时候不要硬用知识文档

• 希望 以后所有对话 都遵守的个人偏好——说「请记住」，不要写进团队知识。
• 法规原文、要人审的标准——进 规范库。
• 给同事套用的空白表格——进 资料库。
• 员工档案、请假、发票——进 备忘。
• 这一条对话正在做的事——写在 主题；做成后的结论写在 复盘。
• 只问 Cadau 产品怎么点——找 帮助智能体（系统层），不要把操作说明书误写成工作区制度。

目的写在主题，做成后的结论写在复盘，跨对话的习惯写在记忆，需要时再查的记录写在备忘，团队口径写在知识文档目录。

相关阅读

• 知识文档的三层 — 系统 / 工作区 / 智能体各写什么
• 谁可以维护哪一层 — 入口与改完后要生成索引
• 智能体调用知识文档的方式 — 段落怎么进对话
• 规范库 — 法规真源，不要和 Wiki 混放
• 资料库 — 可套用模板与表格
• 智能体备忘的使用 — 需要时再查的记录
• 产品介绍 — 知识文档在产品中的位置