AI 临床助手简介

概述

腾讯 AI 临床助手依托医疗垂类大模型，深度融合海量医学文献与实时临床数据。通过自然语言处理与强化学习（RLHF）技术，精准解析非结构化病历，理解复杂临床逻辑。系统旨在为医生提供贯穿“诊前、诊中、诊后”的决策支持，实现医疗质量与效率的双重提升。

术语表

AI 临床助手 API 接口的常见术语请参见下表：

术语	描述
深度鉴别诊断	通过整合症状、化验、影像等多维文本数据，结合权威医学知识库进行逻辑推演。
精准治疗推荐	将指南转化为个体化方案，综合考量年龄、既往史、禁忌症，输出涵盖给药细节、监测项目及健康处方的完整建议。
穿透式安全校验	交叉评估药物相互作用、配伍禁忌及检查必要性，针对潜在隐患实时分级提醒。
质量监控	自动检测病历中的逻辑矛盾(如性别与检查不符、诊断与处方冲突)。

使用限制

对于 API 接口的参数限制，请参考各接口文档中的参数说明。

API 快速入门

API 支持就近地域接入，本产品就近地域接入域名为 aca.tencentcloudapi.com，也支持指定地域域名访问，例如广州地域的域名为 aca.ap-guangzhou.tencentcloudapi.com。
接口请求域名： aca.tencentcloudapi.com

登录/登出
流程描述：医生在 HIS 系统执行登录或登出操作时，同步调用临床助手后台接口。

登录机制：告知后台登录动作后，系统将返回一个 Token。

Token 用途：该 Token 用于后续所有接口调用的身份校验。

时效性：默认有效时长为 2 小时（支持根据实际需求调整时效）。
智能预测/用药接口
流程描述：当医生填写患者的主诉、现病史、基本信息及用药信息时触发。

核心功能：AI 引擎根据输入数据进行智能计算，实时预测临床可能及潜在风险。

返回结果：系统将返回相应的诊断、治疗方案、疾病风险等提醒，辅助临床决策。
同步接口
应用场景：用于医院内部基础数据的更新维护。

同步范围：药品信息、检验项目、检查项目
同步标准字典接口
应用场景：确保临床助手与 HIS 系统的标准术语一致。

同步内容：给药途径、给药频次、科室信息。诊断名称等标准字典。

接入须知

###接口验证方式

调用服务	验证方式	范围和说明
后台服务	签名验证	登录/登出接口，HTTP请求头header中带上相关参数
后台服务	token 验证	预测接口使用 token 验证，请求体 body 结构里header中带上 token，token 为登录接口返回
前端服务	token 验证	访问 iframe 页面中 URL 中Query 参数带登录返回的 token

接口签名验证说明

项目立项并向工作人员申请审批通过后，会提供partnerId、appId及appSecret等关键信息，用于发起签名校验。请申请时合作方提供邮箱用于接收账号信息和密钥，并且妥善保管，以防泄露。
appId 是独立医院 ID(hospitalId) 或区域平台 ID(platformId)，后续业务接口中会区分使用。
报文格式为 json，采用 post 请求方式（RESTful API），合作方可以参照接口示例进行测试。
请求报文示例：

header:
  Content-Type: application/json
  god-portal-signature: a3f0f977e7141bd57ceca62b0edb7605a1599735xxxccc
  god-portal-timestamp: 1498553651000
body:（具体参照各个接口的定义）
  {
    ......
  }

请求报文参数：

参数名	类型	必填	备注
god-portal-signature	string	是	签名，参见签名算法
god-portal-timestamp	string	是	当前生成的时间戳,毫秒数

签名算法：

变量	说明
appId	分配的appId(platformId)
appSecret	签名密钥
timestamp	当前生成的时间戳，毫秒数，同header中的god-portal-timestamp

计算公式： god-portal-signature = hmacSha256( { appId } + { timestamp }, appSecret )

注意：如果验签失败，请检查服务器时间是否有同步标准时间，或者算法公式hmacSha256中两个参数是否位置对换。

3. 接口调用说明

注意：腾讯AI临床助手，可以按需求灵活选择的接入方式。可仅接入智能辅诊预测，或仅接入智能合理用药预测，也可接入含药剂师审方的全临床诊疗流程。

接入模式	必选接口	可选接口

以下接口由AI临床助手后台提供，联调环节和部署环节使用的后台服务host和port由工作人员提供为准。
注意：

http://ip:port/ 需要替换成工作人员提供的地址。详见接口详情。 **

云端环境使用https

后台接口仅 HTTP POST JSON 格式请求，HTTP 请求头部 headers 中请指定 Content-Type 为 application/json

登录/登出接口

医生在 his 登录和登出时，需要调用 AI 临床助手后台，告知登录动作，同时AI临床助手后台会返回登录后的 token 用以后续接口相关校验操作，登录 token 默认有效期2小时，可更改有效期。

