Bot 用户使用手册
- 知识库产品能力文档推导
- 普通用户快速上手指南.md风格参考
- 案例2卡片交互实践
Bot用户使用手册 v1.0
面向普通用户的"把 Bot 用好"进阶手册：怎么跟 Bot 聊天、怎么点卡片、怎么用搜索 / 文档 / 语音这些和 Bot 相关的功能。
建议先读《普通用户快速上手指南》，再来读本篇。
⚠️ 文中的菜单名称、按钮位置、入口路径以你实际使用的客户端界面为准；某项功能能不能用，还取决于公司管理员开启了哪些模块。
1. 你能用 Bot 做什么
1.1 三个词，一句话分清
| 名词 | 一句话 | 你在哪碰到它 |
|---|---|---|
| Bot（机器人） | OCTO 里的"机器人员工"——一个程序身份，能收消息、发消息、发卡片 | 群成员列表里带机器人标识的账号 |
| AI 助手 | 装了"AI 大脑"的 Bot——背后接了大模型，能看懂你的问题、生成回答、帮你干活 | 比如"产品管家""知识库助手"这类能问答的 Bot |
| Expert（专家） | 住在"回路"（OCTO 里的项目管理区，仅 Web 端）里的 AI 干将，被派去执行长任务、接受验收 | Web 端「回路」工作区（普通聊天里见不到） |
1.2 Bot 能帮你做的事
- 问答：@它提问，它查资料、调 AI 给你答案
- 办流程：它发一张卡片表单给你填，提交后自动走流程
- 看纪要：群消息刷不完，用"智能总结"一键出摘要
- 找东西：全文搜索帮你翻聊天记录、云文档、网盘文件
- 改文档：在文档评论区 @Bot，让它帮你整理、改写
- 收通知：Bot 定时往群里发日报、告警卡片
1.3 🔴 先立一个正确预期：AI 是"搭出来的"，不是"开箱即用"的
1.4 用 Bot 的三条安全习惯
- AI 回答要核实：涉及制度、金额、客户数据、商务决策的内容，AI 可能答错，用之前人工确认一遍。
- 敏感内容谨慎：你发给 Bot 的消息、在卡片里填的内容，Bot 背后的程序都看得到，而且谁在何时提交了什么全程留痕。别在卡片表单里填密码、验证码、密钥。
- 别刷 Bot：Bot 发消息有频率限制，故意高频 @它会被限流，等你真需要它时它反而"忙不过来"。
2. 与 Bot 对话基础
2.1 找到 Bot
- 群里找：群成员列表里带头像、名字旁带机器人标识的就是 Bot
- 私聊找：在联系人/私聊列表搜 Bot 名字（如"产品管家"），可发起一对一私聊
2.2 两种聊法
@知识库助手 请假超过 5 天要什么审批？- 一条消息里也可以同时 @ 多个 Bot（比如 @两个不同知识库的 Bot），各自独立回答
- 🔴 在群里一定带 @：不 @Bot 的普通群消息，Bot 很可能根本收不到。想让谁回答就 @谁，这是最稳的做法
2.3 怎么"说"给 Bot 听
- 打字：正常输入即可，长问题也没关系
- 语音输入：懒得打字就按住说话，系统帮你转成文字填进输入框——转好还能先改再发（详见第 7 章）
- 发送方式和普通消息一样（回车 / 发送按钮）
2.4 Bot 怎么"答"给你看
- 纯文字：直接一段话
- 卡片消息：长得像"迷你页面"的消息——有标题、表格、按钮、链接（详见第 3 章）
2.5 和 Bot 打交道的四条边界
| 边界 | 说明 |
|---|---|
| 🔴 Bot 得先在群里 | Bot 是被拉进群才能在群里回复的；没被拉进群的 Bot 你 @不到。想让它进群，找群主/管理员 |
| Bot 只是普通成员 | 它不是超级管理员：不能踢人、不能解散群、看不到它没加入的群的消息 |
| 它可能"不在线" | Bot 背后的服务也会停机维护。它不回消息时，先等一会儿，再找管理员 |
| 有频率限制 | 短时间内疯狂 @它会被限速。正常使用完全不用管这条 |
3. 卡片消息交互详解
卡片是 Bot 发的"迷你网页"式消息：信息更整齐，还能带按钮让你直接操作。
🔴 卡片只有 Bot 能发——你自己发消息发不出卡片，这是平台的硬规则。
3.1 三种卡片
| 卡片 | 长什么样 | 你能干什么 |
|---|---|---|
| 展示卡 | 一块排版好的信息：标题＋要点＋表格＋链接 | 看信息、点链接跳转、点"复制"按钮一键复制、点折叠区展开细节 |
| 交互卡 | 带输入框 / 下拉选项 / 开关 / 按钮的表单 | 填表单、点按钮提交（提交结果回传给 Bot 处理） |
| 进度卡 | 显示 Bot"正在思考 / 正在执行"的状态 | 等——看它干到哪一步了，不用反复催 |
3.2 展示卡：看、点、复制
📄 报销制度速查
─────────────────────────
交通 高铁二等座实报实销
住宿 一线城市 ≤400/晚
餐补 100/天
─────────────────────────
🔗 查看制度原文 📋 复制要点
▸ 展开特殊情形说明- 点链接按钮：跳转到网页 / 文档 / 系统。链接由 Bot 配置，跳转后若要求输账号密码，先确认链接可信
- 点复制按钮：要点内容进剪贴板，直接粘贴到别处用
- 点折叠区：展开更多细节
- 🔴 展示卡上的复制 / 链接 / 折叠是本地动作，点了不会通知 Bot；只有交互卡上的"提交"才会把你的操作回传给 Bot
3.3 交互卡：填表、提交
🏦 出差申请
─────────────────────────
出差城市 [ 北京 ▾ ]
起止日期 [ 请选择 ]
事由说明 [ ]
☐ 我已阅读差旅须知
─────────────────────────
[ 提交申请 ] [ 查看须知 ]- 填好各个输入框、选好下拉项、勾上确认开关
- 点提交按钮——你填的内容会回传给 Bot，由它背后的流程继续处理
- 提交后卡片通常会自动更新：比如变成"✅ 已提交，单号 XXX"，原来的按钮消失——这是防重复提交的正常设计，不是坏了
- 有些流程会再发一张确认卡让你核对信息，点"确认无误"后卡片锁定为"已受理"——锁定后改不了了，点之前看仔细
- 🔴 你在卡片里填的内容会被完整记录（谁、何时、填了什么），全程可追溯。别填密码、验证码、密钥
- 提交前检查一遍。不少卡片提交后无法撤回，只能联系 Bot 背后的管理员 / 人工流程处理
3.4 进度卡：看 Bot 干活
3.5 🔴 看不到卡片 / 卡片变成纯文字？
4. 常用 Bot 场景（示例对话）
以下 4 个场景为流程示意；具体 Bot 名字、卡片样式、回答内容以贵司实际配置为准。
场景 1：群里的智能问答
你（在「制度咨询」群里）：
@知识库助手 请假超过 5 天需要几级审批？
知识库助手（回复展示卡）：
📄 请假审批规则
· 3 天以内：直属上级审批
· 超过 5 天：直属上级 ＋ 部门负责人两级审批
🔗 跳转制度原文 📋 复制
▸ 展开各分公司差异说明
你：点「复制」→ 发给自己的主管人工确认（AI 答案，用前核实）
（随后 Bot 发来一张评价卡：「本次回答有帮助吗？」）
你：选「有帮助」→ 提交 → 卡片变为「已评价，感谢反馈 ✓」场景 2：卡片表单走流程（以出差申请为例）
审批 Bot（在群里主动发出交互卡）：
🏦 出差申请表
出差城市 [下拉选择] / 起止日期 [填写] / 事由 [填写]
☐ 已阅读差旅须知
[ 提交申请 ]
你：填完 → 点「提交申请」
审批 Bot（原卡片自动更新）：
✅ 已提交，单号 TRV-2026-0001，等待审批
（你的上级在群里收到审批卡片，点「同意」）
审批 Bot：
✅ TRV-2026-0001 已批准（卡片锁定，不可再操作）场景 3：定时信息通知
运营 Bot（每天 9:00 发到「运营日报」群）：
📊 昨日客服日报（展示卡）
咨询总量 1,258
Bot 自助解决 1,006（80%）
转人工 252
▸ 展开分渠道明细
🔗 查看完整报表
（指标异常时，追加一条普通消息）
运营 Bot：⚠️ 自助解决率环比下降 12%，@所有人 请关注知识库缺口。场景 4：文档里让 Bot 帮忙
（你在 Web 端一篇云文档里，对一段啰嗦的会议记录写评论）
你：@文档助手 把这段整理成 3 条要点
文档助手（在同一条评论线程里回复）：
已整理为 3 条要点并更新文档正文：
1. …… 2. …… 3. ……
（可在版本历史里对比修改前后）5. 搜索：聊天、文档、网盘一起翻
5.1 先确认：搜索开了吗
5.2 三个"搜索管道"
| 管道 | 能搜到什么 | 哪里搜 |
|---|---|---|
| 消息 | 聊天记录里的文字消息；聊天里发过的文件名和文件内容（PDF、Word 等文档正文也能搜到） | 顶部搜索框，手机和电脑都可用 |
| 云文档 | 云文档的正文内容（不只是标题） | Web 端 |
| 网盘文件 | 网盘文件的正文内容（不只是文件名） | Web 端（网盘本身仅 Web，见第 6 章） |
5.3 搜索体验细节
- 中文按"词"搜：内置中文分词（IK 分词），搜"报销"能命中"报销制度""差旅报销标准"这类内容，不需要一字不差
- 关键词高亮：结果里命中的词会高亮标出，方便一眼定位
- 近实时，不是秒回：新消息发出后要过几秒到几分钟才进入搜索（后台异步处理），刚发的消息立刻搜不到是正常的
- 权限隔离：你只能搜到你有权限看的内容——没拉你进的群、没分享给你的文档，搜不到
- 图片里的文字、语音消息的内容，当前不保证能搜到，别依赖
5.4 移动端注意
- 消息搜索：iOS / Android 都支持（入口位置以实际 App 界面为准）
- 文档 / 网盘搜索：建议用 Web 端；移动端支持情况以官方确认和实际体验为准
- 短时间内搜太频繁会被限速，稍等再搜
6. 文档协作：和同事、和 Bot 一起写
6.1 入口与形态
- 入口：Web 端左侧导航「📄 文档」。🔴 文档功能目前仅 Web 端有完整入口，手机 App 上别指望编辑文档
- 5 种文档：富文本文档（像在线 Word）、表格（像在线 Excel）、白板（手绘草图）、HTML 文档（网页式报告）、PPT 演示文稿
- 支持导入 / 导出 Word 和 Markdown 文件
6.2 多人协作
- 同时编辑：多人打开同一篇文档实时编辑，改动自动合并，不会互相覆盖
- 评论与 @人：选中一段文字发评论；评论里 @同事，他会收到提醒
- 版本历史：文档保留版本快照，可对比两个版本、恢复到旧版本（恢复前系统会自动保存当前状态，所以"回滚"本身也能撤销）
- 分享到群：文档可生成分享链接发到群里，同事点开即看（访问权限以分享设置为准，以实际界面为准）
6.3 让 Bot 参与文档
- 在文档评论区 @Bot，可以让它整理段落、回答与文档相关的问题；它的回复出现在同一条评论线程里
- 🔴 前提：这个 Bot 得被加为该文档的成员（当前为早期灰度能力，需管理员 / Bot 主人配置）
- ⚠️ 改动全程可追溯：谁、什么时候、改了什么，版本历史里都有——包括 Bot 改的
6.4 网盘（Drive）：文件的家
- 入口：Web 端左侧导航「📁 网盘」
- 两级空间：个人空间（你的私人文件）＋ 共享空间（团队文件）
- 聊天文件转存：聊天里收到的文件可一键转存到网盘，避免"文件过期找不着"——🔴 此功能仅 Web 端
- 文件正文搜索：网盘文件不止搜文件名，正文内容也能搜（Web 端，2026.08.24 起）
- 🔴 网盘整体仅 Web 端：iOS / Android 没有网盘功能。手机上想用网盘？开电脑
7. 语音功能：说比打快
7.1 🔴 第一次用要先"开通"
7.2 用法一：语音输入（说话变文字，填进输入框）
| 端 | 怎么用 |
|---|---|
| Web | 长按键盘左 Shift 键约半秒开始说话，松开结束；或点输入框旁的麦克风图标 |
| iOS / Android | 按住说话，松开结束 |
- 说完的话自动变成文字填进输入框——发送前可以先改再发（强烈建议：转写可能有个别错字，重要消息扫一眼再发）
- Web 端独有技巧：选中一段文字后再录音，说的话会替换选中的内容（语音改稿神器）
7.3 用法二：语音消息自动转文字
- 别人发语音消息给你，系统自动转写成文字显示，不用点开听
- 转写小能力：语音里提到同事名字会识别成 @；口语自动理顺成书面语；还会按语气标个小表情（😀 😤 之类）
- 🔴 转写文字谁看得到：所有能看到这条语音消息的人，都能看到转写文字。在群里发语音前想想：这段话变成文字公开挂着，合适吗？ 敏感内容别用语音说
7.4 语音的限制，先知道再少踩坑
- 🔴 只有"语音转文字"，没有"文字转语音"：OCTO 不会把消息读出声给你听（没有朗读功能）；Bot 也不会发语音消息——Bot 只发文字和卡片
- 🔴 Web 端发不了语音消息：Web 上你只能"说话转文字发出去"；想发真正的语音消息用手机 App（按住说话发送，以实际 App 为准）
- 单条语音限制：最长 60 秒、最大 3MB、最短 1 秒——超长内容请分条说，或直接打字
- 转写准确率：人名、术语、口音都可能导致错字——重要内容务必人工校对（详见第 9 章 Q4）
8. 移动端使用注意：手机干轻活，重活上 Web
8.1 手机上可以放心用的
- 收发消息、群 / 子区聊天
- 和 Bot 对话（私聊、群里 @Bot）
- 看卡片、填交互卡提交表单（简单卡片没问题）
- 语音输入（按住说话转文字）
- 语音消息自动转写
- 智能总结（App 底部「上下文」或右上角 ✨ 入口，以实际界面为准）
- 消息搜索
8.2 🔴 手机上没有 / 受限的
| 功能 | 状态 | 替代方案 |
|---|---|---|
| 网盘 Drive | ❌ 无（仅 Web） | 开电脑用 Web |
| 回路 Loop（项目管理 / 专家派活） | ❌ 无（仅 Web） | 同上 |
| 复杂卡片 | ⚠️ 渲染能力有限，可能降级为纯文字 | 内容不丢；要完整效果用 Web 或更新 App |
| 文档编辑 | ⚠️ 移动端文档入口待确认 | 用 Web 编辑 |
| 文档 / 网盘搜索 | ⚠️ 移动端支持待确认 | 用 Web 搜 |
8.3 一句话建议
手机用来聊、看、回复、听转写；写文档、用网盘、看复杂卡片、跑项目管理请切到 Web 端——Web 是功能最全的一端。
9. 常见问题（FAQ）
10. 附录
10.1 功能支持速查（Web / 手机 App）
完整明细见《端侧功能支持矩阵 v0.1》。图例：✅ 支持 ⚠️ 受限 / 待确认 ❌ 不支持
| 功能 | Web | iOS / Android |
|---|---|---|
| 和 Bot 对话（私聊 / @） | ✅ | ✅ |
| 卡片（展示 / 交互 / 进度） | ✅ 最佳 | ⚠️ 基础可用，复杂卡片可能降级文字 |
| 消息搜索 | ✅ | ✅ |
| 文档 / 网盘搜索 | ✅ | ⚠️ 待确认，建议用 Web |
| 文档协同 | ✅ | ⚠️ 入口待确认 |
| 网盘 Drive | ✅ | ❌ 仅 Web |
| 回路 Loop（项目管理） | ✅ | ❌ 仅 Web |
| 语音输入 | ✅（含选中替换） | ✅ 按住说话 |
| 语音消息转写 | ✅ | ✅ |
| 智能总结 | ✅ 最全 | ✅ 基础入口 |
| 发送语音消息 | ❌ Web 不能 | ⚠️ 应支持，以实际 App 为准 |
10.2 🔴 硬口径速查表（本手册核心红线汇总）
| # | 硬口径 | 一句话 |
|---|---|---|
| 1 | AI 能力需搭建 | OCTO 是 Bot 运行平台；智能问答等 AI 能力要对接大模型＋知识库搭建，"能构建" ≠ "点一下就有"（PS-07） |
| 2 | 卡片只能 Bot 发 | 普通用户发不出卡片消息 |
| 3 | 卡片自动降级 | 客户端不支持时降级纯文字，内容不丢 |
| 4 | 交互卡提交留痕 | 谁何时填了什么全程记录，别填敏感信息 |
| 5 | Bot 需拉进群 | 不 @ 收不到群消息；Bot 是普通成员，不是超管 |
| 6 | 网盘仅 Web | iOS / Android 无网盘；聊天文件转存网盘也仅 Web |
| 7 | 回路仅 Web | 项目管理 / 专家派活只能在 Web 端用 |
| 8 | 纯语音转文字 | 没有朗读功能；Bot 不会发语音消息 |
| 9 | Web 发不了语音 | Web 只能"说话转文字"；发语音消息用手机 App |
| 10 | 语音先开通 | 首次使用需在设置 → 语音设置确认协议 |
| 11 | 语音条数限制 | 单条最长 60 秒 / 最大 3MB / 最短 1 秒 |
| 12 | 转写可见性 | 语音转写文字对能看到消息的人可见，群里慎用 |
| 13 | 搜索默认关闭 | 全文搜索需管理员开启，默认不开 |
| 14 | 文档 @Bot 有门槛 | 需 Bot 被加为文档成员（早期灰度能力） |
10.3 相关文档索引
| 文档 | 什么时候看 |
|---|---|
| 《普通用户快速上手指南》 | 还不会聊天 / 传文件 / 建群？先看这篇（本手册前置读物） |
| 《端侧功能支持矩阵 v0.1》 | 想确认某功能手机上能不能用 |
| 《OCTO是什么 v2.0》 | 想了解 OCTO 整体是什么产品 |
| 《01-product/模块说明/》各模块文档 | 想深挖搜索 / 文档 / 网盘 / 语音 / 摘要某一块的能力边界 |
| 《案例2-金融机构-智能客服与业务Bot自动化》 | 想看卡片交互的深度实践（内部参考） |
| 《01-bot-developer-onboarding.md》《02-first-bot-walkthrough.md》 | 想自己开发 Bot 时再看（开发者向） |
状态水印：v1.0 | 更新 2026-09-22 | status: draft | confidence: medium | 面向最终用户的"用 Bot"手册；操作描述基于产品能力文档推导，菜单名称 / 按钮位置以实际客户端界面为准，未做产品走查验证；sensitivity: public，可对外分发（对外时建议附上贵司实际已开启的模块清单，避免用户找不到某功能）