知识库的三层

Cadau 把给智能体读的说明分成三层，方便你在对的范围里写对的内容。用法见 知识库的使用。

系统层（全局）

• 给谁用：帮助智能体（未选工作区或在消息里选中内置帮助时），以及需要全平台统一说明的场景。
• 放什么：新手引导、界面导航、账号与安全、产品能力总览等（即本 help/ 目录内容）。
• 在哪维护：平台管理员在 管理端 → 系统知识库 中编辑（部署目录默认 help/）。
• 改完以后：在管理端执行 「用 AI 重新生成索引」，刷新根目录与各主题的 index.json。

工作区层（团队）

• 给谁用：同一工作区里所有成员的智能体在对话时都会参考。
• 放什么：团队规范、项目背景、共用流程、对内 Wiki 等。
• 在哪维护：登录后进入 工作区协作 → 管理工作区知识库（须已选中该工作区）。
• 改完以后：在知识编辑页 「用 AI 生成索引」（内容无变化时可「强制重新生成」）。
• 批量迁移：知识编辑页可 上传文件夹 / 压缩包 或 下载压缩包（针对当前浏览位置；仅 .md 与 index.json）。
• 原文档案：同一页可切换到 原文档案，上传历史 Word / Excel / PPT / PDF / 图片；标记现行或归档。历史制度、旧通知放这里，不要改写成说明文档。

个人层（我的智能体）

• 给谁用：仅该智能体实例在对话时使用；默认不与同工作区其他成员共享。
• 放什么：

- 知识库：角色设定、专属话术、私有材料、业务口径等 Markdown 说明； - 记忆（与知识库分开）：你的偏好、已确认决策、项目节点等 跨会话个人材料（见 智能体记忆）。

• 在哪维护：

- 知识：智能体 → 我的智能体 → 「知识库」； - 记忆：同一实例的 「记忆」 页，或消息里 「记住」。

• 改完以后：知识库需在编辑页 「用 AI 生成索引」；记忆条目保存后 下一轮对话 即可生效（自动提炼在每轮问答后异步进行）。
• 批量迁移：智能体 知识库 编辑页同样支持 上传 / 下载压缩包（规则与工作区层相同）。
• 原文档案：同一页可切换到 原文档案，上传仅该智能体使用的历史文件；效力（现行/归档）与工作区层相同。
• 运行时文件分工（人格、操作规则、画像、记忆）：见 实践指南。

对话时怎么用

智能体会先根据问题取出相关 段落（说明文档与原文档案同一套检索），回答下方会列出 依据（篇名或原件文件名），点开即可预览原文。改正文或入库原件后，下一轮即可问到新内容。索引 index.json 仍用于选篇加分，正文改了请生成索引，以免摘要过旧。

普通问答默认只用 现行 档案；问「以前 / 旧通知」时才会看归档。

按场景才加载（可选）：索引条目可带 paths（如 ["/*.tsx"]）。仅当用户消息或附件路径与之相关时，该篇才会进入对话；通用导读、账号说明等不要填**。管理端维护系统知识时详见 系统知识库与检索索引；工作区与智能体知识同样支持，在对应知识编辑页生成索引即可。

与「操作助手」的关系

在智能体、技能、工作区协作、联络、我的等页面，操作助手也会结合当前模块上下文作答；其知识来源仍以工作区与系统层文档为主，个人层按所绑定智能体而定。

帮助智能体（在「消息」里，尤其未选工作区或刚注册后）主要读取 系统层 本目录文档；团队与个人层分别在工作区协作、我的智能体中维护。