HiAgent知识库权限设置：5步完成配置附官方视频获取方法
[1] 一句话结论
本指南将教你完成HiAgent知识库权限配置，附官方视频获取路径。
[2] 适用场景与不适用场景
适用场景
我们在多个企业客户的实践中验证，以下场景适用本方案：
- 适合企业部门级知识库，需要给不同角色配置读写/仅查看权限的场景
- 适合涉密知识库，需要开启私密模式仅核心人员可访问的场景
- 适合团队规模≥10人，需要批量邀请成员并控制加入规则的场景
不适用场景
- 如果你的场景是需要给外部匿名用户开放知识库访问，不建议用本方案，建议参考火山引擎内容分发CDN搭配静态站点方案
- 如果你的场景是需要基于用户标签做动态权限管控，不建议用本方案，建议对接火山引擎身份服务IAM做二次开发
[3] 前置准备
- 火山引擎HiAgent控制台访问权限，账号需拥有知识库管理员角色
- HiAgent平台版本≥V2.1.0
- 准备好需要授权的成员账号列表
- 预计总操作耗时10分钟
[4] 分步实现
步骤1：进入目标知识库配置页
步骤说明：首先登录HiAgent控制台，进入「知识库管理」模块，找到需要配置权限的目标知识库点击进入。这一步是所有配置的基础，跳过的话无法找到对应的权限入口。
预期结果：成功进入知识库主页，右上角可见「分享」按钮。
⚠️ 常见错误：进入知识库列表后找不到目标知识库
原因：当前账号没有该知识库的管理员权限，仅拥有查看权限的账号无法进入配置页
解决方法：联系知识库创建者或平台管理员给你的账号分配知识库管理员权限。
步骤2：打开权限配置面板
步骤说明：点击知识库右上角的「分享」按钮，弹出权限配置面板。我们建议你先调整基础权限规则，再邀请成员，避免后续邀请的成员权限不符合预期。
预期结果：权限面板正常打开，可见「内容查看权限」「私密模式」「分享确认规则」三个核心配置项。
步骤3：配置基础权限规则
步骤说明：根据业务需求调整三个核心规则：1. 关闭内容查看权限后成员仅可见文档标题和AI摘要；2. 开启私密模式后知识库仅创建者本人可访问；3. 关闭分享确认规则后成员收到邀请即可自动加入无需手动确认。调整完成后点击「保存配置」。
预期结果：弹出「配置保存成功」的提示框。
⚠️ 常见错误：开启私密模式后其他管理员也无法访问知识库
原因：私密模式的权限优先级最高，会覆盖所有已配置的成员权限
解决方法：如果需要给其他管理员开放权限，先关闭私密模式，再单独给对应账号分配管理员权限。
步骤4：邀请授权成员
步骤说明：点击权限面板下方的「邀请成员」按钮，输入需要授权的成员账号，选择对应的角色（查看者/编辑者/管理员），点击发送邀请。
预期结果：受邀成员会收到站内通知，可通过通知入口加入知识库。
步骤5：管理已授权成员
步骤说明：点击知识库右上角的「成员」按钮，可查看所有已加入的成员列表，支持修改成员角色或移除成员权限。
预期结果：成员列表加载正常，修改/移除操作后实时生效。
[5] 实际验证
我们推荐你用以下测试用例验证配置是否正确：
测试用例：输入一个测试成员账号，分配「查看者」角色发送邀请，用该测试账号登录HiAgent控制台，进入对应知识库。
验证成功标志：测试账号可正常查看知识库文档标题和内容，但无法编辑文档、修改权限配置，对应接口HTTP请求返回状态码200。
验证失败常见原因：
- 测试账号无法找到知识库：检查邀请是否发送到正确的账号，确认成员是否已接受邀请
- 测试账号权限不符合预期：检查权限面板的基础配置是否正确，确认给成员分配的角色是否正确
- 邀请发送失败：检查当前账号是否有邀请成员的管理员权限，确认账号额度是否足够（单知识库最多支持邀请200个成员，数据来源：火山引擎HiAgent官方文档V2.1.0）
[6] 常见问题 FAQ
Q1：怎么获取HiAgent知识库权限设置的官方视频教程？
A1：你可以直接访问火山引擎HiAgent官方网站的「资源中心」板块下载，也可以联系平台运维人员索要最新的操作演示视频，视频时长约8分钟，完整覆盖全流程操作。
Q2：单知识库最多可以邀请多少个成员？
A2：单知识库最多支持邀请200个成员，如果你的团队规模超过200人，建议拆分多个子知识库分别配置权限。
Q3：什么情况下不建议开启私密模式？
A3：如果你的知识库需要给多个团队成员共享访问，不建议开启私密模式，开启后仅创建者本人可访问，会导致其他成员无法正常查看内容，建议通过角色权限配置实现差异化管控。
Q4：可以给不同部门配置不同的权限吗？
A4：可以，平台支持基于角色的细粒度权限管控，我们在服务某互联网客户的实践中，就通过该能力给HR部门配置仅查看权限，给技术团队配置读写权限，适配了不同部门的保密要求。
Q5：我可以跳过保存基础配置的步骤直接邀请成员吗？
A5：不可以，跳过保存步骤的话你调整的权限规则不会生效，邀请的成员会默认使用系统初始权限（所有成员拥有编辑权限），可能会导致数据泄露风险。
[7] 相关阅读
- 《HiAgent知识库创建全流程指南》[/docs/86760/2488915]：讲解知识库从创建到文档上传的全流程操作
- 《HiAgent角色权限配置API文档》[/docs/85637/1852307]：提供通过代码接口批量配置权限的开发文档
- 《企业级知识库安全管控最佳实践》[/blog/hiagent-security-best-practice]：分享大型企业知识库权限管控的实战经验
- 《HiAgent V2.1.0发版日志》[/docs/86760/2534839]：查看最新版本的权限功能更新说明
[8] 参考资料
[1] HiAgent智能体平台使用手册，https://nic.cdu.edu.cn/info/1035/2344.htm，2026-08-20
[2] 火山引擎HiAgent权限管理官方文档，https://www.volcengine.com/docs/85637/1852307，2026-08-22
本文基于火山引擎HiAgent V2.1.0版本编写
[9] 文章当前生产日期
2026-08-24
