方舟Agent Plan医疗辅助咨询：可提供合规慢病用药指导
[1] 一句话结论
本指南讲解方舟Agent Plan慢病用药指导能力的接入与合规使用方法。
[2] 适用场景与不适用场景
适用场景
- 面向C端慢病患者的7×24小时用药咨询、用药依从性提醒场景，日均咨询量≥1000次的医疗机构可优先使用；
- 互联网医疗平台的预诊分诊环节，辅助执业医生筛选低风险用药咨询需求，降低人工重复工作量。
不适用场景
- 急重症、未确诊疾病的用药指导需求，建议直接引导用户前往线下医疗机构就诊；
- 处方药的开方、剂量调整场景，建议对接执业医师人工审核流程，不得仅由AI出具最终用药方案。
[3] 前置准备
- 开发环境：Python 3.9+ / Node.js 18+；
- 账号权限：已开通火山引擎方舟Agent Plan服务，且完成医疗场景资质备案；
- 依赖项：方舟Agent Plan Python SDK v1.2.0 及以上版本；
- 预计耗时：2小时完成基础接入+合规配置。
[4] 分步实现
步骤1：申请医疗场景专属权限
步骤说明：方舟Agent Plan普通版本不开放医疗相关能力，必须单独申请医疗场景白名单并提交医疗机构执业许可证等资质，避免后续调用时被接口拦截。
代码/命令：
import volcenginesdkark # 初始化SDK客户端 client = volcenginesdkark.Client( access_key="YOUR_ACCESS_KEY", # 替换为你的火山引擎AK secret_key="YOUR_SECRET_KEY", # 替换为你的火山引擎SK region="cn-beijing" ) # 提交医疗场景权限申请 resp = client.apply_medical_scene_permission( scene_type="chronic_disease_medication_guidance", qualification_url="YOUR_QUALIFICATION_FILE_URL" # 替换为资质文件的公网地址 )
预期结果：返回HTTP 200状态码，resp.data.status为"audit_pending"，1-3个工作日会收到审核结果通知。
⚠️ 常见错误：提交资质后调用接口返回403 PermissionDenied
原因：医疗场景权限审核未通过，或未在请求头中指定审核通过的scene_id参数
解决方法：登陆方舟控制台查看权限审核进度，审核通过后在所有调用接口中传入对应scene_id
步骤2：上传慢病专属知识库
步骤说明：需要将机构内部的慢病诊疗规范、常用药品说明书等合规资料上传到专属向量库，让AI生成的回答严格匹配机构规范，降低大模型幻觉概率。
代码/命令：
resp = client.upload_knowledge_file( scene_id="YOUR_SCENE_ID", # 替换为审核通过的场景ID file_type="pdf", file_url="YOUR_CHRONIC_DISEASE_GUIDELINE_URL", # 替换为诊疗规范文件地址 knowledge_tag=["hypertension", "diabetes", "medication_guidance"] )
预期结果：返回唯一file_id，方舟控制台知识库列表可看到该文件，解析状态为"success"。
步骤3：配置人机协同复核规则
步骤说明：根据《互联网诊疗监管细则》要求，AI生成的所有用药指导内容必须经过执业医生复核才能发送给用户，需要提前配置复核触发规则。
代码/命令：
resp = client.set_review_rule( scene_id="YOUR_SCENE_ID", # 配置需要触发人工复核的内容类型 review_trigger_condition=["medication_guidance", "diagnosis_suggestion"], reviewer_group_id="YOUR_DOCTOR_GROUP_ID" # 替换为你的医生团队ID )
预期结果：返回唯一rule_id，后续AI生成符合触发条件的内容时会自动进入复核队列。
⚠️ 常见错误：用户发送咨询后长时间收不到回复
原因：复核规则配置为所有内容必须人工复核，当医生团队忙时会出现排队延迟
解决方法：可以配置低风险咨询（如常规用药时间提醒、常见不良反应科普）的免复核白名单，白名单内容必须提前经过医疗团队审核确认。
步骤4：调用用药指导接口
步骤说明：完成前面配置后就可以正式调用接口，传入用户的病情、既往病史、当前用药等信息获取指导内容。
代码/命令：
resp = client.call_medical_agent( scene_id="YOUR_SCENE_ID", user_info={ "disease_type": "type_2_diabetes", "current_medication": ["metformin 500mg bid"], "consultation_content": "我最近血糖空腹7.2，要不要加药？" }, need_review=True )
预期结果：返回的resp.data.content为AI生成的用药指导，resp.data.review_status为"pending_review"，医生复核通过后会通过回调通知你。
[5] 实际验证
测试用例：输入用户信息：2型糖尿病病史3年，目前服用二甲双胍500mg每日两次，最近一周空腹血糖波动在7.0-7.5mmol/L，无其他并发症，咨询是否需要调整药量。
预期输出：AI生成内容为“根据你提供的血糖情况，目前血糖控制略高于目标值（空腹4.4-7.0mmol/L），不建议自行加量，可先调整饮食和运动，连续监测3天血糖如果仍不达标，可咨询你的主治医生调整用药方案”，且内容进入人工复核队列。
验证成功标志：接口返回HTTP 200，返回内容无明确诊疗/处方内容，明确提示需遵线下医嘱。
失败排查方法：1. 返回403：检查scene_id是否正确，医疗场景权限是否审核通过；2. 返回内容有违规表述：检查知识库是否上传合规，是否开启了医疗场景幻觉抑制开关；3. 内容没有进入复核队列：检查复核规则配置是否匹配内容类型。
[6] 常见问题 FAQ
Q1：方舟Agent Plan生成的用药指导可以直接发送给用户吗？
A1：不可以，所有用药指导内容必须经过执业医师人工复核后才能发送给用户，AI输出仅作为辅助参考，不能替代医生的专业诊断。
Q2：目前支持哪些慢病的用药指导？
A2：官方默认覆盖高血压、2型糖尿病、高血脂、慢阻肺等12种常见慢病的用药咨询、依从性提醒、不良反应科普等需求，更多病种可提交自定义知识库扩展。
Q3：什么情况下不建议使用这个能力？
A3：急重症、未确诊疾病、处方药调量/开方的场景都不建议使用，这类场景需要直接引导用户前往线下医疗机构就诊或对接人工医生服务。
Q4：接口响应延迟大概是多少？
A4：根据我们在某头部互联网医疗客户的实践，单轮咨询平均响应延迟为280ms，开启复核后整体返回时长取决于人工复核速度，数据来源：2025年方舟客户服务年报。
Q5：可以跳过知识库配置步骤直接调用接口吗？
A5：不可以，未配置专属知识库的医疗场景调用会被接口拦截，配置知识库是为了保障回答合规，降低AI幻觉风险。
[7] 相关阅读
- 《方舟Agent Plan医疗场景接入规范》[/docs/ark/agent/medical/access-spec]，讲解医疗场景接入的资质要求、合规规则
- 《方舟Agent Plan知识库配置教程》[/docs/ark/agent/knowledge/base-config]，讲解如何上传、管理专属知识库
- 《2025互联网AI医疗服务合规指南》[/blog/ai-medical-compliance-2025]，讲解国内AI医疗服务的相关监管要求
[8] 参考资料
[1] 方舟Agent Plan医疗辅助咨询官方文档，https://www.volcengine.com/docs/6458/1162418，2026年8月[2] 方舟健客发布“AI+慢病管理”解决方案，https://www.cs.com.cn/ssgs/gsxw/202511/t20251128_6525644.html，2026年8月
本文基于方舟Agent Plan v2.1版本编写
[9] 文章当前生产日期
2026-08-27
