本文介绍医学智能问答RunMedQA的语法及示例。

功能描述

医学智能问答能力面向皮肤病预问诊场景,通过多轮对话和图像收集的方式,完成皮肤病相关的预问诊信息收集,并输出结构化的预问诊报告,预测潜在皮肤病。采集的问诊信息主要包括以下内容:

  • 基本信息,如主诉、年龄、部位等。
  • 病情,如症状、并发症、病程等。
  • 病史相关,如疾病史、用药史、过敏史等。
  • 非结构化信息,如皮损图片等。

应用场景

面向皮肤病预问诊场景,采用多轮对话的方式,完成问诊信息采集。

特色优势

  • 会话流程简洁、智能,便于集成到用户应用中。
  • 问诊信息抽取能力准确高效,结合多模态皮肤病预测技术,自动化生成病例报告和潜在疾病诊断,可有效降低问诊时间成本。

前提条件

请确保您已开通图像分析处理,若未开通服务请立即开通

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP。
  • 图像大小:不超过3M。
  • 图像分辨率:大于256×256像素,小于2048×2048像素。
  • URL地址中不能包含中文字符。
  • 问题内容字数不能超过500字。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RunMedQA

系统规定参数。取值:RunMedQA。

OrgId String 0001

数据来源机构代码。

OrgName String weiyi

数据来源机构名称。

SessionId String d1f6a6c2444f4c01adfadd413938e5c7

会话ID。首次发送主诉信息时无需填写SessionId,当QuestionTypechiefComplaint时算首次问诊。首次调用后返回结果中显示对应SessionId,后续问诊时SessionId为必填项。即当QuestionTypechiefComplaint时,此项为必填项。

说明 一次问诊对应一个SessionId,一次问诊会有多轮次对话,每个轮次都对应当前这个问诊的唯一SessionId。问诊有效期为24小时,24小时后SessionId失效。
Department String 皮肤科

代表医院科室。

说明 当前服务版本仅支持皮肤科
QuestionType String chiefComplaint

问题类型。取值如下:

  • chiefComplaint:主诉
  • age:年龄
  • bodyParts:部位
  • symptoms:症状
  • complications:并发症
  • diseaseCourse:病程
  • diseaseHistory:疾病史
  • medications:用药史
  • allegries:过敏史
  • images:皮损图片
  • reports:报告
AnswerImageURLList.N.AnswerImageURL String https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/imageprocess/roseola.jpeg

待检测皮肤病图像的URL地址。最多支持添加50条。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

说明QuestionTypeimages时必填。AnswerImageURLAnswerImageData建议二选一,当与Base64编码方式共存时,URL方式优先。
AnswerImageDataList.N.AnswerImageData String iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9Wb****

待检测皮肤病图像的Base64编码字符串。最多支持添加50条。

说明QuestionTypeimages时必填。AnswerImageURLAnswerImageData建议二选一,当与URL方式共存时,URL方式优先。
AnswerTextList.N.AnswerText String 起了好多红疙瘩流脓,痒死了,晚上痒的最厉害,怎么办啊?

患者的主诉或回答列表。最多支持添加50条。

返回数据

名称 类型 示例值 描述
RequestId String BFF7EEC3-F6B5-4387-AC1D-BB095A1A02E4

请求ID。

Data Object

返回的结果数据内容。

SessionId String d1f6a6c2444f4c01adfadd413938e5c7

会话ID。

QuestionType String age

问题类型。

Question String 你好,还需要你补充些其他信息,年龄多大了?

补充追问问题。当QuestionTypeimages时,无返回值。

AnswerType String text

选项类型。默认为text。

  • text:文本
  • single:单选
  • multiple:多选
Options Array of String "发烧","呼吸困难","关节疼痛","腹泻","头痛","无"

问题选项。

Reports Map

预问诊信息结构化报表。当QuestionTypeimages时(即问诊流程最后一步),才有返回值。

String "症状": [ "有渗出或流脓", "疙瘩", "瘙痒" ], "并发症": [ "无" ], "过敏史": [ "无过敏史" ]

预问诊信息结构化报表。

示例

请求示例

http(s)://[Endpoint]/?Action=RunMedQA
&OrgId=0001
&OrgName=weiyi
&SessionId=d1f6a6c2444f4c01adfadd413938e5c7
&Department=皮肤科
&QuestionType=chiefComplaint
&AnswerImageURLList=[{"AnswerImageURL":"https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/imageprocess/roseola.jpeg"}]
&AnswerImageDataList=[{"AnswerImageData":"iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9Wb****"}]
&AnswerTextList=[{"AnswerText":"起了好多红疙瘩流脓,痒死了,晚上痒的最厉害,怎么办啊?"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>9ECA40E3-A1A7-4C38-B115-0E477989CC86</RequestId>
<Data>
    <Reports>
        <症状>有渗出或流脓</症状>
        <症状>疙瘩</症状>
        <症状>瘙痒</症状>
        <并发症>无</并发症>
        <过敏史>无过敏史</过敏史>
        <图片>http://hivis.oss-cn-shanghai-internal.aliyuncs.com/dr-derma-test/0001/33df9b8d35d3409d9e07eb6a4a33e12a/21a521bfca5d4216a5fa765d00395345.jpeg?OSSAccessKeyId=LTAI4Fd26bcpppU4PFkC****&amp;Expires=1654552425&amp;Signature=CjAKAWBVuCy%2FNkg9d8HocTkz09****</图片>
        <疾病史>无疾病史</疾病史>
        <用药史>无用药史</用药史>
        <部位>胸部</部位>
        <诊断结果>
            <急性荨麻疹>0.1037</急性荨麻疹>
            <图像未能识别>0.6709</图像未能识别>
            <玫瑰糠疹>0.0509</玫瑰糠疹>
        </诊断结果>
        <病程>2个月</病程>
        <皮损形态分布>红</皮损形态分布>
        <年龄>30岁</年龄>
    </Reports>
    <QuestionType>reports</QuestionType>
    <AnswerType/>
    <Question/>
    <SessionId>0516e4de433741fc942948b8a71eada7</SessionId>
</Data>
<Code/>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "9ECA40E3-A1A7-4C38-B115-0E477989CC86",
  "Data" : {
    "Reports" : {
      "症状" : [ "有渗出或流脓", "疙瘩", "瘙痒" ],
      "并发症" : "无",
      "过敏史" : "无过敏史",
      "图片" : "http://hivis.oss-cn-shanghai-internal.aliyuncs.com/dr-derma-test/0001/33df9b8d35d3409d9e07eb6a4a33e12a/21a521bfca5d4216a5fa765d00395345.jpeg?OSSAccessKeyId=LTAI4Fd26bcpppU4PFkC****&amp;Expires=1654552425&amp;Signature=CjAKAWBVuCy%2FNkg9d8HocTkz09****",
      "疾病史" : "无疾病史",
      "用药史" : "无用药史",
      "部位" : "胸部",
      "诊断结果" : {
        "急性荨麻疹" : 0.1037,
        "图像未能识别" : 0.6709,
        "玫瑰糠疹" : 0.0509
      },
      "病程" : "2个月",
      "皮损形态分布" : "红",
      "年龄" : "30岁"
    },
    "QuestionType" : "reports",
    "AnswerType" : "",
    "Question" : "",
    "SessionId" : "0516e4de433741fc942948b8a71eada7"
  },
  "Code" : ""
}

错误码

关于医学智能问答的错误码。详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。