1. 产品概述

云霄是一站式企业知识管理与 AI 问答平台：把散落在各部门的文档、制度、问答资料变成"可检索、可对话、可共享"的知识资产，让任何人用一句自然语言提问，就能获得带出处引用的准确回答。

核心能力

2. 快速上手：5 分钟完成首次对话

完整流程只有五步：登录 → 确认模型 → 创建知识库 → 上传文档 → 提问。

登录平台
  ↓
第 1 步：确认 AI 模型可用（通常已由管理员配置好，可跳过）
  ↓
第 2 步：创建知识库（文档型 或 FAQ 型）
  ↓
第 3 步：上传文档，等待解析完成
  ↓
第 4 步：新建对话，选中该知识库提问
  ↓
获得带引用来源的 AI 回答 ✅

2.1 登录

首次登录会自动进入知识库列表页，并弹出新手引导（可随时点击右上角帮助按钮重新打开）。

2.2 确认模型已配置

路径：设置 → 模型管理

• 如果工作空间 Owner 已统一配置好模型（大多数情况），此步直接跳过；
• 否则需联系工作空间 Owner 配置：LLM 模型（用于对话回答）+ Embedding 模型（用于向量化检索）。

没有可用模型时对话功能无法使用，请先联系工作空间 Owner 确认。

2.3 创建知识库

1. 点击左侧「知识库」菜单 → 列表右上角「+」按钮；
2. 填写名称和描述；
3. 选择类型：
   • 文档型：上传文件，系统自动解析（最常用）；
   • FAQ 型：手动录入问答对，适合标准化常见问题；
4. 检索参数保持默认即可，点击创建。

2.4 上传文档

1. 进入知识库详情页，点击上传区域或直接拖拽文件；
2. 上传后系统自动完成解析，状态变为「已完成」后即可被检索提问。

解析时间取决于文档大小，一般几分钟内完成；大文件（如 100 页 PDF）约需 5–10 分钟。

2.5 提问

1. 点击左侧「新对话」；
2. 在对话窗口顶部选择刚创建的知识库（或直接使用内置「快速问答」）；
3. 输入问题回车发送，AI 流式输出回答；
4. 回答中的引用标记和下方相关文档均可点击查看原文出处。

3. 知识库管理

3.1 两种知识库类型怎么选

建议：资料型内容建文档库；"一问一答"式的标准答案建 FAQ 库。两者可同时绑定给同一个智能体。

3.2 支持的文档格式

3.3 上传文档的三种方式

3.4 文档管理操作一览

3.5 FAQ 问答对的处理

在 FAQ 型知识库中，每条问答对包含：

• 标准问：问题的规范表述；
• 相似问：用户可能的其他问法（越多命中越准）；
• 反例（可选）：不应命中的问题，避免误答；
• 答案：命中后返回的标准回答。

日常维护建议：

1. 新问题的标准答案确定后，及时录入或更新对应问答对；
2. 定期把用户真实提问补充到"相似问"中，提升命中率；
3. 通过「IM 问答反馈」流程收集的纠错答案，回流后会自动更新到原问答对，无需手工重复录入。

3.6 检索是怎么工作的（了解即可）

平台采用混合搜索：向量语义检索（理解意思相近的问法）+ 关键词检索（精确匹配专业术语），两者叠加返回最相关的内容。用户无需任何操作，创建知识库时保持默认开启即可。

4. 智能问答与智能体

4.1 两种问答模式

4.2 对话功能一览

4.3 内置「快速问答」

平台自带快速问答智能体，无需任何配置，自动检索你有权限的所有知识库，适合开箱即用的日常查询。

4.4 创建自定义智能体

路径：智能体 → 点击「+」

第 1 步：填写基本信息（名称、描述）
  ↓
第 2 步：选择 AI 模型（从已配置的模型中选择）
  ↓
第 3 步：绑定知识库（可多选，智能体只检索这些库）
  ↓
第 4 步：编写系统提示词（定义角色与行为边界）
  ↓
第 5 步：（可选）开启工具能力 → 保存

系统提示词示例：

你是供应链部门的智能助手，负责回答供应链系统相关问题。
请严格基于知识库内容回答；如果知识库中没有相关信息，请明确告知"暂无相关资料"。
回答时附带引用来源，方便用户查阅原文。

可选工具能力：知识库检索（RAG）、网络搜索、数据库查询、Wiki 编辑、MCP 工具、文档搜索、远程智能体调用。一般业务场景只需开启知识库检索即可。

4.5 智能体管理

5. 协作与共享

5.1 共享方式对比

共享流程示意：

本部门知识库
   ├── 指定共享给部门 B ──→ 部门 B 成员在其列表中看到「共享」库，可检索提问
   └── 设为全局 ─────────→ 全平台所有用户在各自列表中看到，只读检索

共享是"授权引用"而非"复制"：源库更新后，共享方检索到的内容同步更新，无需重复维护。

5.2 共享空间

路径：左侧导航 → 共享空间（Admin 及以上可见）

共享进来的资源会出现在知识库 / 智能体列表的「共享」标签页中。

5.3 邀请成员

1. 设置 → 成员管理 → 邀请，生成邀请链接；
2. 把链接发给被邀请人；
3. 对方打开链接 → 注册 → 自动加入工作空间。

角色建议：普通部门成员给 Editor（可上传维护文档），核心管理人员给 Admin（可删文档、管成员、配共享）。

