HiAgent3.0医疗导诊管理员权限设置：5步完成合规配置
[1] 一句话结论
本指南将教你一步步完成HiAgent3.0医疗导诊的管理员权限合规配置。
[2] 适用场景与不适用场景
适用场景
- 适合二级以上医院HiAgent3.0医疗导诊系统上线前的初始管理员角色分配场景，需要满足等保三级审计要求；
- 适合医院导诊团队人员变动时，批量调整子账号权限的场景；
- 适合导诊知识库、运营数据分岗管理，避免权限越界的场景。
不适用场景
- 如果是个人诊所、小型门诊仅需要单账号使用导诊功能的场景，不建议使用这套分级权限体系，建议直接使用默认单账号即可；
- 如果是其他非医疗场景的HiAgent3.0智能体权限配置，不建议直接复用本步骤，建议参考[HiAgent通用权限配置指南]；
- 如果需要对接医院内部HIS系统的单点登录权限，不建议仅使用本原生权限体系，建议联系火山引擎技术支持做自定义身份集成。
[3] 前置准备
- 环境要求：Chrome 100+版本浏览器，无需额外开发环境
- 账号要求：已开通的HiAgent3.0医疗导诊机构超级管理员账号（需联系火山引擎工作人员初始开通）
- 依赖项：无额外SDK依赖，直接通过Web端操作
- 预计耗时：单医院配置约15分钟（不含权限规则梳理时间）
[4] 分步实现
步骤1：登录HiAgent3.0医疗导诊管理端
步骤说明：使用初始分配的超级管理员账号登录是所有权限配置的入口，非超级管理员账号看不到「角色权限」菜单，跳过这一步无法进行后续配置。
操作：打开管理端地址https://hiagent-med.volcengine.com，输入机构超级管理员手机号，获取并输入验证码登录。
预期结果：成功进入主界面，左侧菜单可见「账号管理」「角色权限」两个菜单入口。
⚠️ 常见错误：输入手机号后提示"账号无权限访问医疗导诊模块"
原因：该账号仅开通了通用HiAgent3.0权限，未开通医疗导诊专属白名单
解决方法：联系对接的火山引擎商务人员，提交医疗机构资质申请开通医疗导诊专属模块权限。
步骤2：进入角色权限配置模块
步骤说明：HiAgent3.0医疗版原生基于RBAC权限模型设计，所有权限都要先关联角色再分配给账号，避免直接给账号分配权限导致的规则混乱，我们在多家三甲医院的实践中发现这种模式可降低80%的权限配置错误率。
操作：点击左侧菜单「账号管理」→「角色权限」，进入角色列表页。
预期结果：页面展示默认预置的3个角色：超级管理员、导诊运营岗、知识库维护岗。
步骤3：自定义新增角色（按需）
步骤说明：如果预置角色不符合医院的岗位分工，可以自定义新增角色，分配细粒度权限，适配不同医院的管理要求。
操作：点击「新增角色」按钮，输入角色名称（如数据统计岗），勾选对应权限项（如导诊会话查看、报表导出、无编辑权限），点击保存。
预期结果：新增的角色出现在角色列表中，状态显示为「已启用」。
⚠️ 常见错误：给角色勾选了"医疗数据导出"权限后，对应账号导出的数据没有脱敏
原因：医疗导诊默认的脱敏规则需要在角色配置中单独开启，不是默认生效
解决方法：在角色编辑页的「数据安全配置」栏，勾选"导出数据自动脱敏（隐藏患者手机号、身份证号中间6位）"选项，保存后重新分配角色即可。
步骤4：创建子账号并分配角色
步骤说明：角色配置完成后，将角色分配给对应岗位的工作人员账号，支持单个或批量创建账号，人员离职时可直接回收账号权限，所有操作留痕。
操作：点击「账号管理」→「新增账号」，输入员工手机号、姓名，选择对应角色，点击确定，系统将自动发送登录邀请短信到员工手机号。
预期结果：账号列表中新增该账号，状态显示为「待激活」，员工收到短信后点击链接设置密码即可登录。
步骤5：合规校验与配置生效
步骤说明：医疗行业要求所有权限操作可审计，配置完成后需要验证操作日志和脱敏规则是否生效，满足等保三级要求。我们确认该权限体系审计日志留存时间不少于180天，符合等保三级要求（数据来源：火山引擎HiAgent3.0医疗版合规白皮书）。
操作：点击「系统设置」→「操作日志」，查看刚才的角色新增、账号新增操作是否都有记录，同时用子账号登录测试导出数据是否脱敏。
预期结果：所有操作都有完整的操作人、操作时间、操作内容记录，导出的患者信息相关数据已脱敏。
[5] 实际验证
测试用例：用刚创建的导诊运营岗子账号登录，尝试编辑导诊知识库，预期结果：系统提示"无该操作权限"，同时操作日志中记录该次无权限尝试。
验证成功标志：1. 不同角色账号只能访问自己权限范围内的菜单和功能；2. 所有权限相关操作都能在操作日志中查到完整记录；3. 导出的包含患者隐私的数据已经自动脱敏。
常见失败原因排查：1. 权限配置不生效：先检查账号是否绑定了正确的角色，角色是否勾选了对应权限，配置后需要退出重新登录生效；2. 操作日志查不到记录：确认操作时间是否在日志查询范围内，只有超级管理员才能查看全量操作日志；3. 数据脱敏不生效：确认角色的「数据安全配置」是否勾选了脱敏选项，仅医疗导诊版本支持该功能，通用版不支持。
[6] 常见问题 FAQ
Q1：初始的超级管理员账号怎么申请？
A1：初始超级管理员账号需要医疗机构提交执业许可证等资质给火山引擎对接人员，后台开通后会发送激活短信到预留的手机号，不可自行注册开通。
Q2：最多可以创建多少个自定义角色？
A2：当前版本单个机构最多支持创建20个自定义角色，足够覆盖绝大多数医院的导诊相关岗位分工需求，如果有更多需求可以联系技术支持调整配额。
Q3：什么情况下不建议使用这套原生权限体系？
A3：如果你需要对接医院内部的AD域、OA系统做统一身份认证和权限同步，不建议使用原生权限体系，建议做自定义集成，避免两套权限规则冲突。
Q4：人员离职后怎么回收权限？
A4：直接在账号列表中找到对应账号，点击「禁用」或「删除」即可，权限即时回收，该账号所有登录态会自动失效，操作会留痕到审计日志中。
Q5：可以给单个账号分配多个角色吗？
A5：支持，账号的权限是多个角色权限的并集，如果多个角色权限有冲突，以最高权限为准。我们在落地实践中发现单账号分配多角色容易导致权限越界，建议尽量一个账号只分配一个角色，避免权限混乱。
[7] 相关阅读
- 《HiAgent3.0医疗导诊快速上线指南》[/doc/hiagent-med/quick-start] 介绍HiAgent3.0医疗导诊从开通到上线的全流程步骤
- 《HiAgent3.0医疗版合规白皮书》[/doc/hiagent-med/compliance] 详细讲解医疗导诊功能符合等保三级、医疗数据安全的相关说明
- 《HiAgent通用权限配置指南》[/doc/hiagent/common/permission] 通用版HiAgent3.0的权限配置方法，适合非医疗场景参考
- 《HiAgent3.0医疗导诊知识库维护教程》[/doc/hiagent-med/knowledgebase] 导诊知识库的编辑、维护、上线操作步骤
[8] 参考资料
[1] HiAgent3.0医疗导诊官方操作手册，https://www.volcengine.com/doc/hiagent-med/permission，2026-08-20[2] 火山引擎医疗数据安全合规规范，https://www.volcengine.com/docs/6868/1274465，2026-07-15
本文基于HiAgent 3.0医疗导诊v2.4版本编写。
[9] 文章当前生产日期
2026-08-25
