豆包知识库如何按角色权限隐藏敏感问答对？

功能定位：为什么必须“按角色隐藏”

在豆包企业版里，知识库默认“可见即可用”，一旦把含价格、合同模板或客户名单的问答对公开，任何获得链接的成员都能一键引用。2026-04 上线的「角色权限隐藏」把粒度拆到“单条问答”，让运营者可以像给飞书多维表格设列权限一样，给不同角色打“可见/不可见”标签，既满足合规审计，也避免“把敏感内容复制到外部群”的二次泄露。

与旧版“整库加密”相比，新方案的最大差异是：不阻断检索。被隐藏的问答对仍参与语义索引，只是前端根据角色动态过滤，保证机器人回答的完整性，同时前端不渲染敏感文本，兼顾安全与体验。

前置检查：三件事确认后再动手

1. 你是「知识库管理员」或「超级管理员」角色，普通编辑只能建议隐藏，无生效权限。
2. 知识库已开启「企业级加密」开关（路径：管理后台→安全中心→数据加密），否则隐藏只对前端生效，接口仍可拉取原文。
3. 确认客户端版本≥v5.4.0，旧版本在角色解析时会回退到“整库可见”，导致规则失效。

最短可达路径：三平台入口对照

桌面端（Win / macOS）

左侧导航「知识库」→选中目标库→右上角「权限」图标（锁形）→「按角色隐藏」Tab→「新建规则组」。

Android / iOS

底栏「工作台」→「知识库」→长按目标库→「权限管理」→「角色隐藏」→右下角「＋」。

Web 管理后台

https://doubao.cn/admin → 知识库 → 权限策略 → 新建 → 类型选「角色级隐藏」→ 保存后 30 秒生效。

配置实战：一条问答对如何“隐身”

假设问答对 ID 为「Q_20260420_001」，含内部结算价，只允许「财务」与「高管」角色可见：

1. 在「按角色隐藏」面板点「添加规则」→ 名称「价格白名单」→ 选择「可见角色」→ 勾选「财务」「高管」。
2. 在「作用范围」里选「指定问答」→ 粘贴 ID 或用关键词搜索「结算价」→ 勾选后确认。
3. 打开「例外检测」开关，系统会提示「共 1 条，已生效 1 条」，并给出「模拟成员」入口。
4. 用「模拟成员」切换成「普通运营」角色，刷新页面，确认该问答对已从列表与搜索结果消失，即生效。

提示：规则保存后前端缓存 5 分钟，若测试未见效果，可强制刷新（Ctrl+F5）或退出账号重登。

常见分支：整库、文件夹、单条怎么选

粒度	适用场景	副作用
整库	外包团队临时接入，需一次性屏蔽全部内容	后续新增问答仍需手动加白，易遗漏
文件夹	按项目隔离，如「A 客户方案」文件夹仅客户成功团队可见	文件夹改名后规则失效，需同步更新
单条	敏感字段分散在不同主题，需精确到问答	ID 手动维护成本高，建议用「关键词正则」批量绑定

例外与回退：四条经验性观察

1. 「隐藏」≠「物理删除」，后台仍可通过「导出全部」拿到原文，若需最高保密，请启用「脱敏导出」并关闭「允许批量导出」。
2. 若规则与「共享链接」冲突，系统默认「最严原则」：只要任一规则隐藏，链接即不可见，避免“白名单链接外泄”。
3. 对同一条问答设置多条规则时，采用「或」逻辑：只要用户所属角色在任一规则的可视列表里即可见。
4. 回退方案：在规则列表左滑（移动端）或右侧「⋯」→「停用」即可立即恢复可见，无需重新录入问答 ID。

与机器人/第三方插件的协同

豆包机器人在回答时会先调用「权限过滤器」接口，若用户角色被隐藏，则该问答对不会进入候选集。经验性观察：在「智能体市场」下载的第三方客服插件若直接调用原始知识库 API（/v1/kb/raw），会绕过前端过滤，导致敏感内容被拉取。缓解办法：在插件设置里把「使用角色过滤」开关打开，接口将额外带上 user_role 参数，后端返回已过滤结果。

警告：飞书插件的「知识库助手」默认每 6 小时全量同步一次，若同步时未勾选「同步隐藏规则」，飞书侧会保留旧数据，出现“PC 端已隐藏、飞书端仍可见”的裂口。请务必在同步配置里启用「同步权限策略」并手动触发一次全量更新。

验证与观测：三步确认没漏

1. 使用「无痕浏览器」登录普通成员账号，搜索关键词，确认 0 条结果。
2. 在管理后台「审计日志」筛选「查看问答」事件，若仍出现被隐藏 ID，说明规则未生效或账号角色缓存异常，可强制同步角色。
3. 调用 /v1/kb/search?role=guest 接口，检查返回条数是否与前端一致，差值大于 0 即存在绕路。

适用/不适用场景清单

• 适用：10 人以上团队、需把价格/合同/客户数据混入通用知识库；定期外部审计；多品牌共用同一机器人但数据需隔离。
• 不适用：个人创作者单库<100 条，手动隐藏成本高；需物理隔离的绝密项目（建议单独建库并关闭联网索引）。

最佳实践 6 条速查表

1. 命名规则：「可见角色_内容类型_年月」，方便 90 天后快速归档。
2. 关键词正则：用「结算价|成本|毛利率」批量绑定，减少手动选 ID。
3. 月度审计：导出「规则作用清单」与财务/法务核对，删除过期白名单。
4. 双重验证：隐藏后让两名不同角色成员交叉搜索，确认 0 命中。
5. 插件同步：每次调整完 30 分钟内，手动触发飞书/钉钉插件全量更新。
6. 灾备回退：大促前一周冻结规则，避免误操作导致机器人答不上高频问题。

故障排查：常见 4 现象与对策

现象	可能原因	验证与处置
隐藏后自己仍可见	管理员默认拥有「上帝视角」	用「模拟成员」切到普通角色再测
移动端可见、桌面端不可见	缓存版本差异	退出账号→清除缓存→重登
机器人仍能引用敏感内容	插件绕路或未传角色参数	检查插件「使用角色过滤」开关
规则保存按钮灰化	含非法正则或角色已被删除	重新选择角色并简化正则

FAQ（必须使用 FAQPage Schema）

收尾：下一步行动建议

豆包知识库的角色权限隐藏不是“一键加密”那么简单，而是一张可细调的“纱窗”：既挡住敏感视线，又保持机器人对语义世界的完整感知。先从小范围试点——把含价格、客户名单的 10 条问答对加入「财务+高管」白名单，用两周时间观察搜索命中率与团队反馈，确认无业务阻断后，再逐步扩展到合同、专利、薪酬等主题。记得每月最后一个工作日做一次「规则体检」：删除过期白名单、更新角色列表、同步插件配置，让安全策略与组织变动同频，而不是一次配置就躺在后台睡大觉。