知识文档的三层

Cadau 把给智能体读的说明分成三层，方便你在对的范围里写对的内容：

系统层（全局）

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

工作区层（团队）

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

个人层（我的智能体）

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

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

• 在哪维护：

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

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

对话时怎么用

智能体会先根据 两层索引（根 index.json + 各主题子目录 index.json）命中相关文档，再读取 Markdown 正文作答。索引只是「目录」，正文改了但索引没重建，回答可能仍引用旧摘要或漏掉新篇。

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

与「操作助手」的关系

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

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