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

功能描述

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

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

应用场景

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

特色优势

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

前提条件

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

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP。
  • 图像大小:不超过3 MB。
  • 图像分辨率:大于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 "diagResults": [ "多形红斑", "玫瑰糠疹", "急性荨麻疹" ], "diagProb": { "多形红斑": 0.992, "急性荨麻疹": 0.0019, "玫瑰糠疹": 0.0053 }

预问诊信息结构化报表。

Reports中对应的key-value值如下表所示。

key

value类型

是否有返回值

中文描述

symptoms

List<String>

症状

complications

List<String>

并发症

diseaseHistory

List<String>

疾病史

medications

List<String>

用药史

allegries

List<String>

过敏史

bodyParts

List<String>

部位

diseaseCourse

List<String>

病程

age

List<String>

年龄

formDistribution

List<String>

否(非模板必须,算法抽取出的)

形态分布

images

List<String>

图片

diagResults

List<String>

诊断结果

diagProb

Map

诊断概率

bbox

List<Obeject>

病灶区域

示例

请求示例

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

<RunMedQAResponse>
    <RequestId>5AC38357-6B32-508E-A8AE-3BB891A6D2E8</RequestId>
    <Data>
        <QuestionType>chiefComplaint</QuestionType>
        <Reports>
            <bbox>
                <score>0.8148</score>
                <y1>1</y1>
                <x1>20</x1>
                <y2>355</y2>
                <x2>534</x2>
            </bbox>
            <diagResults>多形红斑</diagResults>
            <diagResults>玫瑰糠疹</diagResults>
            <diagResults>急性荨麻疹</diagResults>
            <diagProb>
                <多形红斑>0.992</多形红斑>
                <急性荨麻疹>0.0019</急性荨麻疹>
                <玫瑰糠疹>0.0053</玫瑰糠疹>
            </diagProb>
        </Reports>
        <Question>请描述一下您的病情?</Question>
        <AnswerType>text</AnswerType>
        <SessionId>7fa1fcaa9a5845d5906f5648d6de284f</SessionId>
    </Data>
    <Code/>
</RunMedQAResponse>

JSON格式

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

{
  "RequestId" : "5AC38357-6B32-508E-A8AE-3BB891A6D2E8",
  "Data" : {
    "QuestionType" : "chiefComplaint",
    "Reports" : {
      "bbox" : {
        "score" : 0.8148,
        "y1" : 1,
        "x1" : 20,
        "y2" : 355,
        "x2" : 534
      },
      "diagResults" : [ "多形红斑", "玫瑰糠疹", "急性荨麻疹" ],
      "diagProb" : {
        "多形红斑" : 0.992,
        "急性荨麻疹" : 0.0019,
        "玫瑰糠疹" : 0.0053
      }
    },
    "Question" : "请描述一下您的病情?",
    "AnswerType" : "text",
    "SessionId" : "7fa1fcaa9a5845d5906f5648d6de284f"
  },
  "Code" : ""
}

错误码

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

SDK参考

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

安全声明

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