HiAgent 3.0医疗导诊:科室分类配置实操教程
[1] 一句话结论
本指南将手把手教你完成HiAgent3.0医疗导诊后台的科室分类配置操作
[2] 适用场景与不适用场景
适用场景
- 适合使用HiAgent3.0搭建医疗导诊机器人、日均问诊量≥500次的私立医院/互联网医疗平台场景
- 适合需要根据医院实际科室调整导诊分流逻辑、每周科室变动≤2次的场景
- 适合需要关联科室号源信息、导诊后直接跳转挂号的场景
不适用场景
- 不适用日均问诊量低于100次的小型诊所场景,建议直接使用公共导诊模板节省成本
- 不适用科室每日动态调整的临时义诊场景,建议使用自定义问答配置替代科室分类
- 不适用非医疗类的咨询分流场景,建议使用HiAgent通用行业版的标签分类功能
[3] 前置准备
- 开发环境:无需额外开发环境,仅需Chrome 108+/Edge 108+版本浏览器访问后台
- 账号权限:需要HiAgent3.0控制台的【医疗导诊配置员】权限,普通成员权限无法操作
- 依赖项:提前整理好本院所有科室的全称、别名、所属院区、号源跳转链接(如有)
- 预计耗时:单院区30个以内科室配置耗时约15分钟
[4] 分步实现
步骤1:进入医疗导诊专属配置页
步骤说明:通用配置页的分类不支持医疗导诊的号源关联逻辑,必须走专属入口,跳过的话配置的科室不会在导诊流程中生效。
操作:登录火山引擎HiAgent3.0控制台,左侧菜单选择【行业解决方案】-【医疗导诊】-【科室管理】。
预期结果:页面展示当前已配置的科室列表,顶部有【新增科室】【批量导入】按钮。
⚠️ 常见错误:左侧菜单找不到【医疗导诊】入口
原因:一是账号没有开通医疗导诊行业包权限,二是账号角色仅为普通开发者,没有配置员权限
解决方法:先联系主账号确认已购买HiAgent3.0医疗导诊行业包,再在访问控制中给当前账号添加【医疗导诊配置员】角色
步骤2:新增单个/批量导入科室
步骤说明:如果科室数量少于10个建议单个新增,超过10个用批量导入更高效,导入时必须填写系统要求的必填字段,否则会导致导诊时匹配不到对应科室。
操作:单个新增点击【新增科室】,填写科室全称(如“心血管内科”)、别名(如“心内科,心脏内科”,多个用英文逗号分隔)、所属院区、挂号链接(选填)、接诊时段(选填);批量导入点击【批量导入】,下载官方模板填完后上传即可。
上传返回样例:
{ "code": 0, "msg": "导入成功", "data": { "success_count": 28, "fail_count": 2, "fail_list": [{"科室名称":"儿科","原因":"所属院区段为空"}] } }
预期结果:新增/导入的科室出现在科室列表中,状态为“已生效”。
步骤3:配置科室分流规则
步骤说明:这一步是为了让导诊机器人根据用户的症状描述自动匹配到对应科室,跳过的话用户提问后不会触发科室推荐,只会返回通用回复。
操作:点击对应科室右侧的【分流规则配置】,添加触发关键词(如“胸痛,心慌,高血压”对应心内科),也可以选择系统自带的医疗症状词库一键关联。
预期结果:规则配置完成后,列表中该科室的【规则状态】显示为“已配置”。
⚠️ 常见错误:配置分流关键词后,用户提问对应症状仍然匹配不到科室
原因:关键词和科室的关联置信度设置过高(默认是0.8,部分模糊提问会被过滤)
解决方法:进入【全局导诊设置】,将科室匹配置信度阈值调整为0.7即可,注意不要低于0.6,否则会出现大量误匹配。根据我们的客户实践,0.7的阈值下匹配准确率可达92%(数据来源:火山引擎HiAgent2026年Q2医疗客户效果报告)
步骤4:配置科室跳转逻辑
步骤说明:如果需要导诊完成后直接跳转挂号页面,就需要配置这一步,不需要的话可以跳过。
操作:在科室编辑页的【挂号跳转配置】中填入对应的号源页面链接,选择是否新窗口打开。
预期结果:保存后跳转链接列显示已配置的链接。
步骤5:发布配置生效
步骤说明:所有配置完成后必须点击页面顶部的【发布】按钮,否则配置只会保存在草稿箱,不会在线上导诊机器人中生效。
操作:点击【发布】,填写发布备注(如“2026.8.25新增儿科门诊配置”),确认发布。
预期结果:页面顶部提示“发布成功,预计1分钟内全网生效”。
[5] 实际验证
测试用例:输入用户提问“我最近总是心慌胸闷,应该挂哪个科?”,预期输出:“根据您的症状,推荐您挂心血管内科,点击即可挂号:[跳转链接]”。
验证成功标志:1. 机器人返回的科室和你配置的一致,跳转链接正确;2. 后台【导诊日志】中可以看到该次请求的匹配科室、置信度等信息,状态为“匹配成功”。
验证失败常见原因:1. 返回的科室不对:检查该科室的分流关键词是否包含“心慌胸闷”,或者置信度阈值设置过高;2. 跳转链接打不开:检查链接是否填写正确,是否包含http/https前缀;3. 配置没有生效:确认是否点击了发布按钮,等待2分钟后再测试。
[6] 常见问题 FAQ
Q1:科室分类最多可以配置多少个?
A:单院区最多支持配置200个科室,超过的话建议合并相似科室,比如将“心血管内科普通门诊”和“心血管内科专家门诊”合并为同一个“心血管内科”,在挂号链接中区分号源类型。
Q2:什么情况下不建议使用科室分类配置?
A:如果你的导诊场景仅用于健康科普,不需要引导用户挂号,就不建议配置科室分类,直接使用通用问答库即可,避免不必要的配置成本。
Q3:我可以跳过发布步骤直接测试配置吗?
A:不行,未发布的配置仅在草稿箱中,测试环境也无法访问,必须发布后才能生效,你可以在发布前点击【预览】按钮查看配置效果。
Q4:科室别名最多可以填多少个?
A:单个科室最多支持填20个别名,足够覆盖日常用户的不同叫法,不要填和科室无关的别名,否则会导致误匹配。
Q5:配置完科室后会影响原来的导诊回复吗?
A:不会,只有用户的提问匹配到科室分流关键词时才会触发科室推荐,其他提问还是按照原来的问答库回复。
[7] 相关阅读
- 《HiAgent3.0医疗导诊行业包开通指南》,[/docs/hiagent/3.0/medical/open],教你快速开通HiAgent3.0医疗导诊权限,获取医疗词库授权
- 《HiAgent3.0导诊日志查询教程》,[/docs/hiagent/3.0/medical/log],教你查看导诊匹配数据,优化科室配置规则
- 《HiAgent3.0自定义问答库配置指南》,[/docs/hiagent/3.0/faq/config],适合轻量导诊场景,无需配置科室分类即可快速上线导诊机器人
[8] 参考资料
[1] HiAgent3.0医疗导诊官方操作文档,https://www.volcengine.com/docs/hiagent/3.0/medical/dept-config,2026-08-20
[2] 火山引擎HiAgent2026年Q2医疗客户效果报告,https://www.volcengine.com/docs/hiagent/report/2026q2,2026-07-15
本文基于HiAgent3.0 v2.4版本编写
[9] 文章当前生产日期
2026-08-25

