知识库
知识库是 MagicAI 用来给数字员工提供业务上下文的模块。把团队资料、业务规则、产品手册、FAQ 上传进去后，AI 智能团队 / Agent Team、专业技能和工作流就能在执行时引用这些内容，而不是只给通用建议。
| 内容 | 适合放进知识库 |
|---|---|
| 产品说明、操作手册 | 是 |
| 业务规则、SOP、流程规范 | 是 |
| 常见问答、客服 FAQ | 是 |
| 项目背景、接口说明、测试用例 | 是 |
| 代码仓库 | 部分（关键文档可以，整库一般不进知识库） |
| 实时变更的业务数据 | 否（用 连接 直接查数据） |
| 密码 / Token / Cookie | 否（统一放 连接） |
主流程：创建一个可用的知识库
Section titled “主流程：创建一个可用的知识库”步骤 1：按业务主题创建知识库
Section titled “步骤 1：按业务主题创建知识库”在左侧导航选 知识库，点击 新建。
- 名称要让团队能一眼看懂：例如“客服话术”“产品说明”“风控规则”。
- 描述写清楚边界：包含什么、不包含什么、谁负责更新。
- 一个知识库聚焦一个主题，不要把所有资料塞进同一个库。
成功标准：在知识库列表里能看到刚创建的库，状态是“待上传 / 空”。
步骤 2：上传资料
Section titled “步骤 2：上传资料”进入这个知识库，把对应的文档拖进去或选择文件上传。
支持的常见格式：
- 文档：Markdown、PDF、Word、TXT。
- 表格：Excel、CSV。
- 网页：粘贴 URL 或保存为 HTML。
- 图片型材料：建议先转成可读文本再上传。
建议：
- 文档命名清晰，例如“2026-01 客服话术 v3.md”。
- 同主题的资料一起上传，避免后续召回时来回切换。
- 一次上传不要太多，先小批量验证质量再继续。
步骤 3：等待解析完成
Section titled “步骤 3：等待解析完成”上传后，知识库会对文档做解析与切分。
- 状态通常会经历：待解析 → 解析中 → 已就绪 / 失败。
- 失败的文件会标红，可以点开看原因（格式不支持、内容为空、过大等）。
- 解析没完成前，召回结果会偏弱。
成功标准：所有计划上传的文件都到“已就绪”状态。
步骤 4：用真实问题测试召回
Section titled “步骤 4：用真实问题测试召回”不要把没验证过的知识库直接交给 AI。先在知识库里做一次测试问答：
-
选 3～5 个业务里真实出现过的问题，例如：
客户反馈商品有破损，应该按什么流程退款？2026 年新版退款规则有哪些和老版的差异？ -
看返回片段是否：
- 命中正确文档。
- 引用的内容是最新版。
- 没有把无关资料拉进来。
-
如果召回不准：
- 检查文件命名、是否包含正确章节标题。
- 拆分过大文件，避免一篇文档同时讲多个不相关主题。
- 把同义词写进文档（例如“退款 / 退货 / 退单”）。
成功标准：测试问题能稳定命中正确内容，没有明显幻觉。
步骤 5：在 AI 智能团队 / 工作流中引用
Section titled “步骤 5：在 AI 智能团队 / 工作流中引用”知识库准备好后，在使用的地方引用：
- AI 智能团队 / Agent Team：在对话里挂载该知识库，再提问。
- 工作流自动化：在节点中选择对应知识库作为上下文输入。
- 专业技能：让技能调用知识库做检索增强。
可以在提示词里明确写：
请基于「客服话术 v3」知识库回答客户的退款问题，并在最后给出文档来源。成功标准：数字员工的回答里带上了知识库片段或来源标注，不再只给通用建议。
FAQ 形态怎么做
Section titled “FAQ 形态怎么做”如果知识主要是问答型，可以在文档里直接整理成 FAQ 段：
Q：商品破损怎么处理？A：先让客户拍照，按 SOP 流程在 24 小时内提交售后……
Q：超过 7 天还能退款吗？A：根据 2026 年新版规则……知识库会把 Q / A 一起切分，召回时通常更准。
维护知识库的几个习惯
Section titled “维护知识库的几个习惯”- 按主题拆库，避免一个库塞太多内容。
- 定期更新和下线过期资料，避免 AI 引用旧规则。
- 在文档里写明适用范围和更新时间，例如开头加“适用范围 / 最后更新于”。
- 配负责人，谁更新、谁审核要清晰。
- 每次重大变更后跑一遍测试问题，确认召回还正确。
| 你遇到的情况 | 处理方式 |
|---|---|
| 没有创建知识库的入口 | 检查账号是否有创建权限，必要时联系管理员 |
| 文件上传后一直“解析中” | 等几分钟再刷新；持续失败查看失败原因或拆小文件 |
| 测试问答命中不准 | 拆分大文件、改善文件命名、补同义词 |
| AI 不引用知识库 | 在对话里明确指定知识库，并要求“引用文档来源” |
| 资料里有敏感信息 | 把敏感字段去掉再上传，凭据统一放 连接 |
- 让数字员工用上知识库：进入 AI 智能团队 / Agent Team。
- 让工作流引用知识库：阅读 什么是工作流自动化（RPA）。
- 把检索动作沉淀成可复用能力：阅读 技能中心。
- 想理解知识库 / 技能 / 连接如何协作：看 技能、知识库与连接如何协作。