5.4 部门空间与钉钉组织架构

平台支持从钉钉同步组织架构，自动为各部门创建独立工作空间：每个部门拥有自己的知识库和智能体，互不干扰；需要协作时通过共享功能打通。

6. 业务系统集成（按需）

路径：设置 → 集成（Admin 权限）

API 接入要点：

• 创建 Key：设置 → 集成 → API → 创建 API Key；
• Key 类型：Full Access Key（完全访问）或 Scoped Key（限定知识库范围与能力，推荐按最小权限授予）；
• 鉴权方式：请求头携带 X-API-Key: <your-key>。

7. 角色与权限速查

角色层级：Owner → Admin → Editor → Viewer（高级别自动包含低级别全部权限）。

¹ 删除单个文档需要是知识库创建者或 Admin 角色。

8. 典型业务场景

场景一：部门知识沉淀

目标：把部门散落各处的资料变成"问一句就有答案"。

1. 创建文档型知识库「部门资料库」，上传历史文档（手册、制度、培训资料）；
2. 创建智能体「部门助手」，绑定该知识库，提示词限定只答本部门业务问题；
3. 邀请部门成员加入（Editor 角色），日常遇到资料更新直接上传替换；
4. 新人入职后直接对话获取答案，无需老员工口头交接。

场景二：标准化问答与客服支持

目标：高频问题精准命中，减少重复答疑。

1. 创建 FAQ 型知识库，录入标准问答对（标准问 + 相似问 + 答案）；
2. 配置钉钉 / 企业微信机器人绑定该库，在群里直接 @机器人提问；
3. 通过「IM 问答反馈」流程收集机器人答错的问题；
4. 工作空间 Owner / Admin 在反馈页面填写正确答案并回流，自动更新到原问答对，机器人下次即可答对——形成"发现错误 → 纠正 → 自动生效"的闭环。

场景三：制度 / 资料全平台发布

目标：一份资料全员可查，且只读防篡改。

1. 将制度类知识库设为全局知识库（由工作空间 Owner 开启）；
2. 全平台用户在各自知识库列表中看到该库（只读）；
3. 后续制度修订只需更新源库，全员检索到的内容同步生效。

场景四：跨部门项目协作

目标：项目组内多部门共用一套项目资料。

1. 项目牵头部门创建知识库并上传项目资料；
2. 通过「指定共享」把库共享给参与部门；
3. 各部门成员在自己空间检索提问，源库统一维护，避免多份拷贝不一致。

9. 常见问题（FAQ）

Q1：文档上传后多久可以提问检索到？

通常几分钟内完成解析。知识库详情页可看到每个文档的解析状态；大文件（如 100 页 PDF）可能需要 5–10 分钟。状态变为「已完成」后即可正常检索。

Q2：为什么我删不了某个文档？

删除单个文档需要知识库创建者或 Admin 角色，这是防止误删的安全设计。Editor 可以勾选多个文档进行批量删除。

Q3：如何让其他部门看到我的知识库？

两种方式：

1. 指定共享：知识库编辑 → 共享设置 → 选择目标组织；
2. 全局知识库：由工作空间 Owner 开启全局，全平台可见（只读）。

Q4：AI 回答的引用出处可以查看原文吗？

可以。回答中的引用标记和下方「相关文档」链接都可以点击，会打开文档详情显示完整内容，方便核对。

Q5：回答不准确怎么办？

1. 确认知识库中是否已有相关内容——没有就先补充文档或 FAQ；
2. 在 FAQ 库中把用户真实问法加入「相似问」，提升命中率；
3. 通过「IM 问答反馈」提交正确答案，回流后自动更新问答对；
4. 仍不理想时，可调整智能体的系统提示词或联系工作空间 Owner 优化检索参数。

Q6：如何接入钉钉群机器人？

路径：设置 → 集成 → IM → 钉钉。按引导完成：① 在钉钉开放平台创建应用；② 配置 App Key 和 App Secret；③ 设置消息回调地址；④ 在钉钉群中添加机器人。

Q7：业务系统如何通过 API 接入？

路径：设置 → 集成 → API → 创建 API Key。请求头携带 X-API-Key: <your-key> 即可鉴权。建议为不同业务系统创建独立的 Scoped Key，按需限定可访问的知识库和能力范围。

Q8：支持哪些 AI 模型？

模型由工作空间 Owner 统一配置并维护。

Q9：如何修改界面语言和主题？

支持中文、英文、韩文、俄文四种语言；主题支持浅色 / 深色 / 跟随系统。路径：点击左下角头像 → 设置 → 常规。

Q10：我的数据安全吗？谁能看到？

• 每个部门（工作空间）的知识库默认只对本部门可见；
• 共享需要资源方主动授权，全局库需由工作空间 Owner 开启且为只读；
• 平台部署在公司自有服务器，文档存储于受控的对象存储与数据库中。

附录：上手检查清单

• 已成功登录平台
• 确认 AI 模型可用（或已联系工作空间 Owner）
• 创建至少一个知识库
• 上传至少一份文档并等待解析完成
• 完成一次带引用来源的问答对话
• 会用 @ 提及知识库、会查看引用出处
• （可选）创建部门专属智能体
• （可选）把知识库共享给协作部门
• （可选）接入钉钉 / 企微 / 飞书机器人
• （可选）邀请团队成员加入

技术支持：使用过程中遇到问题，请联系平台支持团队。