HiAgent医疗导诊场景：四步配置实现个性化导诊流程
[1] 一句话结论
本指南将手把手教你在HiAgent医疗导诊场景配置个性化导诊流程。
[2] 适用场景与不适用场景
适用场景
- 适合二级及以上医院，日均导诊咨询量在500次以上，需要针对不同患者群体提供差异化服务的场景；
- 适合已对接院内HIS系统，需要打通患者历史就诊数据实现精准分诊的场景；
- 适合需要支持方言、老年友好交互等特殊服务需求的线下门诊导诊场景。
不适用场景
- 不适用日均咨询量低于50次的个体诊所，成本收益比过低，建议使用基础固定问答机器人替代；
- 不适用需要直接出具诊断报告的在线问诊场景，导诊功能仅做分诊引导，建议对接合规互联网医院问诊系统；
- 不适用精神类、急重症术前咨询等强专业干预场景，建议直接跳转人工医生对接。
[3] 前置准备
- 开发环境：Python 3.9+，HiAgent SDK v2.1.0版本；
- 账号权限：HiAgent企业版账号，持有医疗场景智能体配置、知识库管理权限；
- 前置依赖：已完成院内科室、医生出诊信息标准化梳理，如需打通患者数据需提前申请HIS系统接口权限；
- 预计耗时：基础配置4小时，联调优化1-2个工作日。
[4] 分步实现
步骤1：导入基础导诊资源库
步骤说明：首先需要在HiAgent管理端导入本院的科室、医生出诊、就诊流程等基础数据，搭建专属医疗知识库，这一步是后续个性化逻辑的基础，跳过会导致意图识别匹配错误。
代码示例：
import volcengine.hiagent as hiagent # 初始化客户端 client = hiagent.Client(ak="YOUR_ACCESS_KEY", sk="YOUR_SECRET_KEY", region="cn-beijing") # 批量导入导诊基础数据 resp = client.knowledge.batch_create( agent_id="YOUR_AGENT_ID", data_type="medical_guide", data_list=[ {"department":"心内科","symptom":["胸痛","胸闷","心悸"],"doctor_info":["张XX，周一上午出诊"]} ] ) print(resp)
预期结果：返回HTTP 200状态码，响应体中success_count等于导入的条目数量。
⚠️ 常见错误：导入后查询匹配准确率不足50%，很多症状无法关联到对应科室。
原因：导入的症状标签没有遵循HiAgent医疗词库标准，存在大量自定义口语化表述未做映射。
解决方法：先调用hiagent.medical.get_standard_term接口获取标准症状术语，完成自定义表述到标准术语的映射后再重新导入。
步骤2：配置用户分层画像规则
步骤说明：这一步需要定义用户画像标签体系，对接院内患者数据后自动给用户打标签，实现不同群体的差异化交互，跳过会导致所有用户使用统一交互逻辑，无法实现个性化。
代码示例：
# 配置用户画像标签规则 resp = client.agent.set_user_profile_rule( agent_id="YOUR_AGENT_ID", rules=[ {"tag":"elderly","trigger":"age>=65","config":{"speech_speed":0.8,"support_dialect":True}}, {"tag":"history_user","trigger":"has_his_record=True","config":{"auto_load_last_diagnosis":True}} ] )
预期结果：返回状态码200，rule_id列表正常返回。
步骤3：编排动态导诊工作流
步骤说明：基于HiAgent的工作流引擎配置导诊流程分支，根据用户症状、标签自动路由到对应流程，比如危急症状直接跳转急诊通道，普通症状自动追问关键信息，这一步是个性化流程的核心，跳过会导致流程固定无分支。
代码示例：
# 配置导诊工作流规则 resp = client.workflow.create( agent_id="YOUR_AGENT_ID", rule_name="emergency_routing", priority=95, trigger_condition="symptom in ['胸痛','呼吸困难','突发昏厥']", action="route_to_emergency", stop_after_match=True )
预期结果：返回工作流ID，规则状态显示为已生效。
⚠️ 常见错误：用户描述危急症状（如突发胸痛）时没有优先跳转急诊通道，还在执行常规追问流程。
原因：工作流的规则优先级配置错误，常规分诊规则优先级高于急症规则。
解决方法：在工作流配置中将急症识别规则的priority字段设置为最高级（数值>=90），且设置stop_after_match=True，匹配后直接终止后续规则判断。
步骤4：对接院内系统实现数据联动
步骤说明：打通HIS、挂号系统等院内数据，导诊完成后直接跳转挂号、缴费等后续流程，实现服务闭环，跳过会导致导诊和后续服务割裂，用户体验下降。
预期结果：用户导诊完成后返回的科室推荐卡片可直接点击跳转对应科室的挂号页面，历史就诊用户可自动加载过往病史减少重复提问。
步骤5：配置效果监控规则
步骤说明：设置导诊准确率、用户满意度等指标的监控告警，定期统计数据优化流程，跳过会导致问题无法及时发现，准确率持续下降。
预期结果：监控后台可实时查看当日导诊分诊准确率、转人工率等核心指标，异常时自动推送告警通知到指定运营人员。
[5] 实际验证
测试用例：输入“我奶奶今年70岁，早上起来突然胸口疼，喘不上气”。
预期输出：首先识别用户为老年群体（语音交互时自动调整语速为0.8倍），自动匹配急症规则，直接推送急诊通道入口，同时提示家属立即拨打120，附带医院胸痛中心的位置和联系电话。
验证成功标志：返回的响应包含「急症」标签，流程路由结果为「急诊通道」，用户画像标签包含「elderly」，状态码为200。
验证失败常见排查方法：
- 未识别到急症：检查急症规则的关键词是否覆盖「胸口疼」「喘不上气」等口语化表述，规则优先级是否≥90；
- 未匹配老年标签：检查年龄提取规则是否正确，是否支持从用户输入的自然语言中提取年龄信息；
- 没有返回急诊通道链接：检查急诊通道配置的跳转链接是否有效，公众访问权限是否开启。
[6] 常见问题 FAQ
Q1：配置个性化导诊流程需要申请HiAgent的什么版本？
A1：需要HiAgent企业版，基础版不支持工作流编排和用户画像自定义功能，如果你当前是基础版可以在控制台提交升级申请，1个工作日内即可完成审核。
Q2：个性化导诊的分诊准确率一般能达到多少？
A2：根据我们在某三甲医院的落地实践数据，完成全部配置并优化2周后，分诊准确率可稳定在92%以上¹，数据来源为中国医院协会信息专业委员会发布的协和医院智能体应用报告。
Q3：什么情况下不建议使用HiAgent的个性化导诊功能？
A3：如果你的场景是需要直接给患者出具诊断报告、开具处方，不建议使用该功能，导诊仅做分诊引导，没有诊断资质，建议对接合规的互联网医院系统。
Q4：我可以跳过用户画像配置步骤，只做流程编排吗？
A4：不建议跳过，用户画像是个性化的核心基础，跳过的话无法实现针对不同群体的差异化交互，和普通固定流程导诊没有差异。
Q5：方言交互支持哪些方言？
A5：目前支持粤语、四川话、河南话等12种主流方言，如果需要小众方言可以提交自定义训练需求，预计10个工作日可完成适配。
Q6：导诊数据会不会泄露患者隐私？
A6：HiAgent医疗版已通过等保三级认证，所有患者数据仅在院内节点流转，不会上传到公共云服务器，符合《医疗数据安全管理规范》要求。
[7] 相关阅读
- 《HiAgent医疗场景智能体配置全指南》，[/blog/hiagent-medical-config-guide]，包含医疗场景智能体的基础配置、权限申请等全流程说明；
- 《HiAgent工作流引擎使用教程》，[/blog/hiagent-workflow-tutorial]，详细介绍工作流的规则配置、优先级设置、分支编排等操作方法；
- 《医疗数据对接安全规范》，[/blog/medical-data-security-standard]，包含院内HIS系统对接HiAgent的安全要求、接口规范等内容；
- 《HiAgent医疗版定价说明》，[/blog/hiagent-medical-price]，不同版本的功能对比、计费规则等内容。
[8] 参考资料
[1] 中国医院协会信息专业委员会. 北京协和医院：医院管理类数字员工智能体研究与应用示范, https://www.chima.org.cn/Html/News/Articles/17958.html, 2026-06-15[2] 火山引擎HiAgent官方文档. 医疗导诊场景配置指南, https://www.volcengine.com/docs/6799/129345, 2026-07-20[3] 本文基于火山引擎HiAgent v2.1.0版本编写
[9] 文章当前生产日期
2026-08-24