登录接口

验证方式

签名验证，

注意：

使用平台签名（platformId 作为 appId，使用平台签名 Key 作为 appSecret），也可以使用平台下机构签名（hospitalId 作为 appId，使用机构签名 Key 作为 appSecret）。

使用平台签名通过 API 操作数据时，可以操作平台下所有机构相关数据；而使用机构签名时只能操作当前机构数据。

请求URL

http://ip:port/cgi-bin/v2/RationalDrugServer/HisToolLogin

请求示例

// 独立医院登录请求

{
  "header": {
    "hospitalId": "1",
    "partnerId": "1",
    "requestId": "4535a480-fed6-11e8-a447-7b76372b5189"
  },
  "data": {
    "doctorId": "123",
    "doctorName": "医生",
    "doctorLevel":"副主任医师"
  }
}

// 平台版登录请求

{
  "header": {
    "platformId": "123",
    "partnerId": "1",
    "requestId": "4535a480-fed6-11e8-a447-7b76372b5189"
  },
  "data": {
    "doctorId": "123",
    "doctorName": "医生",
    "doctorLevel":"主治医师",
    "hospitalId": "1"
  }
}

参数说明：

节点	名称	类型	必填	说明
header	公共请求头信息	object	是
requestId	请求ID	string	是	属于 header,方便定位问题
partnerId	合作方ID	string	是	属于 header
hospitalId	医院ID	string	-	属于 header，独立医院登录必填
platformId	区域平台ID	string	-	属于 header，区域登录必填
data	业务请求数据	object	是
doctorId	医生编号	string	是	禁止传 0
doctorName	医生姓名	string	是
doctorLevel	医生职称	string	否	取值为：主治医师、副主任医师、主任医师
doctorDepartment	医生科室	string	否	当前登录科室
departmentId	科室ID	string	否	当前登录科室 ID
hospitalId	机构ID	string	否	属于header，区域平台登录时传入

响应示例

// 正常返回

{
  "code": 0,
  "message": "success",
  "requestId": "4535a480-fed6-11e8-a447-7b76372b5189",
  "data": {
    "token": "tai.MTAwMDY%3D.12474ab0-912d-11eb-87e2-4914549178ec",
    "expiresIn": 7200
  }
}

// 登录端时间异常时返回

{
  "code": 10500,
  "message": "Timestamp检验失败|***",
  "requestId": "4535a480-fed6-11e8-a447-7b76372b5189",
  "data": {
    "timestamp": 1702657521000
  }
}

注：当登录端时间戳无法校验通过时，请使用返回的服务器时间进行签名登录
参数说明：

节点	名称	类型	必填	说明
code	返回码	int	是	0--成功非0--失败
message	错误信息	string	否
requestId	请求ID	string	是	方便定位问题
data	业务返回数据	object	是
token	登录票据	string	否	登录成功时返回
expiresIn	有效期	string	否	登录成功时返回
timestamp	服务器时间戳	long	否	时间戳，单位毫秒，登录端时间无法使用时返回

3.1.2 登出接口

验证方式

签名验证，详情查看2章节

请求URL

http://ip:port/cgi-bin/v2/RationalDrugServer/HisToolLoginOut

请求示例

// 独立医院

{
  "header": {
    "hospitalId": "",
    "partnerId": "1",
    "requestId": "4535a480-fed6-11e8-a447-7b76372b5189"
  },
  "data": {
    "token": "tai.MTAwMDY%3D.12474ab0-912d-11eb-87e2-4914549178ec"
  }
}

// 平台板

{
  "header": {
    "platformId": "",
    "partnerId": "1",
    "requestId": "4535a480-fed6-11e8-a447-7b76372b5189"
  },
  "data": {
    "token": "tai.MTAwMDY%3D.12474ab0-912d-11eb-87e2-4914549178ec"
  }
}

参数说明：

节点	名称	类型	必填	说明
header	公共请求头信息	object	是
hospitalId	医院ID	string	否	属于header，单院版传这个
platformId	平台id	string	否	属于header，平台版传这个
partnerId	合作方ID	string	是	属于header
requestId	请求ID	string	否	属于header,方便定位问题
data	业务请求数据	object	是
token	校验信息	string	是	属于data

响应示例

{
  "code": 0,
  "message": "success",
  "requestId": "4535a480-fed6-11e8-a447-7b76372b5189",
  "data": {}
}

参数说明：

节点	名称	类型	必填	说明
code	返回码	int	是
message	错误信息	string	是
requestId	请求ID	string	是	方便定位问题
data	业务返回数据	object	是

简介

本页目录：

概述

术语表

使用限制

API 快速入门

接入须知

接口签名验证说明

3. 接口调用说明

登录/登出接口

登录接口

请求示例

响应示例

3.1.2 登出接口