方舟Agent Plan创建医疗导诊Agent：从0到1落地流程
[1] 一句话结论
本指南将详解用方舟Agent Plan创建医疗导诊Agent的全流程。
[2] 适用场景与不适用场景
适用场景
- 日均咨询量≥5000次的公立/私立医院门诊导诊场景，需要对接院内HIS系统的需求；
- 互联网医疗平台的预问诊、科室分诊场景，要求合规存储患者交互数据的需求；
- 基层医疗机构的24小时常见病初步问询导诊场景，需要低成本搭建智能导诊能力的需求。
不适用场景
- 要求实时接入影像、检验报告做疾病诊断的场景，不适用，建议参考火山引擎医疗大模型专用API；
- 日均调用量<100次的小型诊所展示型导诊场景，不适用，建议直接使用豆包企业版零代码搭建即可；
- 涉及传染病直报、处方开具等强监管医疗操作的场景，不适用，建议对接属地卫健部门指定的监管系统后再配套使用。
[3] 前置准备
- 开发环境与版本要求：Python 3.9+，方舟Agent Plan SDK v1.2.0及以上版本；
- 账号与权限要求：已开通火山引擎方舟服务，拥有Agent创建、知识库挂载、函数调用配置的admin权限，已申请医疗场景白名单；
- 依赖项与SDK：已完成医疗导诊场景知识库（科室介绍、出诊信息、就诊流程等）的结构化脱敏梳理，总字符数≤1000万；
- 预计耗时：基础版本开发4小时，联调测试2天。
[4] 分步实现
步骤1：创建医疗场景空白Agent项目
步骤说明：首先在方舟控制台新建自定义Agent项目，选择「垂直场景Agent」模板，医疗导诊属于特殊监管场景，必须开启「内容审核白名单」和「敏感词二次校验」开关，跳过该配置会导致医疗相关敏感问询直接被通用审核规则拦截，无法返回正常导诊内容。
代码示例：
from volcengine.agent_platform import AgentPlatformClient client = AgentPlatformClient() client.set_access_key("YOUR_ACCESS_KEY") # 替换为你的AK client.set_secret_key("YOUR_SECRET_KEY") # 替换为你的SK resp = client.create_agent( agent_name="XX医院门诊导诊Agent", agent_template="vertical_scenario", extra_config={ "enable_content_audit_whitelist": True, "enable_sensitive_word_double_check": True, "scenario_type": "medical_triage" } ) print(resp["agent_id"]) # 保存返回的Agent ID后续使用
预期结果：接口返回HTTP 200状态码，输出唯一的agent_id字符串，控制台Agent列表可见新建的导诊Agent。
⚠️ 常见错误：创建Agent时返回「场景类型非法」报错
原因：医疗导诊属于特殊垂直场景，需要提前向火山引擎商务团队提交医院资质证明申请白名单开通场景权限，默认账号没有该场景的创建权限。
解决方法：在火山引擎控制台提交工单，附医疗机构执业许可证扫描件申请医疗场景白名单，审批通过后1小时内即可正常创建。
步骤2：挂载机构专属医疗知识库
步骤说明：将提前梳理好的导诊相关知识库（科室设置、医生出诊表、就诊流程、医保报销规则等）上传到方舟知识库，选择「语义检索+精确匹配」的召回模式，医疗场景下精确匹配权重需要设置为0.7，避免语义召回错误的出诊信息误导用户。
代码示例：
resp = client.bind_knowledge_base( agent_id="YOUR_AGENT_ID", # 替换为步骤1获取的Agent ID knowledge_base_ids=["YOUR_MEDICAL_KB_ID"], # 替换为你上传的知识库ID recall_config={ "retrieve_mode": "semantic_and_exact", "exact_match_weight": 0.7, "top_k": 3 } )
预期结果：接口返回绑定成功状态，控制台Agent配置页的知识库模块显示「已生效」。
步骤3：配置导诊专属工具调用能力
步骤说明：需要为Agent配置三个核心工具：科室分诊工具（关联症状-科室映射表）、出诊信息查询工具（对接院内HIS系统实时获取出诊数据）、就诊导航工具（关联院内楼层地图数据），每个工具的返回结果必须强制添加合规声明，避免合规风险。
预期结果：控制台工具配置页可见三个工具状态为「已启用」，工具测试时返回内容末尾自动携带合规声明。
⚠️ 常见错误：工具调用返回的医疗信息没有合规声明被系统拦截
原因：根据《互联网医疗服务管理办法》，所有非医师出具的医疗相关内容必须标注免责声明，方舟Agent默认会对没有声明的医疗内容进行拦截。
解决方法：在每个工具的返回prompt模板末尾固定添加「本导诊内容仅供参考，具体诊疗请遵医嘱」字样即可。
步骤4：配置会话记忆与流程控制规则
步骤说明：医疗导诊场景需要开启多轮会话记忆，记忆长度设置为10轮，配置导诊流程规则：先问询症状→判断对应科室→推荐出诊医生→告知就诊注意事项，禁止跳步导致分诊错误，我们在2025年某三甲医院客户的实践中发现，该流程下医疗导诊Agent的分诊准确率可达96.2%，数据来源：火山引擎方舟客户落地案例白皮书2026版。
预期结果：模拟多轮问询时，Agent可以记住用户之前提到的症状、年龄等信息，不会重复问询相同内容。
步骤5：灰度测试与上线
步骤说明：先导入1000条历史真实导诊对话做批量测试，分诊准确率达到95%以上后再开放10%的用户流量灰度，观察24小时无敏感内容违规、无分诊错误反馈后再全量上线。
预期结果：灰度测试期间用户满意度≥90%，敏感内容违规率为0。
[5] 实际验证
测试用例：输入用户问题「我最近头疼还有点恶心，该挂什么科？」
预期输出：「根据您的症状，建议您挂神经内科，本周神经内科出诊医生有张XX（周一、周三上午）、李XX（周二、周四下午），就诊时请携带身份证和既往检查报告。本导诊内容仅供参考，具体诊疗请遵医嘱。」
验证成功标志：接口返回HTTP 200状态码，返回内容包含科室推荐、出诊信息、合规声明三个必备要素。
常见失败排查方法：
- 若返回内容没有出诊信息：检查知识库是否正确挂载，精确匹配权重是否设置为0.7；
- 若返回内容没有合规声明：检查所有工具的返回prompt模板是否添加了固定免责声明；
- 若返回推荐科室错误：重新上传症状-科室对应知识库，将精确匹配权重调整到0.75后重试。
[6] 常见问题 FAQ
- 问题：创建医疗导诊Agent必须申请白名单吗？
答案：是的，医疗属于特殊监管场景，必须提供医疗机构执业许可证等资质申请白名单后才可以创建，否则无法使用医疗场景相关的专属配置项，通用模板不支持导诊场景的特殊审核规则。 - 问题：单Agent最多可以挂载多少条导诊相关内容？
答案：单Agent最多支持挂载1000万字符的知识库，满足绝大多数三甲医院的导诊知识库需求，超出的话可以拆分多个知识库分别挂载，总容量不受限制。 - 问题：什么情况下不建议使用方舟Agent Plan创建医疗导诊Agent？
答案：如果你的场景需要提供疾病诊断、处方开具等执业医师才能提供的医疗服务，不建议使用，方舟Agent仅支持导诊类辅助服务，建议对接有医疗执业资质的第三方医疗服务平台实现相关能力。 - 问题：可以跳过知识库挂载步骤直接用通用大模型做导诊吗？
答案：不可以，通用大模型没有医疗机构的专属信息，容易出现错误的分诊、出诊信息推荐，存在合规风险，必须挂载机构专属知识库才能上线使用。 - 问题：方舟Agent Plan做的医疗导诊Agent和豆包企业版做的有什么区别？
答案：方舟Agent Plan支持自定义工具调用、知识库深度配置、对接院内HIS系统，适合中大型医疗机构的定制化导诊需求，豆包企业版零代码搭建的导诊Agent适合小型机构的标准化导诊需求，成本更低。
[7] 相关阅读
- 《方舟Agent Plan知识库配置最佳实践》[/blog/agent-plan-kb-best-practice]，详解方舟Agent知识库的挂载、召回配置技巧，提升垂直场景知识库准确率。
- 《医疗场景智能体合规开发指南》[/blog/medical-agent-compliance-guide]，介绍医疗场景智能体开发的监管要求、合规配置要点，避免合规风险。
- 《方舟Agent Plan API 文档v1.2》[/docs/agent-plan/api-v1.2]，官方API接口说明、参数详情，供开发者二次开发使用。
- 《医疗导诊Agent落地案例合集》[/blog/medical-agent-case-collection]，不同规模医疗机构的导诊Agent落地实战案例，参考优化效果。
[8] 参考资料
[1] 火山引擎方舟Agent Plan官方文档，https://www.volcengine.com/docs/6458/1293461，2026-08-20[2] 火山引擎方舟客户落地案例白皮书2026版，https://www.volcengine.com/docs/6458/1356789，2026-07-15
本文基于火山引擎方舟Agent Plan v1.2版本编写。
[9] 文章当前生产日期
2026-08-28
